Skip to main content

​
Overview

Channable is a powerful feed management and automation platform that helps businesses streamline their product data for eCommerce, marketplaces, and advertising channels. It enables users to optimize, transform, and distribute product feeds to multiple platforms such as Google Shopping, Amazon, and Meta Ads — all from a single interface. This integration allows users to send data from Zeotap in CSV format to a Google Cloud Storage (GCS) bucket and then import it directly into their Channable instance

​
Prerequisites

Before creating a Channable Destination in Zeotap CDP, ensure that you have:
  • An active Channable account
  • Access to a Google Cloud Storage (GCS) bucket

​
Components of Google Cloud Storage

Ensure that you have the details about the below components of the Google Cloud Storage account before creating a Destination.
  • Bucket
  • Folder
  • Account

​
Bucket

This is the name of your Google Cloud Storage Bucket. You can obtain this information from your Google Cloud Storage account as shown in the image below.

​
Folder

In Google Cloud Storage, a folder serves as a logical container for organising stored objects within a bucket. In reality, there are no actual folders in Google Cloud Storage. 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 Google Cloud Storage account as shown in the image below.

​
Account

This is the Zeotap Service Account that is used to access the Google Cloud Storage account. Ensure that you whitelist the Zeotap Service Account to successfully push audiences (segments) from Zeotap CDP to Google Cloud Storage.

​
Create a Destination for Channable GCS Upload

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 Channable GCS Upload.
4
Click Channable GCS Upload. 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.
VariableDescription
filenamePrefixThe 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).
.csvThe file extension, indicating that the file is in CSV (Comma-Separated Values) format.
Example File Name: exportpart-01_894548842_2024-08-06.csvf. 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 Json as 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. 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 data to Channable, as the action for activating your audience in Audiencesa. The following are the mandatory fields that needs to be mapped :i. Availabilityii. Brandiii. Descriptioniv. IDv. Image Linkvi. Linkvii. Priceviii. Product Typeix. Sale Pricex. Sizexi. TitleYou can click on + Add Mapping Field to include additional fields. Here is the complete list of fields supported by Channable
6
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

After an Audience is linked to a Destination, Zeotap CDP generates segment files in CSV format with the following naming convention: {filenamePrefix}{fileNumber}_${channelId}_${timestamp}.csv, where the timestamp is in epoch format. In case of multipart upload, the format is {partNumber}_{filenamePrefix}{fileNumber}_${channelId}_${timestamp}.csv where,
  • 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.
Let’s understand this with an example. Suppose you create an audience segment called PublicAbove18 with Channel ID 12345678, a filename prefix testprefix, and a file number 98765. The timestamp information in epoch milliseconds is 1625138600. When this file is uploaded to GCS as the first part of the multipart upload, the file is named as follows: Part0_testprefix98765_12345678_1625138600.csv For information about how to link an audience or segment to the created Destination in Audiences application, refer here.
Note:The terms Audiences and Segments are used interchangeably to refer to customer cohorts belonging to a specific category. For example, an Audience or a segment could be a specific group of customers who are over 18 years of age and who have performed an addToCart event within the last 30 days.

​
Connecting Your CSV File to Channable

1
Prepare Your CSV File: Make sure your product data is in CSV format and stored in your GCS bucket.
2
Log in to Channable: Access your Channable account and navigate to your project.
3
Create a New Import: Go to Feeds or Imports (depending on your account setup) and select Google Cloud Storage as the source.
4
Authorize Access: Provide Channable with the necessary permissions to access your GCS bucket. This usually involves entering your project and bucket details or generating a service account key.
5
Specify the File Path: Enter the path to your CSV file in the GCS bucket, e.g.,
gs://your-bucket-name/your-file-name.csv
6
Configure Import Options: Review and configure options such as delimiter, encoding, and field mapping to ensure your data is imported correctly.
7
Test the Connection: Run a test import to confirm that Channable can access and read your CSV file.
8
Start Importing: Once everything is set up, you can schedule imports or run them manually to keep your Channable instance updated with the latest data.
Last modified on February 26, 2026