Skip to main content

Distribute Data To LinkedIn

See the instructions below for distributing first-party data or Data Marketplace data to LinkedIn.

LinkedIn requires that an authorization using OAuth be performed by a user with the appropriate permission level before any distributions can be made to LinkedIn.

Caution

LiveRamp's OAuth integration with LinkedIn was updated on October 3, 2022. If you are the creator of one or more LinkedIn OAuth connections used by your LinkedIn destination accounts, you might need to take action as a result of this update. See this announcement for more information.

Within Connect, OAuth authorizations are performed by utilizing an OAuth "connection" and validating it with your destination-specific information. A connection can be created by any user with the appropriate permission level at LinkedIn and can be reused for multiple LinkedIn destination accounts. See "Managing OAuth Connections" for information on creating, viewing, and managing OAuth connections.

This validation must be done when the destination account is activated, either by using an existing LinkedIn OAuth connection or by creating a new LinkedIn connection during the activation process. You can also create a LinkedIn OAuth connection outside of the destination account activation process. See the sections below for more information.

Whichever method you use, follow the instructions in "Perform OAuth Authorization for LinkedIn" below once the LinkedIn authorization popup appears.

Note

OAuth credentials at LinkedIn expire 1 year after authorization. After 1 year (or if you notice your distributions are not going through), perform OAuth authorization at LinkedIn again.

To distribute first-party data to LinkedIn, activate the appropriate “LinkedIn Onboarding” destination account tile for your country or region by following the instructions in "Activate a New Destination Account."

Note

The non-U.S. integrations are currently in a closed beta. If you’re interested in being considered to participate, contact your LiveRamp representative.

Configure the Required Properties

When activating the LinkdedIn Onboarding destination account, use the following guidelines to configure the required properties:

  • End Date: Not needed, leave open ended.

  • Account ID: The 9 digit LinkedIn account ID. This ID can be found in the URL when logging into Campaign Manager (after "/accounts/"). Contact your LinkedIn account representative if you’re unsure of which value to use here.

  • Destination Account Name: 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.

Enable and Validate an OAuth Connection

Follow the instructions in “Validate OAuth Connection During Destination Account Activation” and "Perform OAuth Authorization for LinkedIn" below to enable and validate an OAuth connection for the LinkedIn destination account.

To distribute Data Marketplace data to LinkedIn, activate the appropriate “LinkedIn Data Marketplace” destination account tile for your country or region by following the instructions in "Activate a New Destination Account."

Note

The non-U.S. integrations are currently in a closed beta. If you’re interested in being considered to participate, contact your LiveRamp representative.

Note

All advertisers (and agencies acting on behalf of advertisers) are required to report their usage of all LiveRamp Data Marketplace data distributed to LinkedIn on a monthly basis. See “Report Usage for Data Marketplace Distributions to Social Media Platforms” for instructions on how to pull reports.

Configure the Required Properties

When activating a LinkedIn Data Marketplace destination account, use the following guidelines to configure the required properties:

  • End Date: Not needed, leave open ended.

  • Account ID: The 9 digit LinkedIn account ID. This ID can be found in the URL when logging into Campaign Manager (after "/accounts/"). Contact your LinkedIn account representative if you’re unsure of which value to use here.

  • Destination Account Name: 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.

  • Data Usage Reporting Requirement (type I Agree): Enter “I Agree” in this field to acknowledge that you will report the impressions and amount spent associated with this campaign to LiveRamp on a monthly basis.

  • Payment Model (type I Agree): Enter “I Agree” in this field to acknowledge that the cost of all data used in this campaign will be calculated as a % of campaign spend, using the 'Amount Spent' column provided in monthly usage reporting.

  • Payment Requirement (type I Agree): Enter “I Agree” in this field to acknowledge that you will pay for the use of this data in accordance with the LinkedIn Data Agreement.

  • Reporting Contact Email: Provide an accurate email or emails (comma separated) for the users who will be sending usage reports for the Linkedin Account ID listed above.

Enable and Validate an OAuth Connection

Follow the instructions in “Validate OAuth Connection During Destination Account Activation” and "Perform OAuth Authorization for LinkedIn" below to enable and validate an OAuth connection for the LinkedIn destination account.

While performing the steps in “Activate a New Destination Account” and before attempting to finalize the activation:

  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

    Note

    If creating a new connection, follow the instructions to perform the authorization in the popup that opens for that destination. See the appropriate section below for authorization information for specific platforms.

  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

    After the validation process is completed, a validated check mark appears:

    C-Managing_OAuth_Connections-validate_checkmark.jpg

    Note

    If a system error occurs, an error banner appears:

    C-Managing_OAuth_Connections-validate_system_error_banner.jpg

    Try to validate again. If you continue to get this error, contact your LiveRamp representative.

    Note

    If the seat or account ID is incorrect, an error message appears:

    C-Managing_OAuth_Connections-validate_error_message.jpg

    Check that the ID is correct and try to validate again.

  4. Complete any additional steps to activate the destination account.

If you have the appropriate permissions at a destination that requires OAuth authorization, you can create a new OAuth connection to that destination. You can create the new connection when activating a new destination account for that destination or from the Connections tab of the My Company Settings page.

To create a new OAuth connection from the Connections tab:

  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 Connections tab.

    C-Managing_OAuth_Connections-Connections_tab.png
  3. Click + NEW CONNECTION.

    C-_Create_New__OAuth__Connection-New__Connection_button.png
  4. From the Create New OAuth Connection popup, select the desired destination from the dropdown menu.

    C-_Create_New__OAuth__Connection-New__Destination_dropdown.png
  5. If desired, edit the auto-generated connection name.

    Note

    You cannot use the same name for more than one connection to the same destination.

  6. Click CREATE CONNECTION.

    C-_Create_New__OAuth__Connection-Create__Connection_button.png

    A new window opens with that destination's sign in or login screen.

    Note

    See the sections below for specific instructions for certain destinations.

  7. Enter your credentials and follow the destination's process to give access.

After you complete the process, the new connection appears in your list of connections and a success banner appears.

Caution

LiveRamp's OAuth integration with LinkedIn was updated on October 3, 2022. If you are the creator of one or more LinkedIn OAuth connections used by your LinkedIn destination accounts, you might need to take action as a result of this update. See this announcement for more information.

Account type required: The LinkedIn account needs to be a campaign manager account and must correspond to the account ID entered on the destination account.

OAuth expiration: OAuth credentials at LinkedIn expire 1 year after authorization. After 1 year (or if you notice your distributions are not going through), perform OAuth authorization at LinkedIn again.

Required destination account fields:

  • Accountid: The 9 digit LinkedIn account ID. This ID can be found in the URL when logging into Campaign Manager (after "/accounts/"). Contact your LinkedIn account representative if unsure of which value to use here.

Steps:

  • Once the LinkedIn login popup appears, enter your credentials and then click Sign in.

    C-Authorize_DA_with_OAuth-LinkedIn-login-screen.jpg

You’ll be directed back to the destination account screen and should see the blue success banner at the top of the screen.

If you do not see your data segment(s) appear in LinkedIn:

  • Confirm you have authenticated with an Account Manager-level LinkedIn account

  • Confirm all parties are aligned on the data segment names and IDs

  • Confirm all parties are aligned on the type of segment (first-party vs. third-party) and that the segment has been pushed to the correct data endpoint

  • Confirm that the data partner pushed the segment