Skip to main content

Managing OAuth Connections

Some of our destinations use OAuth authorization for security. Before data can be distributed to an OAuth destination, a validation must be performed to confirm that the correct permission level exists for the user at that destination platform.

Because of this, you can only activate a destination account for an OAuth destination if you have the appropriate permission level to perform OAuth authorization at that destination.

Connect allows you to create a destination-specific authorization "connection" that you can reuse for multiple destination accounts.

Note

A connection can only be created by a user with the appropriate permission level at that destination.

If your login credentials at the platform change (such as your email address changes), you will need to reauthenticate your connection with your new credentials.

For security reasons, only the user who created the connection (the "connection owner") can reuse the connection.

The Connections tab of the My Company Settings page lets you view and manage your OAuth connections.

Currently, the following destinations require authorization using OAuth before any data can be distributed to the destination account:

  • LinkedIn (for information on distributing to LinkedIn, see "Distribute Data 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.

  • Microsoft (Bing)

  • Pinterest (for information on distributing to Pinterest, see "Distribute Data to Pinterest")

  • Snapchat (for information on distributing to Snapchat, see "Distribute Data to Snapchat")

  • Twitter (for information on distributing to Twitter, see "Distribute Data to Twitter")

The Connections table on the Connections tab of the My Company Settings page lists all of the OAuth connections for your account (in reverse-chronological order based on when they were created), along with basic information on each connection.

  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

    The table displays the following columns:

    C-_Managing__OAuth__Connections-_Connections__table.png
    • Connection Name: The name of the OAuth connection.

      Note

      If you are the connection owner, you can edit the connection name.

    • Destination: The destination that the OAuth connection is for.

    • Connection Owner: The email address of the person who created the connection.

    • Destination Accounts: The number of destination accounts that use the connection.

    • Date Created: The date the connection was created.

      Note

      If the connection is reauthenticated, this date will not change.

    You can sort the table by columns, and adjust the column display and the table density. See "Changing the Table Display" for more information.

  3. If you have a large number of connections, you can use the Search bar to filter based on connection name or the Destinations dropdown to filter based on destination.

    C-_Managing__OAuth__Connections-_search__and__filter__area.png
  4. To view more details about a particular connection (or to edit the connection name, if you're the connection owner), click the connection's row to open the details panel.

    C-_Managing__OAuth__Connections-connection_row.png
    C-_Managing__OAuth__Connections-details_panel.png
    • To edit the connection name, edit the Connection Name field in the Overview tab.

    • To view the list of destination accounts that use this connection, select the Destination Accounts tab.

      C-_Managing__OAuth__Connections-_destination__accounts__tab.png
    • To view or edit the settings for a particular destination account, click the "Settings" icon (the gear icon) that appears when you hover over that destination account and then click Go To Edit Account Page from the confirmation popup that appears.

      C-Managing_OAuth_Connections-settings_icon.jpg
      C-Managing_OAuth_Connections-edit_settings_confirmation.jpg

      Note

      To decrease the risk of delivery issues, making changes to destination account settings requires that the OAuth connection be re-validated. For security purposes, if you do not own the existing connection, you will have to enable a connection that you own (or create a new one) to edit the settings.

    • To add segments to distribution, or remove segments from distribution, for a particular destination account, click the "Add/Remove Segments" icon (the pie icon) that appears when you hover over that destination account and then click Go To Segments Distribution Page from the confirmation popup that appears.

      C-Managing_OAuth_Connections-add_or_remove_icon.jpg
      C-Managing_OAuth_Connections-add_segments_confirmation.jpg

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.

Permission level required: Super Admin or Standard User

OAuth expiration: None

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

OAuth expiration: None

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.

OAuth expiration: None

Required destination account fields:

  • Account ID: Alphanumeric string of characters that indicate the ads account ID that the segments will be sent to.

  • Ttl In Days: Number of days that users added to a segment will be active in the segment. The default value is 180 days. This can be changed after the DA is created.

Caution

Data providers that make distributions to Twitter on behalf of their end clients follow a different process. See "Data Providers Distributing to Twitter" 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.

If you no longer need a particular OAuth connection, you can delete it (as long as it is not being used by any destination accounts):

Note

Any user can delete an OAuth connection, not just the connection owner.

If the connection you want to delete is being used by one or more destination accounts, you must first edit each of those destination accounts to use a different OAuth connection. See "View OAuth Connections" above for information on how to view and edit the destination accounts that are used by a particular connection.

  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 the "more actions" icon that appears when you hover over the row of the audience you want to delete, and then select Delete.

    C-_Managing__OAuth__Connections-more_info_icon.png
    C-_Managing__OAuth__Connections-Delete_menu_selection.png
  4. From the Delete OAuth Account Connection popup, click DELETE CONNECTION.

    C-_Managing__OAuth__Connections-Delete_Connection_button.png

    Caution

    Review the deletion information carefully, as deletion cannot be undone.

From time to time, you might want to check that your credentials for an OAuth connection are still valid at the OAuth destination (such as before assigning the connection to a number of destination accounts). You can do this from the Connections tab by "reauthenticating" the connection.

If any of your login credentials change at an OAuth platform (such as your email address changes), you will also need to reauthenticate the connection.

To reauthenticate an OAuth connection:

  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 the "more actions" icon that appears when you hover over the row of the audience you want to delete, and then select Reauthenticate.

    C-_Managing__OAuth__Connections-more_info_icon.png
    C-_Managing__OAuth__Connections-Reauthenticate_menu_selection.png