targetingGender

Target a banner by gender.

Targeting by gender 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 Enable targeting parameter) 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=targetingGender
  & objectID=<integer>
  & gender=<integer>
  & genderValues=<integer>
  & isRedefined=<integer>

objectID*

ID of the object that the action is performed on.

gender*

Enable targeting by gender.

Acceptable values:

  • 0: Disabled.
  • 1: Enabled.

genderValues*

Select the gender value.

The parameter is required if gender=1.

Acceptable values:

  • 1: Male.
  • 2: Female.

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=targetingGender&objectID=2783648&gender=1&genderValue=1&isRedefined=1

Response:

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

Other actions with the object

See more actions with the banner object:

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

ID of the object that the action is performed on.

Enable targeting by gender.

Acceptable values:

  • 0: Disabled.

  • 1: Enabled.

Select the gender value.

The parameter is required if gender=1.

Acceptable values:

  • 1: Male.

  • 2: Female.