Add a connector

Adding a connector involves the following steps:

• Add a connector
• Select a source
• Add a connector action
• Map data

Add a connector

New connectors are deactivated by default. For information about activating a connector, see Activate or deactivate a connector.

To add an EventStream or AudienceStream connector, use the following steps:

1. Go to Server-Side > Connectors > Marketplace.
   You can also go to Server-Side > Connectors > Overview, and click + New Connector.
   The list of connectors is sorted alphabetically by default.
2. Filter the list of connectors as needed in the following ways:
   • Click the Data Type filter, then select Event or Visitor.
   • Click the Device Type filter, then select Mobile Device, Web Browser, IoT/Connected Devices, or Custom Devices.
   • Click the Sort By filter, then select A-Z or Z-A.
   • Enter a partial or full connector name in the Search box.
3. Select a connector, then click New Connector.
   The Connector Summary, which includes links to vendor documentation and configuration instructions, is displayed.
4. Click New Connector.
5. Enter a Name for the connector.
6. If required, select I Accept for the EULA Agreement.
7. For Authentication, enter your login credentials, token or password, Account ID, and any other information required for establishing a connection with the vendor service.
8. To configure an action for the connector, click Done & New Action.
   To configure an action later, click Done.

Select a source

The source for a connector is either an event feed or an audience, depending on the type of connector.

Add a source for an event connector

1. For Data Type, select Event Data.
2. Select a Data Source.
3. Select an Event Feed.
4. Click Next.
   The New Action screen is displayed.

Add a source for an audience connector

1. For Data Type, select Visitor Data.
2. Select an Audience.
3. For Trigger, select one of the following:
   • Joined Audience - Trigger the action if a visitor joined the audience during this visit. For example, when a Cart Abandoner or Frequent Shopper joins an audience.
   • Left Audience - Trigger the action if a visitor left the audience during this visit.
   • In Audience at start of visit - Trigger the action at the beginning of the visit if the visitor is already in the audience.
   • In Audience at end of visit - Trigger the action if the visitor is in the audience at the end of the visit.
4. To limit how often this action triggers, toggle Frequency Cap to On, then select an Action Priority and an Action Cooldown Group.
   For more information, see Action Frequency Capping and Prioritization.
5. Click Next.
   The New Action screen is displayed.

Add a connector action

1. In the New Action screen, enter the Action Name.
2. Select an Action Type.
   The list of action types varies depending on the connector. Big Data connectors, such as AWS Kinesis or Google Pub/Sub, typically have a Send Visitor Data action.
3. Complete any required fields for the action, using pre-populated drop-down lists where available. If any required fields are missing data, an error message is displayed in red text.
   

   

   
   When a value is selected or entered for all required fields, COMPLETED is shown.
4. Click Save.
   The Action Details screen is displayed.

Newly added actions are deactivated by default.

If you use a Send Visitor Data action with the Include Current Visit Data option selected, the events array in the visitor data only includes event attributes that are also defined in AudienceStream (as an attribute or an enrichment). It is a best practice to only select the Include Current Visit Data option when the connector needs the visit data. For more information, see the AudienceStore Data Guide.

Data Mappings

The Mappings tab displays the required parameters followed by the available mapping categories (Event Data, User Data, and so on).

Use the following steps to map Tealium attributes to vendor parameters:

1. For each required parameter, enter a value or map an attribute to the parameter, as needed.
   The list of attributes is populated based on the Source you selected. For example, choosing an audience displays all visit and visitor-scoped attributes but does not display event attributes.
2. Expand each category to see the available mappings.
3. Map attributes to vendor parameters as needed.
4. To map additional attributes, click + Add Mapping.
5. Click Back to modify, or click Finish.
6. To activate the new action, click
7. Save and Publish.

New connectors are not activated automatically. For information about activating a connector, see Activate or deactivate a connector.

Test your connector

After you have added and configured a connector, you need to test it. The easiest way to test your connector is by using the Trace Tool, as follows:

1. Start a new trace.
2. Examine the real-time log.
3. Check for the action you want to validate by clicking the Actions Triggered entry to expand.
4. Find the action you want to validate and view the log status.

EventStream and AudienceStream pass only valid Trace IDs. Invalid Trace IDs are removed from the payload.