Sending Engagements Signals

Promoted uses use engagement signals, like impressions and actions, to rank your content

Goal

Promoted uses Engagement signals to optimize your rankings.

Two main integration options

1. Proxy through your domain.

Forward engagement signals to your a proxy endpoint in your domain. For web, Promoted encourages these signals to either go through your server as a proxy or using a special DNS record so web browsers can avoid using 3rd party cookies and HTTP requests.

300

2. Call Promoted's APIs directly from Mobile.

Promoted provides Client Metrics Libraries for iOS, Android, React Native, and Web (Snowplow).

300

🚧

Although the Delivery SDK requires both delivery and metrics tokens, engagement signals are not sent through the Delivery SDK.

Most metrics requests hit Promoted's HTTP endpoint directly, with the exception of the SDKs provided for mobile and web.

Impressions

Promoted's Impression data model is pretty simple:

  • A user identifier like anonUserId.
  • Either Insertion ID or Content ID so Promoted can join the Impression with backing Insertion.
  • Timing information.

Promoted provides SDKs for tracking impressions on web, iOS and Android.

Actions

(User) Action include user-initiated behaviors like navigating, liking, sharing, checking out and purchasing.

Our Action data model is also pretty simple:

  • A user identifier like anonUserId.
  • Either Insertion ID or Content ID so Promoted can join the Impression with backing Insertion.
  • Custom properties depending on the type of Action. E.g. shopping cart information. It's useful to attach properties that might help with debugging or stating your goal. If you want to pass a Feature for our machine learning models, prefer to pass them on the Request and Insertion .

For more important actions (like purchase complete), it might make sense to log these directly from your server to minimize the risk of bad actors manipulating the log records.

If you have an Action that is not in our ActionType list, let Promoted know.

👍

Promoted joins the records and derives insights for you.

All you have to do is send the data. Your code does not need to join together insertions, impressions and actions.