Audience segment feed

An audience feed is a plugin acting like a connector that allows mediarithmics customers to push their segments to a third-party platform.

It is generic: once a connector to a partner has been created, every customer can use it. Each audience feed has a specific set of options to adapt to each customer.

Server-side feeds

It sends segments to partners in batches with the following process:

Initialization phase

  1. In the navigator, a user activates the feed on a specific segment with specific options.

  2. The feed tries to create the segment in the partner's architecture. On success, feed is marked as PUBLISHED.

  3. It then tries to add a user to the partner's segment. On success, feed is marked as ACTIVE.

  4. It goes into INITIAL LOADING state, sending the whole segment to the partner. On success, feed is marked as LIVE.

Live phase

Differential segment updates are sent to the partner to maintain the segment synchronized:

  • Upsert operations for users entering the segment, or if existing users in the segment gain additional identifiers used in the sync.

  • Delete operations for users leaving the segment, being deleted from the datamart or updating their user choice in a way that makes it incompatible with being in the segment (if you chose to use a processing activity when defining your segment).

For more details on how to manage consent in segments and feeds, have a look at the User choices section.

Client-side feeds

Client-side feeds send segments to partners by showing a pixel to your users if they are in the segment. It is either active or paused.

Key concepts

An audience external feed is a mediarithmics plugin specific to a partner, but shared across customers. In the UI, it is called Server-side plugin: go to a specific segment, click Add a feed, and you will see a feed type called server-side. It is marketed as connectors or server-to-server connectors.

It has:

  • Plugin definition

    • group_id: com.mediarithmics.audience.externalfeed

    • artifact_id: [[partner]]-connector

  • Plugin versions with

    • Deployed code

    • An external service referencing partner’s API

    • Configuration files for things like credentials, tokens, technical configurations

A feed is an instance of an audience feed. It is specific to a segment in an organisation. It has:

  • Feed ID

  • Instance properties specified by users in the UI when adding a feed to a segment.

A feed session is created every time an external feed becomes active. A new session is created if a feed is paused, then reactivated. It is invisible in the UI.

A feed preset is a template allowing users to easily create feed instances with pre-configured properties. You can, for example, create a Facebook feed preset containing your key for your organisation, and you won't have to remember it every time you set up a new feed.

Last updated