How to send features to Promoted?

See What types of features does Promoted support? for descriptions of these features.

Content Item features

Send Content Item featuresContent Item features - Content item features are stable properties of the item to show. These can be attributes like color, a list of labeling tags, media like images, or free text like title or description. updates asynchronously to Promoted asap using the Content API. Promoted will process these quickly and have the data available in the ranking system. Content updates can also be sent to Promoted over Delivery API. However, larger RPC sizes will hurt latency.

User features

Send User featuresUser features - User features are stable properties of the user viewing the content. The user may be anonymous, in which case there are no or limited user features. User features can be user attributes like age and gender, lists of interests or behaviors that may be computationally inferred, or user-provided settings. in a similar way as Content Item Features but using the User method on the Content API.

Context features

Send Context featuresContext features - Context features are properties about where the items will be shown and to whom. For example, a search query, the page address, the mobile device type, geographic location, or time. on the RequestRequest - A request for a list of content, such as search, feed, or related items. to Delivery APIDelivery API - Our API that does matching / ranking. It delivers content..

Interaction features

Send Interaction featuresInteraction features - Interaction features require the intersection between two or more domains. Interaction features tend to be the most powerful features in scoring (item, user, context) matches. on the RequestRequest - A request for a list of content, such as search, feed, or related items. to Delivery APIDelivery API - Our API that does matching / ranking. It delivers content..

🚧

Avoid sending features back on View, Impression and Action log records

It's a common mistake to try to send features back on these records. The Promoted Delivery system either needs to (1) already have the features pre-processed or (2) have them passed our the Delivery API call. If you have questions, please message the Promoted team.


Did this page help you?