Distribute Data to Twitter
Twitter requires that an authorization using OAuth be performed by a user with the appropriate permission level before any distributions can be made to Twitter.
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 Twitter and can be reused for multiple Twitter destination accounts. See "Managing OAuth Connections" for information on creating, viewing, and managing OAuth connections.
Caution
Data sellers that make distributions to Twitter on behalf of their end clients follow a different process. See "Data Sellers Distributing to Twitter" for more information.
This validation must be done when the destination account is activated, either by using an existing Twitter OAuth connection or by creating a new Twitter connection during the activation process. You can also create a Twitter 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 Twitter" below once the Twitter authorization dialog appears.
Distribute First-Party Data to Twitter
When distributing your first-party data to Twitter, only one integration option is available: "Twitter First-Party Data".
Configure the Required Properties
When activating the Twitter destination account, use the following guidelines to configure the required properties:
Account ID: The Twitter advertiser account id (NOT the Twitter handle) of the account where you'd like to send data. This ID is typically a lowercase alphanumeric string (e.g. 12a345bc) and can be found under 'Account settings' in the Twitter platform.
Ttl in Days: The number of days that users added to this audience will remain actionable on Twitter. After the number of days specified in this field have passed, the users will be removed from the Twitter audience. The default and maximum allowed limit is 395 days (13 months).
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 Twitter" below to enable and validate an OAuth connection for the Twitter destination account.
Distribute Data Marketplace Data to Twitter
When distributing Data Marketplace data to Twitter, only one integration option is available: "Twitter Data Marketplace".
Note
Distributing Data Marketplace data to this platform goes through LiveRamp’s Advertiser Direct program, which requires a separate agreement and follows a different process from Data Marketplace distribution to other platforms. For more information, see “Implementing LiveRamp's Advertiser Direct Solution”.
The Advertiser Direct program requires that data sellers share their custom segments with the data buyer within Connect. See “Implementing LiveRamp’s Advertiser Direct Solution” for more details.
All Twitter usage reporting is performed automatically. You do not need to perform any usage reporting actions.
Configure the Required Properties
When activating the Twitter Data Marketplace destination account, use the following guidelines to configure the required properties:
Account ID: The Twitter advertiser account id (NOT the Twitter handle) of the account where you'd like to send data. This ID is typically a lowercase alphanumeric string (e.g. 12a345bc) and can be found under 'Account settings' in the Twitter platform.
Data Usage Reporting Requirement (type I Agree): Enter "I Agree" 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" to acknowledge that you will report the impressions and amount spent associated with this campaign to LiveRamp on a monthly basis.
Payment Requirement (type I Agree): Enter "I Agree" to acknowledge that you will pay for the use of this data in accordance with the Consumer Social Amendment.
Reporting Contact Email: Provide an accurate email or emails (comma separated) for who will be sending usage reports for the Advertiser ID listed above.
Ttl in Days: The number of days that users added to this audience will remain actionable on Twitter. After the number of days specified in this field have passed, the users will be removed from the Twitter audience. The default and maximum allowed limit is 395 days (13 months).
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 Twitter" below to enable and validate an OAuth connection for the Twitter destination account.
Validate OAuth Connection During Destination Account Activation
While performing the steps in “Activate a New Destination Account” and before attempting to finalize the activation:
Note
The instructions below are valid for any OAuth destination platform. The screenshots show the process for LinkedIn as an example.
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 (LinkedIn example shown).
Note
If creating a new connection, follow the instructions to perform the authorization in the dialog that opens for that destination. See the appropriate section below for authorization information for specific platforms.
Enter the appropriate information in the other OAuth-related fields (LinkedIn example shown - required fields vary by destination).
Click .
Note
When activating a TikTok destination account, no button appears (unlike other OAuth platform’s destination accounts). Skip to the next step.
After the validation process is completed, a validated check mark appears:
Note
If a system error occurs, an error banner appears:
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:
Check that the ID is correct and try to validate again.
Complete any additional steps to activate the destination account.
Create a New OAuth Connection
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:
From the Connect navigation menu, click Company Settings to navigate to the Company Settings page.
Select the Connections tab.
Click .
From the Create New OAuth Connection dialog, select the desired destination from the dropdown menu.
If desired, edit the auto-generated connection name.
Note
You cannot use the same name for more than one connection to the same destination.
Click .
A new window opens with that destination's sign in or login screen.
Note
See the sections below for specific instructions for certain destinations.
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.
Perform OAuth Authorization for Twitter
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 sellers that make distributions to Twitter on behalf of their end clients follow a different process. See "Data Sellers Distributing to Twitter" for more information.
Steps to perform OAuth for Twitter:
After the Twitter authorization dialog appears, enter your Twitter credentials and then click Sign In.
You’ll briefly see a redirect dialog.
You’ll be directed back to the destination account screen and should see the blue success banner at the top of the screen.
Data Sellers Distributing to Twitter
Data sellers that make distributions to Twitter through either a first-party data or Data Marketplace destination account on behalf of their end clients have been authorized to use Twitter's Audience Manager solution for OAuth, which allows LiveRamp to perform OAuth authorization for you. 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."
See the "Setting up multi-user login in your ads account" section of Twitter's documentation.
After the advertiser has set this up, you can activate a Twitter destination account (either first-party data or Data Marketplace) but LiveRamp will need to perform the OAuth authorization. Create a support case to have LiveRamp perform the OAuth authorization.
Once LiveRamp has performed the OAuth authorization, you'll see the LiveRamp individual who performed the OAuth authorization listed as the OAuth connection owner. If the OAuth connection needs to be reauthenticated, create a support ticket (the reauthentication does not need to be performed by the LiveRamp individual who performed the original OAuth authorization).