Campaign targeting allows meta-information to be provided during an ad query, which can be used in real time to prioritize campaigns aimed at that specific audience.

🚧 Campaigns with targeting will have higher priority during the query process, meaning they are considered more relevant to the audience they were directed to. However, the presence of targeting does not prevent non-targeted campaigns from also being displayed.

Attributes are the types of information that the audience can have and consequently that a campaign can have during its creation.

Learn more about targeting attributes on POST Get ads.

During the ad request, targeting information can be sent in two ways: directly in the request body or based on the audiences associated with a user_id.

In this approach, targeting information is sent directly in the request body, in the "segmentation" field. This data is prioritized over information that could be obtained based on the user_id, allowing for more detailed and temporary personalization according to the conditions of the ad query.

Request example:

In this approach, targeting information is obtained based on the audiences associated with the user_id. These audiences must have been previously imported into the system.

🚧 When using this approach, don't send data in the segmentation field, since this field would take priority over user_id. The system will automatically fetch the audiences associated with the user_id.

Request example: