Infosum Audience

​

Overview

​

Prerequisites

1. A Google Cloud Storage Account
2. PGP Encryption Public Key from Infosum to encrypt your files. For more information, refer to PGP Encryption in Infosum.

​

Supported Identifiers

​

Components of Google Cloud Storage

​

Bucket

​

Folder

​

Account

​

Create a Destination for Infosum - Audience

1

Log into the Zeotap CDP App and go to the DESTINATIONS application.

2

Click + Create Destination.

3

Under the All Destinations section, search for Infosum - Audience.

4

Click Infosum - Audience. 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. Provide the required details as mentioned in the following steps:a. Enter a name for the Destination.b. In the Destination Instance Name field, provide a desired value for this internal field.c. In the Bucket field, provide the name of the Google Cloud Storage Bucket.d. In the Folder field, provide the folder path in your storage location where Zeotap CDP can store your exported data.

Note:Ensure to follow the below points while providing the folder path:

• The folder path should follow the below structure:
  • folder_name/sub_folder_name/
• The folder name should not start with a /
• The folder name and sub-folder name should end with a /

e. Under **Filename Prefix,**enter a text value without special characters, such as underscores (_), spaces, or symbols (#, @, $, %, &, \*). Note that the file name follows the format: ${filenamePrefix}part-${sequence}_${destinationAudienceId}_${timestamp}.csv, where the timestamp is in yyyy-MM-dd format and destinationAudienceId is the ID associated with your audience (segment) in Zeotap CDP, which is generated by the Zeotap CDP after the audience (segment) is linked to a Destination.

Variable	Description
filenamePrefix	The prefix for the file name, typically indicating the context or purpose of the file (e.g., the segment or export type).
part-${sequence}	A sequential number or identifier indicating the part or chunk number if the data is split across multiple files.
${destinationAudienceId}	The unique ID assigned by Zeotap CDP to the audience (segment) after it is linked to a Destination.
${timestamp}	The date when the file is generated, formatted as yyyy-MM-dd (e.g., 2024-08-06).
.csv	The file extension, indicating that the file is in CSV (Comma-Separated Values) format.
Example File Name:
exportpart-01_894548842_2024-08-06.csv

f. Under Account, choose either Zeotap Service Account or Client Service Account Json using the drop-down menu based on the type of authentication you need. If you wish to use Zeotap Service Account, then ensure that you whitelist this it to push audiences (segments) from Zeotap CDP to Google Cloud Storage Platform.

i. If you choose Zeotap Service Account as the Account, then ensure that you whitelist the service account provided by Zeotap CDP to push the audiences (segments) from Zeotap CDP to Google Cloud Storage Platform. This service account information auto-populates under Service Account to be Whitelisted as shown in the image below.

ii. If you choose Client Service Account Jsonas the Account, then you need to upload the JSON file with the required authentication information using the + Select File option so that Zeotap CDP can push the audiences to Google Cloud Storage Platform.

g. Under Send Encrypted Data, choose whether you want to encrypt your data using the PGP (Pretty Good Privacy) data transfer mechanism. If you choose Yes, then ensure that you upload the Public Key. For more information about PGP encryption, refer here.

h. Review all the values entered above and then click Next to proceed.

5

In the new screen that appears, choose the appropriate action and mapping as explained below. Under Choose your Action, Send CSV File to Infosum as the action for activating your audience in Audiences.

6

Click +Add Mapping Fields to select identifiers for InfoSum and map attributes from the Catalogue.

7

After finalising the attributes and identifiers to send, click Create Destination. The created Destination gets listed in the Audiences application, which can be linked to an audience.

​

Identify Segment Files in the Google Cloud Storage Bucket

• partNumber refers to the parts or segments of a multipart upload in Google Cloud Storage. Multipart uploads allows you to upload large files in multiple parts or chunks rather than uploading the entire file in one go. In the above naming convention, Part 0 refers to the first part of the multipart upload.
• channelId is the ID associated with your audience (segment) in Zeotap CDP. This is generated by the Zeotap CDP after the audience (segment) is linked to a Destination. You can obtain this information as shown in the image below.

• epochmilliTimestamp is the timestamp in epoch format.

​

Link an Audience to the Infosum - Audience Destination