Adobe Campaign v8 Connector Setup Guide
This article describes how to set up the Adobe Campaign v8 connector.
Configuration
To configure the Adobe Campaign v8 connector in Tealium, you first need to generate the OAuth server-to-server credentials for the connection in Adobe. For more information, see Adobe: Add API to project using OAuth Server-to-Server credential.
Complete the following steps to generate Adobe credentials and configure the connector:
- Create a new Adobe Developer Console project or use an existing project. For more information, see Adobe: Projects Overview.
- Add the Adobe services to the project that you want associated with the project credentials. For more information, see Adobe: Services Overview. This connector requires the following services:
- Adobe Campaign API
- I/O Management API
- Select the Adobe Campaign API product profiles you want to manage with these credentials.
- After you add the services to the project, you can access the project credentials. For more information, see Adobe: Credentials.
Go to your project overview and select OAuth Server-to-Server in the Credentials section. The following credentials are required for this connector:- Client ID (API Key)
- Client secret
- Technical Account Email
- Note your credentials and return to Tealium to complete the connector configuration.
- In Tealium, go to the Connector Marketplace and add a new Adobe Campaign v8 connector. For general instructions on how to add a connector, see About Connectors.
- After adding the connector, configure the following settings:
- Client ID
- Required: The Client ID (API Key).
- Client Secret
- Required: The Client Secret.
- Server Host
- Required: Provide server host.
For example, the host isexample.campaign.adobe.com
for the API URLhttps://example.campaign.adobe.com/nl/jsp/soaprouter.jsp
.
- Required: Provide server host.
- Client ID
- In Adobe, go to the Developers section in the Adobe Admin console. For more information, see Adobe: Manage developers.
- Add a new developer with the Technical Account Email from the Adobe project credentials.
- Grant access to Adobe Campaign v8 for the developer you just added.
- From the Adobe Admin console, add a user.
- Add the email of the developer you just added.
- Add the Adobe Campaign Managed Cloud service and include your selected product profiles while creating the credentials. For more information, see Adobe: Manage user permissions.
- Update the newly created technical operator in the Adobe Campaign client console. For more information, see Adobe: Update the technical account operator within the Campaign client console.
Migration
Migrate existing Adobe Campaign Classic connectors to Adobe Campaign V8 connectors using the Adobe Campaign Classic to v8 Migrator tool.
Complete the following steps to migrate your Adobe Analytics tag using Tealium Tools:
- Add the Adobe Campaign Classic to v8 Migrator to your Tealium Tools using the JSON definition at the following URL:
https://solutions.tealium.net/hosted/tealiumTools/acc_to_v8/acc_to_v8.json
. For more information about adding custom tools, see Manage Custom Tools. - Go to either Event Connectors or Audience Connectors and launch the Adobe Campaign Classic to v8 Migrator tool from Tealium Tools.
- Select how actions should be migrated. To disable your existing Adobe Campaign Classic actions as part of the migration, select Disable existing action. To migrate only active actions, select Migrate only active actions.
- Select the scope for the migration from the drop-down list:
- All Adobe Campaign Classic actions
- Specific Adobe Campaign Classic action
- Specific Adobe Campaign Classic connector
- Enter the Adobe Campaign Client ID and Client secret for the project. The server host is automatically extracted from the existing Adobe Campaign Classic configuration.
- Click Start.
The Migrator tool automatically migrates existing Adobe Campaign Classic connectors to new Adobe Campaign v8 connectors. The name of the connector will be the same, with the suffixV8 (Migrated)
. - Verify the new connector configurations and actions.
- Save and publish your profile.
IP addresses to allow
You will need to add the Tealium IP addresses to your Adobe Campaign allow list (Adobe Experience Platform > Control Panel > Instances).
For more information, see Adobe Campaign: Allowlist IP addresses.
Actions
Action Name | AudienceStream | EventStream |
---|---|---|
Send Custom SOAP Request (Batched) | ✓ | ✓ |
Send Custom SOAP Request | ✓ | ✓ |
Enter a name for the action and select the action type from the drop-down menu.
The following section describes how to set up parameters and options for each action.
Send Custom SOAP Request (Batched)
Batch Limits
This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met:
- Max number of requests: 200
- Max time since oldest request: 10 minutes
- Max size of requests: 1 MB
Parameters
Parameter | Description |
---|---|
SOAP Action Header Value | SOAP Action, for example: nms:rtEvent#PushEvent .This value will be assigned to SOAPAction HTTP header. |
SOAP Request Body Prefix | Provide a template of the opening portion of SOAP Request, for example: <?xml version=" 1.0" encoding="utf- 8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent"><soapenv:Header/><soapenv:Body><urn:PushEvent><urn:domEvent> .You can use template variables in the SOAP Request Body Prefix (For more information, see Templates Guide). |
SOAP Request Body Data | Provide a template for the SOAP Request batch item to be sent.You can use template variables in the SOAP Request Body Data. |
SOAP Request Body Suffix | Provide a template for the closing portion of SOAP Request, for example: </urn:domEvent></urn:PushEvent></soapenv:Body></soapenv:Envelope> .You can use template variables in the SOAP Request Body Suffix. |
SOAP Request Body Joiner | A character or string to use between body items when batching. If not specified, an empty string is used. |
SOAP Request Template Variables | Provide template variables as data input for SOAP Request Body Prefix , SOAP Request Body Data and SOAP Request Body Suffix (For more information, see Template Variables Guide).Name nested template variables with the dot notation. For example, items.name . Nested template variables are typically built from data layer list attributes. |
SOAP Response Error Identifier | If the response contains an error string, it is marked as a failure. By default, an HTTP response status outside 200 -299 range is also marked as a failure. |
Send Custom SOAP Request
Parameters
Parameter | Description |
---|---|
SOAP Action Header Value | SOAP Action, for example: nms:rtEvent#PushEvent .This value will be assigned to SOAPAction HTTP header. |
SOAP Request Body Template | Provide SOAP Request Body Template to be sent. For more information, see Templates Guide. Templates are injected by name with double curly braces into supported fields, for example {{SomeTemplateName}}. |
SOAP Request Body Template Variables | Provide template variables as data input for SOAP Request Body Template . For more information, see Template Variables Guide. Name nested template variables with the dot notation, for example items.name . Nested template variables are typically built from data layer list attributes. |
SOAP Response Error Identifier | If the response contains an error string, it is marked as a failure. By default, an HTTP response status outside 200 -299 range is also marked as a failure. |
This page was last updated: September 3, 2024