ROKT Connector Setup Guide | Server-Side Connectors

Connector actions

Action Name	AudienceStream	EventStream
Send Conversion	✓	✓

API information

This connector uses the following vendor API:

API Name: ROKT API
API Version: 2020-05-21
API Endpoint: <https://api.rokt.com>
Documentation: ROKT Event API

Batch limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

Max number of requests: 100
Max time since oldest request: 10 minutes
Max size of requests: 1 MB

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:

Client ID
- Required. Provide your App ID or Public Key.
Client Secret
- Required. Provide your App Secret or Secret Key.
Account ID
- Required. Provide your Account ID.

For more information, see the Rokt documentation for the API version you are using: * v1: Event API | Rokt documentation. * v2: Event API | Rokt documentation.

Click Done when you have finished configuring the connector.

Actions

Action Name	AudienceStream	EventStream
Send event	✓	✓
Send event (Batch)	✓	✓
Update custom audience	✓	✓
Update custom audience (Batch)	✓	✓

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 event

Conversion Data

Parameter	Description
Event ID	If not mapped, Tealium generates a `UUID` for this value.
Event Time	If not mapped, is set to the current timestamp in RFC 3339 format.
Meta Data	Non-business critical information about the event.
Version	Default is `V2`. Set to `V1` to send events to the V1 endpoint using the App ID and App Secret keys. Set to `V2` to send events to the V2 endpoint using the rpub and rsec keys.

Send event (Batch)

Conversion Data

Parameter	Description
Event ID	If not mapped, Tealium generates a `UUID` for this value.
Event Time	If not mapped, is set to the current timestamp in RFC b3339 format.
Meta Data	Non-business critical information about the event.
Version	`V1` is the default. Set to `V1` to send events to the V1 endpoint using the App ID and App Secret keys. Set to `V2` to send events to the V2 endpoint using the rpub and rsec keys.

Update custom audience

Parameters

Parameter	Description
Action	Set to `include` to add a visitor to the specified list, which can then be used for targeting or suppression. Set to `exclude` to remove a visitor from the specified list.
Email	An email address.
List	The name of the custom audience list to use. If no list value is provided, the email address is imported into the AdvertiserDatabase list by default.
SHA-256 Hashed

Update custom audience (Batch)

Parameters

Parameter	Description
Action	Set to `include` to add a visitor to the specified list, which can then be used for targeting or suppression. Set to `exclude` to remove a visitor from the specified list.
Email	An email address.
List	The name of the custom audience list to use. If no list value is provided, the email address is imported into the AdvertiserDatabase list by default.
SHA-256 Hashed