targetingFrequency
Target campaign placement in the site section by frequency.
Request format
https://adfox.yandex.com/api/v1
? object=campaign
& action=targetZone
& actionObject=targetingFrequency
& objectID=<integer>
& zoneID=<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. |
|
Site section ID. |
|
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=campaign&action=targetZone&actionObject=targetingFrequency&objectID=474205&zoneID=321&isRedefined=1&maxUniqueImpressions=2
Response:
<response> <status> <code>0</code> </status> </response>
Other actions with the object
See more actions with the campaign
object:
- Add a campaign.
- Get a list of campaigns.
- Delete a campaign.
- Edit a campaign.
- Get a list of campaign banners.
- Place a campaign on a site, a site section, or a placement.
ID of the object that the action is performed on.
Site section ID.
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
.
Frequency of the user's contact with the campaign. Minimum period between clicks (hours:minutes:seconds).
Time format with seconds: HH:mm:ss
.
Required