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:

  1. Log on to your X account.

  2. Connect to X developer portal.

  3. Select Create an App.

  4. Let X assistant guide you through the process.

  5. 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.

  6. 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.

  7. 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.

NOTE
You need one application per X account. As a consequence, you must create another test application to send proofs to your test account.

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.

CAUTION
Create one Twitter service per X account. As a consequence, you must create another test service to send proofs to your test account.
Each Twitter service must also be created by Adobe on your mid-sourcing (MID) instance. Contact your Adobe representative to have your environment configured.

To enter settings, you must access both to your Adobe Campaign client console and an your X app permissions.

  1. In Adobe Campaign, browse to the Profiles and targets tab, and select the Services and Subscriptions link

  2. Create a new service.

  3. Select the Twitter type.

  4. 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.
  5. 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.
  6. 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.

  7. 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.

  8. 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.

CAUTION
To recover the list of X subscribers, the Twitter account synchronization option must be checked for the service linked to the account. Learn more

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