Talon.One Campaign Audience Manager Connector Setup Guide | Server-Side Connectors

API Information

This connector uses the following vendor API:

API Name: Third-party API
API Version: v1
API Endpoint: https://integration.talon.one/cdp/
Documentation: Talon.One Third-party API: Customer Data Platforms

Connector Actions

Action Name	AudienceStream	EventStream
Update Customer Profile	✓	✗

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

API Key

Required. The API Key generated within the Campaign Manager software.

To generate an API key in the Campaign Manager:

Log in to the Campaign Manager and open the *Application of your choice, or create one.
Navigate to Settings > Developer settings.
Click Create API Key.
Enter a title for the key.
Under Do you want to use this API Key with a 3rd party service?, select Yes.
Select the platform to integrate with.
Set an expiration date for the key.
Click Create API Key.

Management API Key

Required. The Management API key gives you access to the endpoints selected by the admin who created the key.

To generate a Management API Key:

Log in to the Campaign Manager.
Navigate to Account > Management API keys.
Click Create Key.
Enter a name for the key.
Set an expiration date for the key.
Select the /v1/audiences (GET) and /v1/attributes (POST, GET) endpoints so the key will have access to them.
Click Create Key.

Base URL

Required. The Base URL of your Talon.One deployment. Do not include HTTP(S) protocol in the URL. For example: mycompany.europe-west1.talon.one.

Action Settings - Parameters and Options

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.

Action - Update Customer Profile

Parameters

Parameter	Description
Customer Profile ID	The integration ID of the customer profile. This is the unique identifier that is being applied to the visitor. It should be a visitor ID associated within Tealium. We recommend that you do not use an email address. If this field is not mapped, it will be auto-mapped to the Tealium Visitor ID.
Run Rule Engine	Indicates whether to run the Rule Engine. If `true`, the rules are run and their effects applied. Audience changes are applied. If `false`, the rules are not executed, the response time improves, and audience changes are not applied.
Customer Profile Attributes	Set attributes of your choice to the values of your choice. New attributes are created automatically. Custom and enabled build-in attributes are displayed. All other built-in attributes must be enabled first in the attribute library.
Audiences Add	The IDs of the audiences for the customer to join.
Audiences Remove	The audience IDs of the audiences for the customer to leave.
Template Variables	Provide template variables as data input for Templates. Use the dot notation for the names of nested template variables (for example, `items.name`). Nested template variables are typically built from data layer list attributes. For more information, see Template Variables Guide.
Templates	Provide templates to be referenced in Customer Parameters and Customer Profile Attributes sections. Templates are injected by name with double curly braces into supported fields. For example: `{{SomeTemplateName}}`. For more information, see Templates Guide.