Goal

Promoted uses Engagement signals to optimize your rankings.

Two main integration options

1. Proxy through your domain.

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

2. Call Promoted's APIs directly from Mobile.

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

🚧

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 straightforward:

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

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

Actions

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

Our Action data model is also straightfroward:

• A user identifier like anonUserId.
• Either Insertion ID or Content ID so Promoted can join the Impression with the corresponding Insertion.
• Custom properties (e.g., shopping cart information) depending on the type of Action. 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, it is preferred to pass them on the Request and Insertion.

For important actions (e.g., purchase complete), it may be advantageous 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, or actions.