ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Loader Twitter Ads Audience

Twitter Ads Audience enables advertisers to target their ads to a specific audience based on various criteria, such as demographics, interests, and online behavior. It allows advertisers to create custom audiences by uploading and matching email addresses or mobile device IDs, enabling precise targeting of their campaigns. 

Business value in CDP

Utilizing Twitter Ads Audience as a loader to export data from a Customer Data Platform enhances advertising efficiency by seamlessly integrating valuable customer information into Twitter's advertising ecosystem. This integration facilitates a more personalized and effective advertising strategy, ultimately driving better engagement and results for advertisers on Twitter.


Steps to set up Twitter Ads Audience

Follow this step-by-step guide to configure the component:

  1. The first step is to set up the loader within Meiro Integration by following the instructions given in this article below.
  2. Set up the loader as a destination in CDP. Read here
  3. Continue with exporting your segmented customer profiles. Refer to this article.

Setting up the loader in MI

This component is used to import contacts to Twitter Ads Audiences. 

Learn more: about Twitter Ads API documentation here.

Data In/ Data Out

Data In

Loader requires imports.csv file in the directory /data/in/tables/imports.csv


File structure: 


/data/in/tables/imports.csv file must contain the following columns:


email(*)

  • Data type: Array[String]
  • The array of email addresses for the user. - lowercase, remove leading and trailing spaces; 
    • example: "support@twitter.com"

device_id (*)

  • Data type: Array[String]
  • IDFA/AdID/Android ID
  • IDFA - IDFA - 
    • lower-cased with dashes; ex: 4b61639e-47cc-4056-a16a-c8217e029462
  • AdID - 
    • original format on device is required, not capitalized with dashes; ex: 2f5f5391-3e45-4d02-b645-4575a08f86e
  • Android ID - 
    • original format on device is required, not capitalized without dashes or spaces; ex: af3802a465767e36

handle (*)

  • Data type - Array[String]
  • The @handle(s) (Twitter usernames) belonging to the user
    • no @, lowercased and leading and trailing spaces trimmed; ex: john

twitter_id

  • Data type - Array[String]
  • The Twitter IDs belonging to the user
    • String representation of integer; ex: "143567"

partner_user_id

  • Data type - Array[String]
  • The user's ID is in the partners' system.


Remember: (*) - At least one attribute - email, device_id, handle or twitter_id is required.

Remember: If any attribute is missing use empty array [] as a placeholder.

Remember: DO NOT hash data in imports.csv. The component takes care of hashing all required attributes.


Learn more:  about data structure in Twitter Ads documentation here and here.


 Example: 


email

device_id

handle

twitter_id

partner_user_id

["john@doe.com"]


["1234"]


["john"]


[]

[]

[]

[]

"marek"]


[“42”]

[]

["jane@doe.com"","jane@meiro.io"]


["9876"]


["jane"]


[]

["84"]


Plain CSV file: 

email,device_id,handle,twitter_id,partner_user_id
"[""john@doe.com""]","[""1234""]","[""john""]",[],[]
[],[],"[""marek""]","[""42""]",[]
"[""jane@doe.com"",""jane@meiro.io""]","[""9876""]","[""jane""]",[],"[""84""]"





Data Out  N/A

Learn more: about the folder structure here.

Parameters

Credentials

Screenshot 2022-03-17 at 6.59.07 PM.png

Consumer (API) Key (required) 


Consumer (API) key generated by Twitter in the registered application.


Consumer (API) Secret (required) 


Consumer (API) secret generated by Twitter in the registered application.


Access Token (required)


Access token generated by Twitter in the registered application.


Access Token Secret (required)


Access token secret generated by Twitter in the registered application.


Account ID 

The ID of the account where the audience will be imported.


Audience

Screenshot 2022-03-17 at 6.59.19 PM.png

Audience ID

The ID of the audience where the contacts from the imports.csv file will be imported.


Remember: the audience_id is in the URL.


image (2).png


image (3).png


Audience Name

The name of the newly created audience.

Warning: Using the same audience_name as an existing audience would cause the export to fail. Please keep this in mind when exporting to new audiences. If you wish to export to the same audience, remember to specify the audience_id.


Remember: At least one audience_id OR audience_name must be provided.

Example:
{
  "parameters": {
    "credentials": {
      "consumer_key": "consumer_key",
      "#consumer_secret": "###",
      "access_token": "access_token",
      "#access_token_secret": "###",
      "account_id": "qwerty12345"
    },
    "audience": {
      "audience_id": "foo42",
      "audience_name": "my_audience_audience"
    }
  }

Methods

  • When audience_id is provided in the configuration. The component will check audience_id existence and import all given contacts there.
  • When audience_id is unknown, audience_name must be provided in the configuration. The component will create a new audience with a defined audience_name and import all given contacts to the newly created audience.