X developer account
To start with this integration, you must sign up for a X developer account.
Campaign uses the 1.1 version of the X API. To use it, you need to apply for Elevated access via the Developer Portal. Learn more about X Elevated Access in this page.
Create an application on X
Once you have been approved with Elevated access, create a X application to enable Adobe Campaign to create posts on your X account. To do this, follow the steps below:
-
Log on to your X account.
-
Connect to X developer portal.
-
Select Create an App.
-
Let X assistant guide you through the process.
-
To allow Adobe Campaign to create posts on your account, edit to the App permissions from the User authentication set up section of your app. Select Read, Write, and Direct Messages.
-
In the Type of app section, select Web App, Automated App or Bot. You can leave the Callback URL field empty, and save your configuration.
-
Back to your app dashboard, select your app and browse to the Keys and tokens tab. Under Access Token and Secret, if the Read, Write, and Direct Messages permission is not mentioned, you must regenerate your app’s token and secret. Note that all the keys and tokens must be saved upon creation. You will need them to configure your Campaign Twitter service.
Create a Twitter service in Campaign
To link your Campaign instance with your X account, create a Twitter service and delegate write access to Campaign.
To enter settings, you must access both to your Adobe Campaign client console and an your X app permissions.
-
In Adobe Campaign, browse to the Profiles and targets tab, and select the Services and Subscriptions link
-
Create a new service.
-
Select the Twitter type.
-
Enter the label and internal name of the service.
CAUTION
The Internal name of the service must be the exact same name of your X account. -
By default, followers are saved in the Visitors folder. You can select another location from the Visitor folder field. Learn more
NOTE
The Synchronize subscriptions option is enabled by default: this option recovers automatically the list of your X followers so that you can send them direct messages. Synchronization is performed by a dedicated technical workflow. -
From your X app, copy the content of the API Key and [API Key Secret] fields and paste them into the Consumer key and Consumer secret fields of your Campaign Twitter service.
-
From your X app, copy the content of the Access Token and Access Token Secret fields and paste them into the Access token and Access token secret fields of your Campaign Twitter service.
-
In Campaign client console, click Save. You have now delegated write access to Adobe Campaign.
To check your settings, you can:
- Edit the Twitter service which you have just created.
- Browse the Twitter page tab: your Twitter account should be displayed.
Synchronize your X account
Synchronization between Campaign and X is managed through dedicated technical workflows. These workflows are stored in the Administration > Production > Technical workflows > Managing social networks folder.
They are stopped by default: you must start them manualy when you start using the Social Marketing module.
The Synchronization of Twitter accounts technical workflow synchronizes X accounts in Adobe Campaign. This workflow recovers the list of X followers so that you can send them direct messages. Learn more
By default, this workflow is triggered every Thursday at 7:30AM. You can use the Execute pending task(s) now option to start the workflow at any time as you are implementing this integration. You can also edit the scheduler to change the workflow triggering frequency. Learn more in this page.
The followers are stored in a specific table: the visitors table. To display the list of X followers, browse to the Profiles and Targets > Visitors.
For each follower, Adobe Campaign stores the following information:
- Origin: Twitter
- External ID: user identifier
- Username: account name of the user
- Full name: name of the user
- Number of friends: number of followers
- Checked: this field indicates whether the user has a verified Twitter account
Once this configuration is done, you can create posts on your X accounts and send direct messages to your followers. Learn more