Skip to main content

Implementing LiveRamp's Advertiser Direct Solution

LiveRamp's Advertiser Direct solution (FKA "Consumer Social") allows brands and agencies to use third-party data across a wide variety of verticals from the LiveRamp Data Marketplace for optimization on Facebook, Twitter, Pinterest, LinkedIn, and Snapchat.

Distributing Data Marketplace data to Advertiser Direct destination platforms requires a separate agreement with LiveRamp. If you're interested, contact your LiveRamp representative.

Note

If you do not have a LiveRamp representative, fill out our New Customer Form and someone from our team will contact you within 72 hours about either working with a certified Advertiser Direct reseller or implementing on your own.

Benefits include:

  • Seamless Distribution: Easily distribute your selected segments to all major social platforms.

  • Automatic Reporting: Free up your time with automatic reporting for Facebook and Twitter.

  • One Agreement Works For All Social Platforms: With a single contract you can seamlessly distribute segments to all major social platforms.

  • Straightforward Pricing: Percentage of media spend pricing applies to all social platforms.

Overall Steps to Implement Advertiser Direct

In most ways, the steps to request and distribute Data Marketplace segments to Advertiser Direct destinations are similar to those for distributions to other destinations. However, distributions to certain Advertiser Direct platforms require monthly usage reporting.

Note

If you're an agency and want separate billing invoices for each client, there are some additional steps to perform and some steps vary slightly. See the instructions below for more details.

After the necessary agreements are in place, perform the following steps:

  1. If you're an agency and want separate billing invoices for each client, create a client child account from within your parent account and then notify your LiveRamp account team.

    Note

    If you're not an agency that wants separate billing invoices for each client, skip to the step to activate Data Marketplace destination accounts.

  2. If you created a client account in the previous step, add users to the client account.

    Note

    To switch between your client accounts, click anywhere in the account switcher area and then use the account drop-down list to change from one account to another. If you have a large number of accounts, you can also use the search bar to locate the desired account.

    C-Global_Nav_Announcement-account_switcher.png
    C-Global_Nav_Announcement-selecting_account.png
  3. Activate any necessary Data Marketplace destination accounts for the Advertiser Direct destinations you want to distribute to.

    Note

    • Most Advertiser Direct destinations require that an authorization using OAuth be performed by a user with the appropriate permission level before any distributions can be made to that destination. If you're an agency, make sure that your client has given you the required permissions to perform OAuth. See "Activate a Destination Account for OAuth Destinations" for more information.

    • If the Data Marketplace destination integration tile for the desired destination is greyed out, either confirm with your Customer Success Manager that you have been enabled for Advertiser Direct or create a support case.

  4. For Data Marketplace distributions to Facebook, you will also need to add LiveRamp as a partner in Facebook with "View performance" access (if you're an agency, your client will need to perform these steps). This is a one-time step to enable automated usage reporting and needs to be done for each Facebook Ad Account.

    Caution

    When following the steps in "Adding LiveRamp as a Partner" below, disregard the information on distributing first-party data (you do not need to add LiveRamp as a partner with the ability to manage campaigns).

  5. To distribute syndicated segments, browse and request Data Marketplace segments from the Data Marketplace Segments page, using the Platform dropdown to filter for the destination platform you want to send the segments to.

    Tip

    If you aren't finding the segments that fit your needs, LiveRamp's Audience Solutions team can help match you with the data providers that are best suited to your goals, across diverse data sets like demo, location, behavior, and more. Click Ask the Data Marketplace in Connect to contact us or email the Audience Solutions team at DataMarketplace@liveramp.com to get started.

  6. To distribute custom segments from a specific data provider, use the Data Marketplace Allowlist / Sharing Request quick case to create a support case to request being added to the data provider's allowlist for custom segments. Include the data provider name and your account ID (the 6-digit number that appears after "customer_id=" in the Connect URL).

    If you're an agency, include the account ID for the client account (the 6-digit number that appears after "customer_id=" in the Connect URL for that account).

    Once you receive notification that the data provider has shared the custom segments to your account (via email and in Connect), the segments should appear in the destination accounts for the destinations they have been enabled for. See "Distribute Custom Segments to Data Buyers" for more information on custom segments.

    Tip

    Make sure that the data provider enables the specific social destination for the custom segment. Only custom segments that have been enabled for a particular destination will appear in the destination account for that destination.

  7. Distribute Data Marketplace segments to your desired destinations.

    You should see your segments in the destination platform within 2-3 days. To check on the delivery status, see “View Delivery Status”. If your segments are not showing up on the platform, see “Troubleshoot Distributions to Destination Accounts”.

  8. If you're distributing to LinkedIn, Pinterest, or Snapchat, report usage on a monthly basis (usage reporting for Twitter and Facebook is automated).

See the sections below for more information on performing these steps and see "Buy Segment Data from the Data Marketplace" for additional details on buying Data Marketplace segments.

Note

When creating support cases, make sure to create the cases at the parent account level, and reference the appropriate reseller client account.

Create a Client Child Account

If you're an agency and want separate billing invoices for each client, create a client child account from within your parent account and then notify your LiveRamp account team:

Note

  • Only users with “Admin” level permissions can add client child accounts: Contact your LiveRamp representative if you need your permission level changed.

  • For agencies whose advertisers will be distributing Data Marketplace data to Facebook: If you will be distributing all data to your own Facebook account, you will need your own LiveRamp agreement and Facebook audience sharing relationship with LiveRamp. Since you will be distributing data through your own account, you do not need to create a new client in Connect.

  1. From the Connect navigation menu, click Company Settings to navigate to the Company Settings page.

    C-My_Company_Settings_menu_selection.png
  2. Select the Clients tab. This displays a summary of your current clients and their data.

    C-Add_Reseller_Client_Client_tab.png

    Note

    If the Clients tab is not available, contact your LiveRamp representative.

  3. Click + CREATE NEW CLIENT.

    C-Add_Reseller_Client-Create_New_Client_button.png
  4. From the Create New Client window, enter the name for the new client in the "Client name" field in the following format: [Agency name] - [Customer name].

    C-Add_Reseller_Client-client_name_field.png
  5. To enable the new client to use Simple Onboard (where they upload PII-based files through Connect, where every record in each file is a member of a specific segment), slide the Use Simple Onboard toggle to the right (see "Enable Simple Onboard for Your Reseller Clients" for more information).

    C-Add_Reseller_Client-Siimple_Onboard_toggle.png
  6. To give a specific client user the ability to upload files via SFTP, enter that user's email address in the "Client email to send SFTP credentials to" field.

    C-Add_Reseller_Client-SFTP_field.png

    Caution

    If you've enabled Simple Onboard for this client in the previous step, do not enable SFTP access by entering an email address. All Simple Onboard files must be uploaded via Connect.

    Note

    Files 500MB and smaller can be uploaded via Connect but files larger than 500 MB need to be uploaded via the LiveRamp SFTP.

  7. Add a user to this client by entering a user email address and then selecting the appropriate access permission level for the user:

    C-Add_Reseller_Client-add_user.png
    • Select "Admin" for users who need to perform account management tasks, such as creating additional audiences, deleting audiences, and managing users.

    • Select "Standard" for users who do not need to perform account management tasks.

    For more information on the capabilities available for each access permission level, see "Access Levels and Restrictions for Connect Users".

    Note

    Creating reseller client audiences: An audience will need to be created for this reseller client account. You can do that, or you can give one of the reseller client users the ability to create audiences by giving them Admin-level permissions.

  8. Click + ADD USER to finish the process of adding the user.

    C-Add_Reseller_Client-add_user_button.png
  9. To add additional users, repeat the previous two steps.

    Note

    You don't need to add yourself as a user: You automatically have access to your client accounts, so you don’t have to add yourself as a user.

  10. Click CREATE CLIENT.

    C-Add_Reseller_Client-Create_Client_button.png

Add Users to Your Company Account

Multiple users can be enabled so that each user can log into Connect with their own unique credentials. These users can view and manage every audience in your Connect account.

To add a new user:

  1. From the Connect navigation menu, click Company Settings to navigate to the Company Settings page.

    C-My_Company_Settings_menu_selection.png
  2. If not already selected, select the Users tab.

    C-Add_Users_to_Your_Company_Account-Users_tab.png

    Caution

    Only admin-level users can add users. If you don't have admin-level permission, you will not see the "Users" tab on the Company Settings page. Contact your LiveRamp representative if you believe you should have admin-level permission. LiveRamp recommends that only one person per company should be responsible for managing users in Connect.

  3. Click the Global Action Button (the thunderbolt icon on the right side of the screen), and then select "+ New User."

    Add_User_Global_Action_button.png
  4. Enter the new user's email address and desired permission level, and then click Create.

    Add_User_popup.png

Note

Admin or standard permission level? LiveRamp recommends that each company have only one admin-level user. For a breakdown of the various capabilities each level has access to, see "Access Levels and Restrictions for Connect Users."

Caution

No aliases! Do not enter an email alias as the email address.

The user will receive an automated email to create credentials for LiveRamp Connect.

Caution

The link to create credentials for the new user will expire after 24 hours.

Activate a New Destination Account

Before you can distribute Data Marketplace segments to the desired Advertiser Direct destinations, you need to activate Data Marketplace destination accounts for those destinations.

Once you've activated the destination account, you can go to the Segment Distribution page for that destination account to distribute data to your seat at that destination.

Caution

To activate a destination account at a destination that requires OAuth authorization, you must have the appropriate permission level to create an OAuth connection for that destination. See "Managing OAuth Connections" for more information.

  1. From the Connect navigation menu, click New Destination Account.

    C-_Global__Nav__Announcement-New_Destination_Accounts__menu__selection.png
  2. Scroll through the available destinations (or use the search bar or the filter options) to locate your desired destination and then click Activate on the tile for that destination.

    C_Activate_New_Destination_Account-activate_button.jpg

    Note

    The Activate button appears when you hover over the tile.

    Destinations that are unavailable to you (often because they were not included in your contract) will be “grayed out” and can’t be activated. You can contact your LiveRamp Customer Success Manager if you wish to have one of those tiles enabled.

  3. From the Choose an Integration screen, click Activate on the Data Marketplace integration.

    Note

    If the Data Marketplace destination integration tile for the desired destination is greyed out, either confirm with your Customer Success Manager that you have been enabled for Advertiser Direct or create a support case.

  4. If desired, use one of the methods below to change the default end date:

    Active New DA End Date field.jpg
    • Click into the End Date field and select the desired end date from the drop-down calendar that appears.

    • Click the blue "X" in the End Date field to activate the destination account with no end date.

    Note

    By default, the end date is set to six months after the activation of the destination account, and the Account Status is set to “Active”.

  5. Confirm or change the identifier settings. If a destination supports multiple identifier types (for example, a mobile ad platform that supports both Android and iOS devices), you can choose which identifiers you'd like to send data to. The default identifiers for that destination will be used unless you change the selections.

    C-Activate_New_DA-identifier-settings.png

    Tip

    For those destinations that accept RampID as an identifier, we recommend that you keep RampID selected in order to maximize your reach and match rates.

  6. If necessary, view or edit the refresh options. The default refresh options that are suitable for the majority of the workflows for that destination are enabled (see “How LiveRamp Refreshes Distributed Data” for more information). To view or change the default refresh options for the selected identifier types, click the “Show Refresh Settings” link text.

    C_Activate_New_Destination_Account-show_advanced_refresh_settings_link-AoA.jpg

    To change the options (for admin-level users only), select or deselect the appropriate check boxes.

    C_Activate_New_Destination_Account-advanced_refresh_settings_checkboxes-ab0.jpg

    Caution

    The default options for each destination account should only be changed for custom or unique workflows, and only if you have a thorough knowledge of the impact of these settings. Changing the default options might result in your data not being refreshed appropriately.

  7. If the destination requires a valid OAuth connection:

    Tip

    See "Destinations That Require Authorization Using OAuth" for a list of OAuth destinations.

    1. Select one of your existing OAuth connections for that destination from the OAuth Connection drop-down list, or select + New OAuth Connection to create a new connection for that destination and follow the authorization process at the destination's website.

      C-Activate_New_Destination_Account-Select_OAuth_Connection.jpg
    2. Enter the appropriate information in the other OAuth-related fields (Snapchat example shown - required fields vary by destination).

      C-Activate_New_Destination_Account-OAuth_fields.jpg
    3. Click VALIDATE OAUTH CONNECTION.

      C-Activate_New_Destination_Account-Validate_OAuth_Connection_button.jpg

    Note

    See "Activate a Destination Account for OAuth Destinations" for a list of OAuth destinations and information on creating an OAuth connection for those destinations.

  8. Enter the remaining requested destination account settings, following the guidelines given next to that field in the UI. Many destinations will also require you to enter your Account ID with that platform.

  9. Enter a destination account name (this will appear as the name of the destination account in Connect).

    C_Activate_New_Destination_Account-enter_destination_account_name.jpg
  10. Once you fill out all the required fields (and after fixing any validation errors highlighted in red), click CREATE.

    Activate a DA Continue button.jpg

Adding LiveRamp as a Partner

To distribute first-party U.S. data using LiveRamp's Direct Integration with Facebook, you need to add LiveRamp as a partner with the ability to manage campaigns within your Facebook Ad Accounts. Once you've added LiveRamp as a partner, create a support case to complete the configuration (see "Using the LiveRamp Community Portal" for instructions).

To distribute Data Marketplace data to Facebook and utilize automated usage reporting, you need to add LiveRamp as a partner with "View performance" access within your Facebook Ad Accounts.

To add LiveRamp as a partner in Facebook:

Caution

These instructions were accurate at the time of publication but are subject to change depending on future updates to Facebook Business Manager.

  1. In Facebook Business Manager, click Business Settings.

    Facebook Adding LR as Partner Business Settings.jpg
  2. Click Partners.

    Facebook Adding LR as Partner Partners selection.jpg
  3. Click the Add drop-down menu and select "Give a partner access to your assets."

    Facebook Adding LR as Partner Add menu selection.jpg
  4. In the Add a New Partner popup, enter “705664196188477” (LiveRamp’s business ID) in the Partner Business ID field and then click Next.

    Facebook Adding LR as Partner Add a New Partner popup.jpg
  5. Under Asset Types, select “Ad Accounts” and then check the check box for the ad account(s) to which you want to add LiveRamp as a partner.

    Tip

    When adding LiveRamp as a partner, we suggest that you include all possible ad accounts that you’d like LiveRamp to deliver segments to, both now and in the future. If you do not include a particular ad account in the initial partner request and you later decide you want to deliver segments to that ad account, you will need to go back into Facebook Business Manager and go through the process again to include this new ad account in the partner relationship.

    FB Automated Reporting Step 4.jpg
  6. Slide the appropriate toggle and then click Save Changes:

    • If you only need to enable LiveRamp to automate your Data Marketplace reports and are not going to use LiveRamp’s Direct Integration with Facebook, slide the "View performance" toggle to the right (this toggle is automatically enabled if you enable the “Manage campaigns” toggle)

      FB_Automated_Reporting_Step_5b.png
    • If you're distributing data through LiveRamp's Direct Integration, slide the “Manage campaigns” toggle to the right to enable LiveRamp to create Custom Audiences

      FB Automated Reporting Step 5a-vFU.png
  7. When the confirmation message displays, click Done.

    FB_Automated_Reporting_confirmation.png
  8. To complete the process of automating your Data Marketplace reports, email dataopsteam@liveramp.com with the ad account information so the set up for auto reporting can be completed.

    Note

    If you only need to enable LiveRamp to automate your Data Marketplace reports, you do not need to complete any additional steps.

    If you're distributing data through LiveRamp's Direct Integration, complete the remaining steps.

  9. An admin of the Business Manager that owns the Ad Account you are going to deliver into must accept Facebook's terms of service by going to "https://business.facebook.com/ads/manage/customaudiences/tos/?act=[accountID]" (where "[accountID]" is your Ad Account ID). For example, if your Ad Account ID is "123456789", the URL would be "`https://business.facebook.com/ads/manage/customaudiences/tos/?act=123456789".

  10. If you're distributing data through the Facebook Direct integration, follow the steps in “Activate a New Destination Account” to activate a Facebook Direct Onboarding destination account.

  11. If you're distributing data through the Facebook Direct integration, create a support case to complete the configuration (see "Using the LiveRamp Community Portal" for instructions).

    Note

    You do not need to create a support case if you only need to enable LiveRamp to automate your Data Marketplace reports.

Steps to Buy Data Marketplace Segments

  1. From the Data Marketplace navigation menu, click Buy Data to navigate to the Data Marketplace Segments page, or click the Buy Data tile from the Welcome page.

    Buy Data menu selection.jpg
    C-Buy_Data_Welcome_page_tile.png
  2. Find the segments you want to buy:

    C-_Data__Marketplace__Segments__page.png
    • Use the Search bar and the filters on the top of the page to narrow the list of segments by searching on keywords, phrases, or segment IDs, or to filter the list by a number of attributes (including data provider, use cases, or countries (see "Use the Search Bar" and "Use Filters" below for more information.

    • View more info and stats on individual segments (such as description, data source, and permitted use cases) by clicking the row for a particular segment.

    • View a provider's profile in the LiveRamp Data Marketplace storefront.

    • Review the information in the available columns displayed in the table (for information on changing the way the table is displayed, see "Changing the Table Display").

      Tip

      If a segment name is truncated because of the column width, you can view the full name by hovering over that segment name. To more easily view the entire segment name, you can increase the width of the Segment Name column. Click and drag the small vertical line at the right edge of that column heading to increase the column width.

    See the sections below for more information.

    Note

    What's the price?

    • You are not charged to distribute Data Marketplace segments. You are only charged once you activate those segments at a destination platform.

    • The default currency is U.S. dollars (USD); if the price is given in a currency other than USD, an abbreviation for that currency will be listed, such as $1.25 CA$ for Canadian dollars.

    • CPM: The CPM for uses within our Programmatic Standard pricing model.

    • Programmatic % of Media: For uses subject to the Hybrid Pricing model (currently only distributions to The Trade Desk), the percentage of gross media spend you will be charged for the segment.

    • CPM Cap: For uses subject to the Hybrid Pricing model (currently only distributions to The Trade Desk), the CPM you will be charged for the segment if the percentage of gross media spend exceeds the CPM cap.

    • Advertiser Direct % of Media: For uses subject to the Advertiser Direct pricing model (distributions to social media platforms, such as Facebook, Twitter, Snapchat, LinkedIn, and Pinterest), the percentage of gross media spend you will be charged for the segment.

    • For more information on the pricing models, see "Data Marketplace Pricing Options".

  3. Select the segments to buy by checking the check boxes next to the segment names.

  4. Click REQUEST SEGMENTS.

    C-Buy_Segment_Data-Request_Segments_button.png

An order confirmation popup appears. Click SET UP DISTRIBUTION to go to the Destination Accounts page where you can distribute the segment data, or click CONTINUE BROWSING to stay on the Data Marketplace Segments page.

C-Buy_Segment_Data-set_up_distribution_popup.png

Your requested Data Marketplace segments appear on the Segment Distribution page for each of your activated Data Marketplace destination accounts. They also appear on each of your Audience Segments pages when you set the Data Types filter to "Data Marketplace".

Distribute Data

Once you've activated the appropriate destination accounts, follow the steps below to distribute data to those destinations:

Caution

Keep our recommended destination account limits in mind:

  • Maximum of 1,000 segments distributing in one destination account

  • Maximum of 500 segments added for distribution to a destination account per hour

  1. From the Connect navigation menu, click Destination Accounts to navigate to the Destination Accounts page and then click MANAGE on the desired destination account tile to navigate to the Segment Distribution page for that destination account.

    C-Global_Nav_Announcement-All_Destinations_menu_selection.png
    DA tile manage button.jpg

    Note

    By default, the list of destination accounts is initially filtered to show only active destination accounts. To access a destination account that is not active, adjust the filter setting.

    C-Changing_Active_Filter_on_DA_page.png
  2. From the Segment Distribution page for that account, select the segments to distribute to this destination by checking the check boxes to the left of the segment name.

    C_Onboarding-Distribute_Data_to_a_Destination_Account-field_checkboxes-9Vo.png

    Note

    For Data Marketplace destination accounts, this will be the Data Marketplace Segment Distribution page.

    Several options can be used:

    • Distribute segments or fields: You can select an entire field to distribute—for example, if you want to distribute the AGE field for all different available ages. You can also choose to distribute an individual segment (field/value pair), such as AGE:42 by clicking the caret to the left of the field name and then checking the check box for the desired value.

    • Filter by audience: You can use the Audience dropdown to filter the segment list by audience.

    • Filter with labels: You can use the Label drop-down list to filter the segments based on any labels that have been applied to them. Labels can be useful when you have a large number of segments that you want to distribute to multiple destinations.

    • Filter by inactive status: You can use the Active/Inactive dropdown to view only segments that are not currently being distributed to this destination account (“inactive” segments).

    • Distribute Data Marketplace segments: To distribute Data Marketplace segments that LiveRamp will track usage and bill for, either select "Data Marketplace" from the drop-down list or enter the Data Marketplace segment IDs in the search field.

      Tip

      You can select and distribute up to 145 specific Data Marketplace segments at one time by pasting a comma-delimited string of Data Marketplace segment IDs, enclosed by brackets (for example, "[id1,id2,id3,...]").

    Note

    To add segments that have been uploaded to a particular audience, and all the segments that will be uploaded later to that audience, create a case in the LiveRamp Community portal to make that request.

  3. Click Add to Distribution to start the distribution of your selected segments.

    C_Onboarding-Distribute_Data_to_a_Destination_Account-add_to_distribution_button-Ms4.jpg

You should see your data in the destination platform within 2-3 days. To check on the delivery status, see “View Delivery Status”. If your data are not showing up at the platform, see “Troubleshoot Distributions to Destination Accounts” or resend the active segments.

Note

It typically takes another 1-3 days after the data appears in the destination platform for stats to calculate and populate within Connect.

See “How LiveRamp Refreshes Distributed Data” for more information on how your distributed data can be refreshed.

If you want to be able to resend all active segments for a particular destination account on your own, LiveRamp can enable this ability for you. Create a support case in the LiveRamp Community portal to have this enabled. See "Resend Active Segments" for more information.

Report Usage for Data Marketplace Distributions to Social Media Platforms

LiveRamp's Advertiser Direct solution (fka Consumer Social) allows brands and agencies to use third-party audiences across a wide variety of verticals from the LiveRamp Data Marketplace for optimization on Facebook, Twitter, Pinterest, LinkedIn, and Snapchat.

All advertisers (and agencies acting on behalf of advertisers) are required to report their usage of all LiveRamp Data Marketplace data distributed to the Advertiser Direct social media platforms on a monthly basis.

Note

All Twitter usage reporting is performed automatically. You do not need to perform any usage reporting actions.

Note

Facebook Data Marketplace usage reporting should be set up to run automatically (except in cases where an exception has been made). To implement automated usage reporting for Facebook Data Marketplace data, you must add LiveRamp as a partner in your Facebook Ad Account with the “View Performance” role. Follow the steps in “Adding LiveRamp as a Partner in Facebook”. If you’re already distributing data to Facebook through LiveRamp's Direct Integration, LiveRamp already has the “View Performance” role within your Facebook Ad Account. You might only need to notify your LiveRamp representative that you want to enable automated usage reporting.

Overall Steps to Report Usage

  1. For those platforms where automated reporting is not used, follow the appropriate platform-specific instructions below to create a usage report.

  2. Follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

You will need to include a mapping between the segment info (segment name and ID) and the platform-specific campaign IDs and ad set IDs for each segment used (as described below). If there are multiple people on your team who distribute Data Marketplace segments to these platforms, make sure that you have a system to keep track of the segment name and ID for each segment used, and the campaign IDs and ad set IDs that Data Marketplace data has been used for.

Warning

Due date: The usage report for a given month’s usage is due by the 10th of the following month.

Platform-Specific Usage Reporting Instructions

Follow the steps in the appropriate section below to create a platform-specific usage report, and then follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

Facebook Data Marketplace usage reporting should be set up to run automatically, except in cases where an exception has been made.

Automated Usage Reporting for Facebook Distributions

To utilize automated usage reporting for Facebook Data Marketplace data, LiveRamp needs to be added as a partner in your Facebook Ad Account with the “View Performance” role. Follow the steps in “Adding LiveRamp as a Partner in Facebook”.

Tip

Distributing to Facebook through a Direct Integration? If you’re already distributing first-party data to Facebook through LiveRamp's Direct Integration, LiveRamp already has the “View Performance” role within your Facebook Ad Account. You might only need to notify your LiveRamp representative that you want to enable automated usage reporting.

Manual Usage Reporting for Facebook Distributions

If you've received an exception from LiveRamp to send manually-pulled Facebook reports, follow these steps.

Tip

Quicker the second time! Once you’ve created your first report, you can reuse that report for subsequent months by changing the data range.

  1. From a web browser, navigate to https://www.facebook.com/adsmanager/reporting and enter your login information.

  2. Click Create (either in the top-left corner or in the center of the screen).

    FB Usage Reporting create button-E-8.jpg
  3. Enter a name for your report, select all of the ad accounts that are receiving LiveRamp Data Marketplace segments through LiveRamp, and then click Create.

    FB Usage Reporting create report popup-be0.jpg

    Tip

    To make it easy to recognize the report for future use, we recommend naming it “LiveRamp Monthly Reporting”.

  4. From the Choose a Layout popup, select "Pivot Table" and then click Continue.

    C-Manual_Usage_Reporting_for_Facebook_Distributions-select_Pivot_Table_.png
  5. Under the Breakdowns tab on the left side of the page, make sure only “Campaign Name” and “Ad Set Name” are checked.

    FB Usage Reporting breakdowns tab-r2M.jpg
  6. Under the Metrics tab on the left side of the page, make sure that only the following columns are checked:

    • Account ID

    • Account Name

    • Reporting Starts

    • Reporting Ends

    • Schedule

    • Impressions

    • Amount Spent

    • Included Custom Audiences

    • Excluded Custom Audiences

    FB Usage Reporting metrics tab-dsI.jpg
  7. Drag the columns to arrange them columns into the order shown below (if necessary):

    • Campaign Name

    • Ad Set Name

    • Account ID

    • Account Name

    • Reporting Starts

    • Reporting Ends

    • Schedule

    • Impressions

    • Amount Spent

    • Included Custom Audiences

    • Excluded Custom Audiences

    C-Manual_Usage_Reporting_for_Facebook_Distributions-ordered_categories.png

    Tip

    You can remove any unneeded columns by clicking on the column and selecting "remove."

  8. For any campaigns with multiple targeting tactics, click the Campaign Name column and then select “Apply Filter”.

    FB Usage Reporting apply filter selection-z4s.jpg
  9. Click the appropriate radio button, enter the appropriate campaign names, and then click Apply to include or exclude the appropriate campaigns so that only Campaigns that used Data Marketplace Segments are included.

    FB Usage Reporting filter apply button-72k.jpg
  10. Use a similar method to make sure to exclude any Ad Sets that did not include Data Marketplace segments. This ensures that LiveRamp only invoices you for Ad Sets that used Data Marketplace segments.

  11. Click Save in the top-right corner.

    FB Usage Reporting save button-BLI.jpg
  12. From the list of reports, click the report name for the report you just created.

    FB Usage Reporting report link-7C4.jpg
  13. From the Reporting Date drop-down list, select the "Last month" preset, and then click Update.

    FB Usage Reporting setting dates-BaU.jpg
  14. Click the Export icon in the upper-right corner.

    FB Usage Reporting export button-BvE.jpg
  15. Check the radio button for “Export as .xlsx (raw data)” and then click Export.

    FB Usage Reporting export popup-yjw.jpg
  16. After the file has downloaded, modify the file name to ensure that all usage reporting is properly attributed (Facebook exports the file with a file name in the following format by default: “LiveRamp-Monthly-Reporting-[Month-Day-Year-Month-Day-Year]”:

    • For Advertisers: Change “LiveRamp-Monthly-Reporting” to “Facebook-[Country Code]-[Advertiser Name]” (for example, “[Country Code]-[Advertiser Name]-May-1-2018-May-31-2018”)

    • For Agencies reporting on behalf of an Advertiser: Change “LiveRamp-Monthly-Reporting” to “Facebook-[Country Code]-[Agency Name-Advertiser Name]” (for example, “[Country Code]-[Agency Name-Advertiser Name]-May-1-2018-May-31-2018”)

    Note

    Use the two-digit country code for your country or region (for example, "UK" for the United Kingdom or "US" for the United States).

  17. Follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

To report monthly usage for Pinterest Data Marketplace distributions:

  1. From a web browser, navigate to Pinterest and enter your login information.

  2. From the Ads Manager Welcome page, select the Ads tab and then select “Reporting”.

    1559315360600-zd4.png
  3. Click the date range button.

    1559315362990-lYc.png
  4. From calendar popup, select the first and last day of the previous month.

    1559315359849-SZc.png
  5. Select the Ad Groups tab.

    1559315359943-r98.png
  6. Check the check boxes for the Ad Groups that used LiveRamp-distributed audiences.

    1559315359775-q-8.png
  7. Click the pencil icon to open the Table quick edit popup.

    1559315359565-4yY.png
  8. Select the Details tab.

    1559315360044-ulQ.png
  9. Check the Parent details check box.

    1559315360118-fYI.png
  10. Select the Overall Performance tab.

    1559315360346-38g.png
  11. Make sure that only the Spend check box is checked.

    Tip

    Want to save this layout? Click Save for later if you want to save the custom table for later use or make it your default table.

    1559315360187--fw.png
  12. Select the Export tab and then select “Report: Current Table View”.

    1559315360282-f9k.png
  13. After the file has downloaded, modify the file name to ensure that all usage reporting is properly attributed (Pinterest exports the file with a file name in the following format by default: “metrics-[start date]_to_[end date].csv”):

    • For Advertisers: Change “metrics” to “Pinterest-[Country Code]-[Advertiser Name]” (for example, “Pinterest-[Country Code]-[Advertiser Name]-2019_04_01_to_2019_04_30.csv”)

    • For Agencies reporting on behalf of an Advertiser: Change “metrics” to “Pinterest-[Country Code]-[Agency Name-Advertiser Name]” (for example, “Pinterest-[Country Code]-[Agency Name-Advertiser Name]-2019_04_01_to_2019_04_30.csv”)

    Note

    Use the two-digit country code for your country or region (for example, "UK" for the United Kingdom or "US" for the United States).

  14. Follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

Twitter Data Marketplace usage reports are pulled automatically via API. You do not need to manually send monthly usage reports for distributions to Twitter. Email DataMarketplace@liveramp.com if you have any questions.

To report monthly usage for LinkedIn Data Marketplace distributions:

  1. From a web browser, navigate to LinkedIn and enter your login information.

  2. Navigate to Campaign Manager.

  3. Click into the appropriate ad account.

    1559316893744-73Y.png
  4. Check the check boxes for all Campaign Groups that are leveraging LiveRamp-distributed segments.

    1559316894618-qj8.png
  5. Click the Time range drop down, click Last month, and then click Update to select the previous month.

    1559316894133-Lpg.png
  6. Click Export.

    1559316894517-orE.png
  7. From the Report Type drop-down list, select "Campaign Performance."

    1559316894417-8Uc.png
  8. Under “Time breakdown”, select “All” and then click Export.

    1559316894001-ZrY.png
  9. After the file has been downloaded, modify the file name to ensure that all usage reporting is properly attributed (LinkedIn exports the file with a file name in the following format by default: “campaign_[campaign # placeholder]_campaign_performance_report.csv”):

    • For Advertisers: Change the file name to “LinkedIn-[Country Code]-[Advertiser Name]-[date range]” (for example, “LinkedIn-[Country Code]-[Advertiser Name]-04_01_2019_to_04_30_2019.csv”)

    • For Agencies reporting on behalf of an Advertiser: Change the file name to “LinkedIn-[Country Code]-[Agency Name-Advertiser Name]-[date range]” (for example, “LinkedIn-[Country Code]-[Agency Name-Advertiser Name]-04_01_2019_to_04_30_2019.csv”)

    Note

    Use the two-digit country code for your country or region (for example, "UK" for the United Kingdom or "US" for the United States).

  10. Follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

To report monthly usage for Snap Data Marketplace distributions:

  1. From a web browser, navigate to Snap and enter your login information.

  2. Select the Ad Sets tab.

    1559317267699-3VU.png
  3. Click the calendar drop down, click Custom, and then select the prior month.

    1559317162454-2zg.png
  4. Check the check boxes for all Ad Sets that are leveraging LiveRamp-distributed segments.

    1559317162645-JS0.png
  5. Click the three vertical lines on the right side to open the Customize Columns popup window.

    1559317162933-X1Y.png
  6. In the Details section, check the check boxes for "ID”, “End”, and “Start”.

    1559317163434-_E0.png
  7. Scroll down to the Delivery category and check the check box for “Paid Impressions."

    1559317163113-hNY.png
  8. Scroll down to the Spend category and check the check box for “Spend”.

    1559317165451-SNE.png
  9. Reorder the columns as shown below.

    1559317165311-jWc.png
  10. Click Save.

    1559317165548-rQQ.png
  11. Click the download button to open the Export Configuration popup window.

    1559317165641-W9I.png
  12. Under “INTERVAL BREAKDOWN”, select “Breakdown by month” and then click Export.

    1559317165826-LjU.png
  13. Follow the instructions in the "Send the Usage Reporting File to LiveRamp" section of this article to send the usage report to LiveRamp.

Send the Usage Reporting File to LiveRamp

Once you've downloaded and renamed the usage reporting file:

  1. Provide a mapping between the campaign ID(s), the ad set ID(s), and the segment name and segment ID for each segment used:

    Caution

    LiveRamp must have the segment names and segment IDs to create the invoice.

    1. Open the file that you just downloaded.

    2. Insert two additional columns to the right of the existing columns and enter the column headings listed below:

      • LiveRamp Segment Names

      • LiveRamp Segment IDs

    3. Following the example format shown below, provide pipe-delimited segment name(s) and pipe-delimited segment ID(s) (e.g, “10011111 | 10013393”) for each segment used.

      Usage Reporting extra columns.jpg

    Tip

    You can find the segment names and segment IDs for syndicated segments on the Data Marketplace Segments page. See "View More Info and Stats for Data Marketplace Segments" for more information on downloading segment names and segment IDs.

    To find segment names and segment IDs for custom segments, create a support case (see "Using the LiveRamp Community Portal" for instructions).

  2. Email the file to LiveRamp using one of the methods listed below:

Include any additional invoicing requirements, such as amounts by campaign or insertion order, within the email.

After the usage is reported, LiveRamp creates an invoice based on the media spend reported and sends it to the designated billing contact(s) provided. If you need to update the billing contact, contact datausage@liveramp.com or your LiveRamp account representative.

Note

For questions on monthly reporting or billing, email datausage@liveramp.com.