Skip to main content

Create a Destination Connection

You can create destination connections during the process of creating a data delivery group or outside of that process. The steps are essentially the same, no matter which method you choose.

To create a destination connection:

  1. Start the process by opening the Destination Connection Builder in one of the following ways:

    • From the Quick Actions drop-down list in the navigation pane, click Add Destination Connection.

      LR1-Add_Destination_Connection_menu_selection.png
    • During the process of creating a data delivery group and selecting the integrations to send your data to, click Create Destination Connection.

      LR1-Activation_Bundles-New_Integration_Connection_button.png

      A new browser tab opens and displays the Destination Connection Builder.

  2. Select the desired integration (such as “Facebook (US)”) and then click Next.

    LR1-Integration_Connections-select_Integration.png

    Note

    The integration list table and the side panel display the data type (for example, first-party data) and identifier types that can be sent through the integration, as well as whether that destination supports Record Sync (which sends record deletions to the destination platform). For more information on Record Sync, see "Keep Destination Data Fresh with Record Sync".

  3. Configure the properties required for the integration, such as your account ID (LinkedIn example shown - other integrations might require different properties).

    LR1-Integration_Connections-configure_properties.png

    Note

    Helper text appears on the right side of the screen with information on filling out these fields.

  4. Enter a name for the destination connection.

  5. If OAuth authorization is required for the destination, click Create New OAuth Connection and then follow the authorization process at the destination's website (for platform-specific instructions, see the sections below) (Pinterest example shown):

    DCP-Create_Destination_Connection_Create_New_OAuth_Connection_button.png

    Note

    A success message appears when a new OAuth connection is successfully created. If you have trouble creating the new OAuth connection, check the OAuth instructions for the destination to make sure you have the appropriate permission level to perform authorization.

  6. Click Submit.

If you were in the process of creating an data delivery group, you can return to that tab and continue the destination connection selection process.

If you created the destination connection from the Destination Connections page, you will be returned to that page and the new connection appears in your list of connections.

Perform OAuth Authorization for LinkedIn

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 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 to perform OAuth for LinkedIn:

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

    C-Authorize_DA_with_OAuth-LinkedIn-login-screen.jpg

Perform OAuth Authorization for Pinterest

Permission level required: Admin or Audience level

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

Required fields:

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

Steps to perform OAuth for Pinterest:

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

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

    C-Authorize_DA_with_OAuth-Pinterest_app_popup.png

Perform OAuth Authorization for Snapchat

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 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 to perform OAuth for Snapchat:

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

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

    C-Authorize_DA_with_OAuth-Snapchat_confirmation_screen.jpg
  3. From the dialog 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.

Perform OAuth Authorization for TikTok

Permission level required: The TikTok account needs to have either the "Ad Account Operator" or "Ad Account Admin" permission level.

Steps to perform OAuth for TikTok

  1. After the TikTok for Business login dialog appears, enter your credentials and then click Log in.

    C-Perform_OAuth_TikTok-login.png
  2. From the dialog that appears, click Confirm.

    C-Perform_OAuth_TikTok-confirm_button.png

    Note

    Do not uncheck any of the check boxes.

Perform OAuth Authorization for Twitter

OAuth expiration: None

Required 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.

Steps to perform OAuth for Twitter:

  • After the Twitter authorization dialog 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 dialog.

C-Authorize_DA_with_OAuth-Twitter_redirect_screen.jpg