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.

NameDescriptionData TypeRequiredLimitNoteExample
audience_idThe unique identifier of the audienceStringYUp to 200 characters. Over limit will raise an errorA12b19cp
audience_labelThe label of the audienceStringNUp to 200 characters. Over limit will be truncated to 200 charactersWill be filled with audience\_id if emptyNew Users
user_idsThe list of user identifiers in this audienceStringY, but an empty string is allowedShould use ; for its delimiterVv21vs;Fvsdva;ppbic1952
persistent_idsThe list of persistent ids in this audienceStringY, but an empty string is allowedShould use ; for its delimiterAEBE52E7-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.