Skip to main content

Conversions API Destinations and Distribution Information

You can distribute CAPI event feed views to Conversions API program destination accounts to attribute transactions/events to online advertising on those platforms. See the sections below to learn which CAPI programs are available as destinations in Connect and the required credentials for each.

Available Destinations for Conversions API Programs

The following table lists all available CAPI destination accounts that can receive CAPI event feed views. In most cases, each CAPI program would have separate destinations for online and offline events. Make sure to find the correct destination by referring to the 'Integration Tile Name' column.

DA_Name_zoom.png

Note

For online event feeds, you only need to distribute feeds to destinations when you want to deliver brand- or SKU-specific views to platforms, such as in a retail use case. Without filtering applied (via view creation), online event data is sent directly to enabled platforms through the Online Conversions API integration in Console.

To learn more, see "Online Conversions API Connectors".

Platform

Event type

Integration Tile Name

Account Info Needed

Requires OAuth in Connect

Amazon

Offline

Amazon CAPI - Offline - NA - LR1

  • Amazon Ads account ID

Yes

Online

Amazon Online CAPI NA LR1

  • Amazon Ads account ID

  • Dataset name

No

Google Campaign Manager 360

Offline

Campaign Manager 360 Conversions API LR1 Product Array

No

Campaign Manager 360 Conversions API LR1 Product Array (Lmt Ad Trk)

No

Campaign Manager 360 Conversions API LR1 Non Product Array

No

The Trade Desk

Offline

TTD Conversions API 3rd Party Provider LR1 Product Array

  • TTD advertiser ID

  • TTD encryption key (also known as TTD secret key)

  • Provider ID

No

TTD Conversions API 3rd Party Provider LR1 Non Product Array

No

Online

TTD Conversions API - Online - Brand Direct LR1

  • TTD advertiser ID

  • Tracking tag ID

No

Meta

Offline

Meta Conversions API Offline LR1

  • Access token

No

Online

Meta Conversions API Online LR1

  • Access token

  • Meta ad account ID

No

TikTok

Offline

TikTok - Events API - Offline - LR1

  • TikTok ad account ID

No

Online

TikTok - Events API - Online - LR1

  • TikTok ad account ID

  • Authentication token

No

Pinterest

Offline

Pinterest - Conversions API - Offline LR1

  • Pinterest advertiser ID

No

Online

Pinterest - Conversions API - Online LR1

  • Pinterest advertiser ID

  • Authentication token

No

Snapchat

Offline

Snap - Conversions API - Offline LR1

  • Snap Pixel ID

No

Online

Snap - Conversions API - Online LR1

  • Snap Pixel ID

  • Authentication token

No

Yahoo

Offline

Yahoo - Conversions API - Offline LR1

  • Yahoo Pixel ID

No

Online

Yahoo - Conversions API - Online LR1

  • Yahoo Pixel ID

  • Authentication token

No

Activating a Conversion API Program Destination Account

To activate a Conversions API destination account, follow the general instructions in "Activate a New Destination Account”, performing these additional steps:

  1. Remove the end date to leave the end date open-ended.

  2. Under Destination-Specific Settings, enter the required account IDs.

    Note

    For retailers activating online CAPI destinations, enter the same platform credentials provided in Console for your Online CAPI integration. See "Create an Online Conversions API Integration" for more information.

  3. If your destination requires an OAuth authentication, select an existing one from the OAuth Connection dropdown list and click Validate OAuth Connection.

  4. To create a new OAuth connection and validate that connection:

    1. From the OAuth Connection dropdown list, select Create New OAuth Connection.

    2. From the new window that opens with the platform's sign-in or login screen, enter your credentials and then click Sign in.

  5. Click Validate OAuth Connection.

  6. In the Destination Account Name field, pick a unique and memorable name for this account. We'll suggest one for you but you can use any name you wish as long as it is less than 50 characters in length.

Once created, the destination account displays on the Destination Accounts page with the status 'Ready' and 'CAPI' as its supported data type.

CAPI_DAs.png

Distributing CAPI Event Feeds

You can distribute event feeds as tables or as views. When you distribute a table, LiveRamp automatically generates a view for that table to distribute.

Once you have created the desired CAPI destination account, you can start the distribution flow in several ways:

  • On the Tables and Views page, click the More Options (the three dots) menu of a CAPI event feed asset and select 'Distribute Event Feed Views'.

    CAPIRMN_MoreOptions__DistributeEvent.png

  • On the Tables and Views page, check the box of the CAPI event feed asset that appears to the left side of the row for the table, and click Distribute Event Feed Views.

    CAPIRMN_Checkboxes_dISTRIBUTE.png

  • Right after creating a CAPI event feed view, click Distribute Event Feed Views on the pop-up that displays.

  • On the asset’s details page, which can be accessed by double clicking on the asset’s row, click Action and select 'Distribute Event Feed Views'.

Procedure. To distribute event feed views:

  1. From the Select Event Feed Views step, select any additional view you want to distribute. Click Next.

  2. From the Select Destinations step, select one or more CAPI destination accounts you want to distribute the views to.

  3. Click Distribute Event Feed Views.

Once you've distributed your data, it typically takes 1-3 days for the data to arrive at the destination platform. Once delivered, your platform partner can then create an attribution report that can be viewed on their ad manager platforms or send the report to you directly.

Additional Information for Google Campaign Manager 360 CAPI Destination Account

Activating a Google Campaign Manager 360 CAPI destination account requires you to provide a new, or existing Floodlight activity ID. You must also provide LiveRamp’s access profile ID by granting LiveRamp users access in your Campaign Manager 360. 

See the sections below for complete instructions.

Create Floodlight Activities

To create a Floodlight activity in Campaign Manager 360:

  1. From the navigation menu, select All advertisers and click on the desired advertiser name.

  2. Create a new Floodlight activity group:

    1. From the navigation menu, select Floodlight and then select Activity groups.

      GCM_Conversions-Floodlight_Activities-Activity_Groups_menu_selection.png

    2. Click New.

    3. Fill out the required fields.

    4. Click Save.

  3. Create a new Floodlight activity:

    1. From the navigation menu, select Floodlight and then select Activities.

      GCM_Conversions-Floodlight_Activities-Activites_menu_selection.png

    2. Click New.

    3. Fill out the required fields and then click Save.

      GCM_Conversions-Floodlight_Activities-Activites_fields.png

      Note

      To match transactions to impressions or clicks, make sure the Counting method of your Floodlight activity is set to "Counter activities".

Follow the same process (apart from selecting the advertiser name) to create additional Floodlight activities.

Note

Typically, a maximum of five Floodlight activities can be used with the LiveRamp integration. Contact LiveRamp to create additional audiences if you use more than one Floodlight activity. Talk to your LiveRamp representative if more than five Floodlight activities are needed for your situation.

Grant LiveRamp User Access in Campaign Manager

This step will grant LiveRamp access to insert offline conversion data into your Campaign Manager 360 account. The permission given will only allow LiveRamp to insert offline conversions via the API.

Tip

Save the ID: Once you’ve created a new user profile for LiveRamp, record the LiveRamp Access Profile ID so you can send it to us in a later step.

To grant access in Campaign Manager 360:

  1. Create a new user role:

    1. From the navigation menu in Campaign Manager 360, select Admin and then select User roles.

      GCM_Conversions-Grant_Access_User_roles_menu_selection.png

    2. From the User Roles page, click New.

      GCM_Conversions-Grant_Access_User_roles_New_button.png

    3. In the “User role name” field, enter “Offline API Access”.

      GCM_Conversions-Grant_Access_User_roles_name.png

    4. In the “Source user role” field, select “Advertiser/Reporting Login”.

      GCM_Conversions-Grant_Access_Source_User_role.png

    5. In the Reporting section, uncheck all check boxes and check the check boxes for “Insert offline conversions” and "Update offline conversions".

      Google_DV360_UserRole_reporting.png

    6. Click Save.

      GCM_Conversions-Grant_Access_User_roles_Save_button.png

  2. Create a new user profile:

    1. From the navigation menu, select Admin and then select User profiles.

    2. From the User Profiles page, click New.

    3. Enter the following information:

      • Email: googleauth@liveramp.com

      • Profile name: LiveRampAPIAccess

        Note

        Google might add a number at the end of this name– this is okay.

      • User role: Offline API Access

    4. Click Save.

In this section: