Audience feed
Moloco uses audience metadata to synchronize audience information and make them available as manual targets in the audience targeting feature. Integration of Audience lists is delivered via a Audience feed file (CSV format or CDP integration) which is uploaded to Moloco on a set schedule defined by the platform owner. Please review the information below to choose the integration method and schedule options for your platform.
There are two options for the audience ingestion:
- Audience Feed: Almost identical to the catalog feed. The entire audience list, including its audience members, should be provided through a fixed source. The list of supported fetch methods is identical to the catalog pipeline’s
NOTE
Unlike the Catalog feed, the audience feed does not support the in-between incremental update (aka UPDATE feed). Only updating as a whole (aka REFRESH feed) will be supported.
- CDP: Audience data stored in CDP can be redirected to Moloco just like user event data.
Audience feed
Please review the information below to prepare for the audience feed integration and schedule options for your platform.
Audience feed specifications
The specification for the feed file is the following:
The expected encoding for string data types is UTF-8.
Name | Description | Data Type | Required | Limit | Note | Example |
---|---|---|---|---|---|---|
audience_id | The unique identifier of the audience | String | Y | Up to 200 characters. Over limit will raise an error | A12b19cp | |
audience_label | The label of the audience | String | N | Up to 200 characters. Over limit will be truncated to 200 characters | Will be filled with audience\_id if empty | New Users |
user_ids | The list of user identifiers in this audience | String | Y, but an empty string is allowed | Should use ; for its delimiter | Vv21vs;Fvsdva;ppbic1952 | |
persistent_ids | The list of persistent ids in this audience | String | Y, but an empty string is allowed | Should use ; for its delimiter | AEBE52E7-03EE-455A-B3C4-E57283966239;GWBE52E7-03EE-455A-B3C4-E12GB966239;BBSD52E7-03EE-455A-B3C4-E57283966239 |
Requirements
- The feed file should contain the full list of members (Users/Persistent IDs) for each audience.
- Deleted audiences should be excluded from the feed file
- Exited members should be excluded from the audience’s member list
Audience feed integration
For the integration of the audience feed, please follow the catalog feed integration guide as it is similar to the way catalog integration is done.
Full Update Feed
The Full Update Feed is a audience file containing a list of all audiences and user/persistent IDs belonging to those audiences. The full update is typically imported daily at a designated time (e.g., Daily at 9 AM). However, you may request more frequent daily updates (e.g., Daily every 4 hours).
- Prepare a .csv or a compressed file (.csv.gz) with a list of all audiences. The compressed format is preferred.
CDP
Regarding the CDP integration with MCM Audiences, if you need to integrate using this method, please reach out to your Moloco representative.
Updated 3 days ago