X/Twitter Ads Destination
Step 1: Authorise the InfoSum platform to send data to X
Step 2: Configure the X Ads Destination in the Platform
X/Twitter pre-requisites:
Before setting up your X Ads destination, ensure you have the following:
- X Ads Account: You need access to a X Ads account. You can create one at X Business
- The minimum number of matched users for an audience to populate on X is over 500. Please ensure that your activation segment contains a larger number of users as they’ll need to match with over 500 X users for the audience to show.
Activation Keys
The connector supports the following Keys, please consult this X support article to understand the format that your data is expected to have. Please also ensure that you set one of the below identifiers as your activation key when setting up your activation query:
- email: Email addresses (raw or hashed SHA-256)
- phone_number: Phone numbers (raw or hashed SHA-256)
- device_id: Mobile Advertising IDs (IDFA/AdID/Android ID) (raw or hashed SHA-256)
- twitter_id: Twitter user IDs (raw - must remove @)
- partner_user_id: Partner's system user ID (raw)
Step 1: Authorise the InfoSum platform to send data to X
You need to do this only once when creating an X destination in the InfoSum platform for the first time.
- Go to Activate>Destinations>click Authorizations on the top right corner
- Authorisations page will open. Select X from the list of Providers given. Click Authorise
3. A pop up box will appear as the App Authorisation page for X. Click Authorize app
-
You will be returned to the Authorisations page and the status against X will now show as Authenticated
Step 2: Configure the X Ads Destination in the Platform
You can now create the X destination and configure the setup.
- Go to Activate>Activations
- On the Activations page, select X and scroll down to Export Configurations. Click Create New Destination
The form contains the following fields:
- Account ID: The ID of the X Ads account that you have authorized. You can find it under the account settings in the X Ads dashboard and in the URL of your ad Account
- Audience Name: Provide a name for the audience you wish to export to X Ads.
-
Operation Type: Choose the operation (UPDATE, DELETE) to determine whether to update an existing audience/create a new audience if no audience with that name exists, or delete users.
- Audience Description (optional): A brief description of the audience, if required.
-
Effective At/Expires At(optional): Define the time range for when the audience data is valid on Twitter.
- Effective At: If not provided, the audience association will take effect immediately, meaning that Twitter will apply the audience data as soon as it is processed.
- Expires At: If not specified, the default expiration time is typically set to 13 months from the request timestamp.
Complete all the mandatory fields and click submit. As the destination is reusable all fields can be specified as editable/non editable at point of export to allow you to customize all specific exports.
Please note that any fields that you make editable at push time will be editable by companies that you share the destination with.
Once completed, this destination can be used in the export configuration.
Activating data to X/Twitter
You can activate results to a Destination using either Segment Builder or the Query Tool.
- Navigate to Activations & select your activation
Once you’ve created the activation query, go to the Activation tab under Activate, where you will see each of the activation queries that have been run in your account. Your latest one will be at the top, but you can search by Activation name or use filters to manage this list.
You will see a modal providing more details on the Activation you have selected, such as the query used and the name of the output column. There are three menu tabs within this box - Details, Stats, and Export History. Once you've pushed the results, the details and status will be viewable under the Export History tab.
- Select your destination
Click on the Export blue button to configure your export. This will open a pop up asking you to select which Destination it should be sent to. You will be able to see all the Destinations that your company owns or has permission to use.
- Configure the export
When you select the correct Destination, the pop up will show additional options, including column mapping if required and optional fields.
- Click Export to Destination to initiate the activation.
Processing time: it typically takes 24-48 hours for X to fully process and activate a custom audience