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:
  1. 1.
    In the navigator, a user activates the feed on a specific segment with specific options.
  2. 2.
    The feed tries to create the segment in the partner's architecture. On success, feed is marked as published.
  3. 3.
    It then tries to add a user to the partner's segment. On success, feed is marked as active.
  4. 4.
    It goes into initial loading state, sending the whole segment to the partner. On success, feed is marked as live.
  1. 1.
    Segment updates are sent to the partner. Those are differential updates (who enters the segment, who leaves the segment). We don't send a complete list of all users in a segment to minimize loads on our architecture, but also on the partner's architecture.

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.