X (Twitter)

Use GrowthLoop audiences for X Ads custom audiences.

Connect this destination to export audience membership as an X Ads custom audience, for use in X Ads campaigns.

This destination writes to your X (Twitter) account and is a good fit when you want to:

  • Make GrowthLoop audiences available for X Ads campaigns
  • Match contacts on email

This maps to GrowthLoop Audiences and Journeys:

Use it forAudiencesJourneys
Sending GrowthLoop audiences as X Ads custom audiences✓✓

In GrowthLoop, the destination is labeled X (Twitter).

Prerequisites

Make sure you have:

  • An X account that can access Ads Manager.
  • The Ad Account that should receive exported audiences.

Set up X (Twitter) as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the top right corner.
  3. Search for X (Twitter) and click Add X (Twitter).
  4. Log in with the X account that has access to the ad account you want to add.
  5. After you grant GrowthLoop access, enter the required information, then click Create.
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "X Ads".
Sync FrequencySet the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
Select Ad AccountAds account that should receive exported audiences. The list includes ad accounts your X login can access. Add another destination if you need a second ad account.
TokenAutomatically populated after you sign in.
Token SecretAutomatically populated after you sign in.

GrowthLoop validates the connection by listing ad accounts. X (Twitter) then appears in your list of connected destinations.

Export to X (Twitter)

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for X (Twitter). In a journey, add a Destination Node under Ads and select X (Twitter).

Journey Destination Node with export name, match fields, and personalization signals

Map contact identifiers

On an audience or in a journey Destination Node, map Email address. This field is required. Mapping additional identifiers can improve match rates.

Match fieldNotes
Email addressRequired. GrowthLoop hashes it as SHA-256
Mobile Device IDOptional. GrowthLoop hashes it as SHA-256
Twitter UsernamesOptional. GrowthLoop strips a leading @, lowercases the handle, then hashes it as SHA-256
Twitter User IDsOptional. GrowthLoop hashes it as SHA-256

This destination does not send additional personalization fields.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

SettingAudience exportJourney Destination Node
Export NameDefaults to {audience name}_GL_Audience_{audience ID}. That is the X Ads custom audience name unless you change it.Required. Enter a name so you can find the export in GrowthLoop and the audience in X Ads Manager.
Campaign typeChoose a one-time or ongoing export.The journey schedule controls when the journey runs and contacts are sent to X Ads.
Export Inclusion CriteriaAll audience members for a full refresh, or Newly added audience members for additions and removals since the last export.The journey sends contacts who reach this node.
ScheduleSet frequency, start date, end date, and days of the week for ongoing exports.Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesAn X Ads custom audience. Direction is GrowthLoop → X Ads.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node.
AudienceGrowthLoop creates a custom audience named after Export Name. Later runs reuse that audience.
Match fieldEmail address is required. Mobile Device ID, Twitter Usernames, and Twitter User IDs are optional. GrowthLoop hashes all of them as SHA-256.
AddGrowthLoop adds hashed identifiers to the audience.
RemoveGrowthLoop removes hashed identifiers from the audience.
One-time exportsGrowthLoop sends current membership once.
Ongoing adds and removalsOngoing exports add contacts who enter the audience and remove contacts who leave that custom audience.
DeletesGrowthLoop does not delete the X Ads custom audience.

Confirm the export was successful

When the run finishes, confirm you can use the data in X Ads.

  • Audience export: Sign in to X Ads Manager and look up Audiences. Look for the _GL_Audience_ name unless you changed Export Name.
  • Journey Destination Node: Open Audiences and look up the custom audience named after the export.

In GrowthLoop, review counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.

Congrats on successfully exporting to X (Twitter)!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateOAuth did not complete, or you signed in with an account that cannot access Ads ManagerSign in again with the X account that owns the ad account and grant GrowthLoop access
Rows fail to exportEmail address is unmapped or blankMap Email address to a populated email column
You cannot find the audienceYou are searching for the unsuffixed audience nameSearch Audiences for the _GL_Audience_ export name
Contacts who left the audience are still in X AdsThe export is one-time, or inclusion criteria did not include removalsUse an ongoing export and Newly added audience members or All audience members so removals run

What’s Next

Export an audience after you connect a destination

Did this page help you?