superCampaign
Add super campaigns. A super campaign is an object that includes multiple campaigns. You can use super campaigns to place multiple campaigns with cross-frequency on different placements and receive reports on the overlap in the campaign audiences.
Request format
https://adfox.yandex.com/api/v1
? object=account
& action=add
& actionObject=superCampaign
& name=<string>
& advertiserID=<integer>
& [assistantID=<integer>]
& [impressionsMethodID=<integer>]
& [status=<integer>]
& [sectorID=<integer>]
& [maxImpressions=<integer>]
& [maxImpressionsPerDay=<integer>]
& [maxImpressionsPerHour=<integer>]
& [maxClicks=<integer>]
& [maxClicksPerDay=<integer>]
& [maxClicksPerHour=<integer>]
& [maxUniqueImpressions=<integer>]
& [frequencyTypeImpressions=<integer>]
& [uniquePeriodImpressions=<HH:mm>]
& [impressionsPerPeriod=<integer>]
& [minimalPeriodImpressions=<HH:mm:ss>]
& [dateStart=<YYYY-MM-DD HH:mm>]
& [dateEnd=<YYYY-MM-DD HH:mm>]
& [sendToErir=<integer>]
& [contractID=<integer>]
& [publisherContractID=<integer>]
& [costType=<integer>]
|
Object name. An entry can contain Russian and Latin letters, numbers, and any special characters. |
|
Advertiser ID. See also: |
|
ID of the assistant who will be allowed access to the object according to their permissions. See also: |
|
Acceptable values:
|
|
Object status. Only objects with the active status can be displayed. Acceptable values:
Default value: |
|
See also: |
|
Maximum number of banner impressions. Acceptable values: |
|
Maximum number of impressions per day. Acceptable values: |
|
Maximum number of impressions per hour. Acceptable values: |
|
Maximum total number of clicks. Acceptable values: |
|
Maximum number of clicks per day. Acceptable values: |
|
Maximum number of clicks per hour. Acceptable values: |
|
Frequency of the user's contact with the ad campaign. Maximum number of impressions per user. Acceptable values: |
|
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: 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 |
|
Delivery start date. Default value: Date and time format: YYYY-MM-DD HH:mm |
|
Delivery end date. Date and time format: YYYY-MM-DD HH:mm |
|
Submit data to the state register (ERIR). Acceptable values:
Default value: |
|
ID of a direct or primary contract. This parameter is required if |
|
ID of the contract with the end advertiser. Required if |
|
Campaign type. Acceptable values:
Default value: |
* Required
Response format
<response>
<status>
<code>{integer}</code>
<ID>{integer}</ID>
</status>
</response>
Response parameters
|
Request processing status. If the value is |
|
Object ID. |
Sample request and response
Request:
https://adfox.yandex.com/api/v1?object=account&action=add&actionObject=superCampaign&name=April_16_tea&advertiserID=456&dateStart=2021-12-20 06:30&dateEnd=2021-12-31 22:30
Response:
<response> <status> <code>0</code> <ID>39377</ID> </status> </response>
Other actions with the object
See more actions with the superCampaign
object:
- Edit a super campaign.
- Delete a super campaign.
- Get a list of super campaigns.
- Add an additional assistant.
- Add an additional advertiser.
- Delete an additional assistant.
- Delete an additional advertiser.
Delivery end date.
Date and time format: YYYY-MM-DD HH:mm
Required
Object name. An entry can contain Russian and Latin letters, numbers, and any special characters.
Advertiser ID.
See also:
ID of the assistant who will be allowed access to the object according to their permissions.
See also:
Acceptable values:
-
0
: Banner ad response. An impression is counted when the banner code is uploaded to the site page. -
101≤N≤130
, where N is the event sequence number from 1 to 30 (101 corresponds to event 1, 105 corresponds to event 5, and so on). An impression is counted when the event with the specified number is called by the banner on the site page. -
1101
: Viewable impression, Yandex (IMS). An impression is only counted if at least 50% of the banner area is in the active browser window for at least two seconds. -
2101
: Impression (IMS). An impression event that occurs when ad rendering begins. -
2102
: Viewable impression (IMS). Iimpressions in the viewable area of the window in the active browser tab, counted according to the criteria established by international media industry standards (minimum percentage of pixels in the viewable area and display time in the viewable browser area).
Object status. Only objects with the active status can be displayed.
Acceptable values:
-
0
: Active. The object is ready for delivery. -
1
: Paused. The object is assumed to be temporarily disabled. by default, filters in the Adfox web interface show paused objects in the list. -
2
: Completed. The object is assumed to be delivered in full. by default, filters in the Adfox web interface hide completed objects.
Default value: 0
.
See also:
Maximum number of banner impressions.
Acceptable values: integers from 1 to 2,147,483,647
.
Maximum number of impressions per day.
Acceptable values: integers from 1 to 2,147,483,647
.
Maximum number of impressions per hour.
Acceptable values: integers from 1 to 2,147,483,647
.
Maximum total number of clicks.
Acceptable values: integers from 1 to 2,147,483,647
.
Maximum number of clicks per day.
Acceptable values: integers from 1 to 2,147,483,647
.
Maximum number of clicks per hour.
Acceptable values: integers from 1 to 2,147,483,647
.
Frequency of the user's contact with the ad campaign. Maximum number of impressions per user.
Acceptable values: integers from 1 to 2,147,483,647
.
Frequency of the user's contact with the campaign. Impression frequency period.
Acceptable values:
-
0
: Not set. -
1
: One hour. -
2
: Four hours. -
3
: Six hours. -
4
: 12 hours. -
5
: 24 hours. -
6
: One week. -
7
: One 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
Delivery start date.
Default value: today from 00:00
.
Date and time format: YYYY-MM-DD HH:mm
Submit data to the state register (ERIR).
Acceptable values:
-
0
: Do not submit data to the state register. -
1
: Submit data to state register (labeling enabled).
-
When the parameter changes from
0
to1
, the object is submitted to the state register. -
When the parameter changes from
1
to0
, ad labeling is disabled in Adfox. Previously submitted object data remain in the state register.
ID of a direct or primary contract.
This parameter is required if sendToErir = 1
. Learn more about getting a list of contracts.
ID of the contract with the end advertiser.
Required if contractID
points to a primary contract.
Campaign type.
Acceptable values:
0
: Other.1
: CPM.2
: CPC.3
: CPA.
Default value: 0
.