Overview
PromoteIQ is a platform that allows businesses to advertise to shoppers across the open web. By using retailers’ first-party data, PromoteIQ enables advertisers to target their ads to individual shoppers, regardless of where they are browsing. Integrated with Zeotap CDP, it can help businesses increase their reach and efficiency when promoting their products and services to potential customers. Zeotap automatically creates audiences (segments) in PromoteIQ. Unlike typical integrations, users associated with audiences are not directly sent to PromoteIQ. Instead, you must provision an AWS S3 bucket to receive data files. Then, you can transfer the segment list from the S3 bucket to PromoteIQ to run relevant campaigns on your website. The workflow diagram below illustrates the integration with the PromoteIQ Destination.
Supported Identifiers
This integration supports custom identifiers.Available Actions and Supported Features
The following table lists the available action types for the integration and the supported features for each action type:| Action Name | ID EXTENSION | DELETE | DELTA UPLOAD |
|---|---|---|---|
| Send Identifiers to Promote IQ | - | - | - |
Components of PromoteIQ
Ensure that you have the following details about the PromoteIQ available before creating a Destination.- API Key
- API ID
- API URL
- S3 Bucket
- S3 Folder
- S3 Client ID and Client Secret
- S3 Region
API Key and API ID
An API key and API ID are two types of credentials used in PromoteIQ for authentication and authorisation purposes. Example If your API Token is1000000020-5e134485439a2d183db5f9226777e0a14a12b9bb1beeba2ea44804e4e04dc9d250abbc2e277a8432ee4c010fd6a3528182afceb510667a4cbe112dc3e5a2e9d3, then:
5e134485439a2d183db5f9226777e0a14a12b9bb1beeba2ea44804e4e04dc9d250abbc2e277a8432ee4c010fd6a3528182afceb510667a4cbe112dc3e5a2e9d3is your API Key.1000000020is your API ID.
API URL
API URL is the endpoint of your PromoteIQ APIs that you have created.S3 Bucket
This is the name of your S3 bucket. You can obtain this information on your Amazon S3 account by navigating to Buckets. In the example shown below, test-adobe-s3-bucket is the bucket name.
S3 Folder
In Amazon S3, a folder serves as a logical container for organising stored objects within a bucket. In reality, there are no actual folders in Amazon S3. Instead, the folder concept is emulated by employing object key names containing slashes (”/”) to replicate a hierarchical arrangement. You can obtain this information from your Amazon S3 account by navigating to the Objects tab under the Amazon S3 bucket as shown in the image below. Ensure that you follow the folder structure shown below.folder_name/sub_folder_name/
S3 Client ID and Client Secret
These are the security tokens that provide secure access to your Amazon S3 resources. You can obtain the Client ID and Secret by navigating to the AWS IAM Credentials tab under Security credentials in your Amazon S3 account.S3 Region
This is the geographical location where the Amazon S3 storage is available. You can obtain this information by navigating to the Properties tab under the Amazon S3 bucket as shown in the image below.
Create a Destination for PromoteIQ
Perform the following steps to create a Destination for PromoteIQ:
Click PromoteIQ. A screen appears displaying details about the particular destination towards the left. On the right-hand side of the screen find a list of fields that are required for the integration to be established. Enter the required details as mentioned in the following steps:a. Enter a name for the Destination.b. Enter the API Key, API URL and API ID obtained form your Promote IQ POC.c. In the S3 Bucket field, provide the name of the Amazon S3 Bucket.d. In the S3 Folder field, provide the folder path in your storage location where Zeotap CDP can store your exported data.e. Enter S3 Client ID and S3 Client Secret that you obtained from your Amazon S3 account.f. In the S3 Region field, choose the geographical region where your Amazon S3 bucket is available from the drop-down menu.g. Review all the values entered above and then click Next to proceed.
In the new screen that appears, under Choose your Action, select Send Identifiers to PromoteIQ as the action for activating your audience (segment) on the Audiences module. Under Map the Fields, you can map any custom identifier that you wish to send to Promote IQ.
Identify Segment Files in the AWS S3 Bucket
After an Audience is linked to a Destination, Zeotap CDP generates segment files in CSV format with the following naming convention:<segment_name>_<timestamp_in_yyyyMMdd-hhmmssSSS>.csv.gz
The file contains two columns (column 1: CID; column 2: Segment ID created in PromoteIQ) without any header. Here, the segment ID is your Audience ID designated to your audience (segment) that you created on Zeotap CDP. Note that the these columns are comma-separated and the maximum file size limit for the Segment file is 5GB. If the file size is larger than 5GB, then they are split into different parts.
Note:Full refreshes will be sent to the S3 bucket as per the configured refresh frequency.