Activate a Destination Account for OAuth Destinations

Some of our destinations (listed below) 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. 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 the destination.

This validation must be done when the destination account is activated by using an existing OAuth connection for that destination or by creating a new connection at the time of activation.

After activation, the connection being used can be changed by editing the destination account properties.

Caution

Turn off popup blockers! If you have any type of popup blocker enabled, disable it before attempting to perform the authorization.

Note

API user? For customers who use our Distribution API to activate a destination account that requires authorization using OAuth:

  • For users of v1.0 of the Distribution API, this change will not affect your current OAuth workflows.

  • For users of v2.0 of the Distribution API, you are already benefiting from this update, so no action is required.

Caution

Having distribution problems? Occasionally a previous OAuth authorization might become unauthorized (either due to actions on the destination platform end or due to someone inadvertently unauthorizing LiveRamp). Reauthenticate the connection to see if that solves the distribution issue (see "Managing OAuth Connections" for more information). See "Troubleshoot Distributions to Destination Accounts" if you continue to have distribution issues.

Currently, the following destinations require authorization using OAuth before any data can be distributed to the 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.

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.

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.

Permission level required: Super Admin or Standard User

Required destination account fields: Customer ID

Steps:

  1. Once the Microsoft login popup appears, enter your credentials and then click Next.

    Bing_OAuth-enter_credentials.png
  2. Complete the Multi-Factor Authentication process.

    Bing_OAuth-perform_MFA.png
  3. From the Authorize app popup, review the access granted and click Yes.

    Bing_OAuth-give_access.png

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

Permission level required: Admin or Audience level

Required destination account fields:

  • Advertiser ID: Your Pinterest-provided advertiser account ID. Should be numeric.

Steps:

  1. After the Pinterest login popup appears, enter your credentials and then click Log in.

    C-Authorize_DA_with_OAuth-Pinterest_login-screen.png
  2. From the Authorize app popup, click Give access.

    C-Authorize_DA_with_OAuth-Pinterest_app_popup.png

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

Snapchat account requirements: The account must be a Business Ad Account with Snapchat.

Permission level required: The Snapchat user must either be an Organizational Admin, or a user with Campaign Manager or Data Manager permissions.

Required destination account fields:

  • Client: The name of your company or account at Snapchat. Contact your Snapchat account representative if unsure of which value to use here. Do not include whitespace or other special characters (e.g., use "CompanyName" or "Account_Name").

  • Snapchat Ad Acct ID: The Ad Account ID issued to you by Snapchat. Contact your Snapchat representative for more information.

Steps:

  1. After the Snapchat login popup appears, enter your credentials and then click Log in.

    C-Authorize_DA_with_OAuth-Snapchat_login_screen.jpg
  2. From the popup that appears, click Continue to grant access.

    C-Authorize_DA_with_OAuth-Snapchat_confirmation_screen.jpg
  3. From the popup that appears, click Continue to return to the destination account screen, where you should see the blue success banner at the top of the screen.

If you receive an authorization error, confirm that the account is a Business Ad Account and that the user performing the authorization has the appropriate permission level.

More info on Snapchat User Roles and Permissions can be found here.

Caution

Data providers that make distributions to Twitter on behalf of their end clients follow a different process. See the Data Providers Distributing to Twitter" section below for more information.

Steps:

  • After the Twitter authorization popup appears, enter your Twitter credentials and then click Sign In.

    C-Authorize_DA_with_OAuth-Twitter_login-screen.jpg

You’ll briefly see a redirect popup.

C-Authorize_DA_with_OAuth-Twitter_redirect_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.

Data Providers Distributing to Twitter

Data providers that make distributions to Twitter on behalf of their end clients have been authorized to use Twitter's Audience Manager solution for OAuth. In these cases, the advertiser who owns the ads account that will be receiving the segment must add “@LiveRampDataSt1” as a user to their account with the permission level of "Partner Audience Manager."

C-Authorize_DA_with_OAuth-Twitter_edit_account_access_screen.jpg

See the "Setting up multi-user login in your ads account" section of Twitter's documentation.

After you notify your LiveRamp account team that has been set up, LiveRamp can perform the OAuth authorization for that destination account.