targetingFrequency
Target a banner by frequency.
You can use targeting by frequency to set the number and frequency of impressions for a unique user.
Request format
https://adfox.yandex.com/api/v1
? object=banner
& action=target
& actionObject=targetingFrequency
& objectID=<integer>
& isRedefined=<integer>
& [maxUniqueImpressions=<integer>]
& [maxUniqueClicks=<integer>]
& [datePeriod=<YYYY-MM-DD>]
& [frequencyTypeImpressions=<integer>]
& [uniquePeriodImpressions=<HH:mm>]
& [impressionsPerPeriod=<integer>]
& [minimalPeriodImpressions=<HH:mm:ss>]
& [frequencyTypeClicks=<integer>]
& [uniquePeriodClicks=<HH:mm>]
& [clicksPerPeriod=<integer>]
& [minimalPeriodClicks=<HH:mm:ss>]
|
ID of the object that the action is performed on. |
|
Redefine targeting. Acceptable values:
|
|
Frequency of the user's contact with the campaign. Maximum number of impressions per user. Acceptable values: |
|
Frequency of the user's contact with the campaign. Maximum number of clicks per user after which ad display is limited. Acceptable values: |
|
Frequency of the user's contact with the campaign. Start date of the period when the set limit of impressions or clicks is in effect. Date format: |
|
Frequency of the user's contact with the campaign. Impression frequency period. Acceptable values:
Default value: |
|
Frequency of the user's contact with the campaign. If you set impression frequency to other period ( Time format: |
|
Frequency of the user's contact with the campaign. Number of impressions per period. |
|
Frequency of the user's contact with the campaign. Minimum period between banner impressions for a unique user (hours:minutes:seconds). Time format with seconds: |
|
Frequency of the user's contact with the campaign. Click frequency period. Acceptable values:
Default value: |
|
Frequency of the user's contact with the campaign. If you set click frequency to other period ( Time format: |
|
Frequency of the user's contact with the campaign. Number of clicks per period. Acceptable values: |
|
Frequency of the user's contact with the campaign. Minimum period between clicks (hours:minutes:seconds). Time format with seconds: |
* Required
Response format
<response>
<status>
<code>{integer}</code>
</status>
</response>
Response parameters
|
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=targetingFrequency&objectID=474205&isRedefined=1&maxUniqueImpressions=2
Response:
<response> <status> <code>0</code> </status> </response>
Other actions with the object
See more actions with the banner
object:
- Get a list of banners.
- Add a banner.
- Edit a banner.
- Get summary information on targeting at the banner level.
- Get information on banner placement.
- Get statistics on campaigns/banners/placements for the day.
- Target a banner by geography.
- Target a banner by keywords.
- Target a banner by URL.
- Target a banner by gender, age, or income.
- Target a banner by user characteristics.
- Target a banner by time.
Frequency of the user's contact with the campaign. Minimum period between clicks (hours:minutes:seconds).
Time format with seconds: HH:mm:ss
.
Required
ID of the object that the action is performed on.
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.
Frequency of the user's contact with the campaign. Maximum number of impressions per user.
Acceptable values: an integer from 1 to 2,147,483,647
.
Frequency of the user's contact with the campaign. Maximum number of clicks per user after which ad display is limited.
Acceptable values: an integer from 1 to 2,147,483,647
.
Frequency of the user's contact with the campaign. Start date of the period when the set limit of impressions or clicks is in effect.
Date format: YYYY-MM-DD
.
Frequency of the user's contact with the campaign. Impression frequency period.
Acceptable values:
-
0
: Not set. -
1
: An hour. -
2
: Four hours. -
3
: Six hours. -
4
: 12 hours. -
5
: 24 hours. -
6
: A week. -
7
: A month. -
8
: Other period. -
9
: 14 days.
Default value: 0
.
Frequency of the user's contact with the campaign.
If you set impression frequency to other period (frequencyTypeImpressions=8
), specify your own period for serving banners to a unique user in hours and minutes.
Time format: HH:mm
.
Frequency of the user's contact with the campaign. Number of impressions per period.
Frequency of the user's contact with the campaign. Minimum period between banner impressions for a unique user (hours:minutes:seconds).
Time format with seconds: HH:mm:ss
.
Frequency of the user's contact with the campaign. Click frequency period.
Acceptable values:
-
0
: Not set. -
1
: An hour. -
2
: Four hours. -
3
: Six hours. -
4
: 12 hours. -
5
: 24 hours. -
6
: A week. -
7
: A month. -
8
: Other period. -
9
: 14 days.
Default value: 0
.
Frequency of the user's contact with the campaign.
If you set click frequency to other period (frequencyTypeClicks=8
), specify your own period. If the user clicks the banner the maximum allowed number of times during the period, the banner impressions for this user are limited until the end of the period.
Time format: HH:mm
.
Frequency of the user's contact with the campaign. Number of clicks per period.
Acceptable values: an integer from 1 to 2,147,483,647
.