Advanced usages
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
- 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
- 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.
Last modified 1yr ago
Copy link