targetingAge

Target a banner by age.

Targeting by age is based on audience data about visitors to the website.

For targeting by gender, age, and income, Adfox uses the Crypta technology data.

by default, this type of targeting is disabled for all campaigns and banners. This means that the campaign is shown to users with any gender, age, and income characteristics.

You can enable this targeting type (the age parameter: Enable targeting) and select the values to use in campaign targeting. Once targeting is enabled, you can view a report on impressions for the campaign based on user data.

Request format

https://adfox.yandex.com/api/v1
  ? object=banner
  & action=target
  & actionObject=targetingAge
  & objectID=<integer>
  & age=<integer>
  & ageValues=<integer>
  & isRedefined=<integer>

objectID*

ID of the object that the action is performed on.

age*

Enable targeting by age.

Acceptable values:

  • 0: Disabled.
  • 1: Enabled.

ageValues*

Select the age value.

The parameter is required if age=1.

Acceptable values:

  • 1: Under 18.
  • 2: From 18 to 24.
  • 3: From 25 to 34.
  • 4: From 35 to 44.
  • 5: Over 45 (the value is deprecated, it includes values 6 and 7 automatically).
  • 6: From 45 to 54.
  • 7: Over 55.

You can pass multiple values separated with a vertical line \| without spaces.

isRedefined*

Redefine targeting.

Acceptable values:

  • 0: Inherit targeting settings from a higher level. Level hierarchy from top to bottom:

    • Campaign.
    • Campaign on the site.
    • Campaign in the site section.
    • Campaign on the placement.
    • Banner.
  • 1: Cancel targeting settings at higher levels and use the settings of the current level.

* Required

Response format

<response>
<status>
  <code>{integer}</code>
</status>
</response>

Response parameters

code

Request processing status. For the key, see Error handling.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=banner&action=target&actionObject=targetingAge&objectID=2783648&age=1&ageValues=1&isRedefined

Response:

<response>
<status>
  <code>0</code>
</status>
</response>

Other actions with the object

See more actions with the banner object: