modify
Edit supercampaign parameters.
Request format
https://adfox.yandex.com/api/v1
? object=superCampaign
& action=modify
& objectID=<integer>
& [name=<string>]
& [advertiserID=<integer>]
& [assistantID=<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>]
|
|
ID of the supercampaign whose parameters you want to edit. |
|
|
Supercampaign name. An entry can contain Russian and Latin letters, numbers, and any special characters. |
|
|
Advertiser ID. Read also: |
|
|
ID of the assistant who will be allowed access to the object according to their permissions. Read also: |
|
|
Object status. Only objects with the active status can be displayed. Acceptable values:
Default value: |
|
|
For more information on how to get the list of industries, see utility-sector. |
|
|
Maximum number of banner impressions. Acceptable values: an integer from |
|
|
Maximum number of impressions per day. Acceptable values: an integer from |
|
|
Maximum number of impressions per hour. Acceptable values: an integer from |
|
|
Maximum total number of click-throughs. Acceptable values: an integer from |
|
|
Maximum number of clicks per day. Acceptable values: an integer from |
|
|
Maximum number of clicks per hour. Acceptable values: an integer from |
|
|
How often a user is exposed to an ad campaign over its entire duration. Maximum number of banner impressions per user. Acceptable values: an integer from The value must be greater than or equal to |
|
|
How often a user is exposed to an ad campaign during the selected period. Impression frequency period. Acceptable values:
Default value: You need to specify at least one of these parameters:
|
|
|
How often a user is exposed to an ad campaign during the selected period. If you set impression frequency to Time transmission format: |
|
|
How often a user is exposed to an ad campaign during the selected period. Maximum number of impressions for the selected period. |
|
|
How often a user is exposed to an ad campaign over its entire duration. Minimum period between banner impressions for a unique user (hours:minutes:seconds). Time transmission format with seconds: |
|
|
Ad running start date. Date and time transmission format: Default value: today from 00:00. |
|
|
Ad running end date. Date and time transmission format: |
|
|
Submit data to the state register (ERIR). Acceptable values:
|
|
|
ID of a direct or primary contract. Required if |
|
|
ID of the contract with the end advertiser. Required if |
|
|
Campaign type. Acceptable values:
Default value: |
Response format
<response>
<status>
<code>{integer}</code>
<ID>{integer}</ID>
</status>
</response>
Тексты
Response parameters
|
|
Request processing status. A value of |
|
|
Object ID. |
Формат ответа
Sample request and response
Request:
https://adfox.yandex.com/api/v1?object=superCampaign&action=modify&objectID=39377&name=April_16_coffee&advertiserID=456&dateStart=2021-12-21 06:30&dateEnd=2021-12-30 22:30Response:
<response> <status> <code>0</code> <ID>39377</ID> </status> </response>
Other actions with the object
See more actions with the superCampaign object:
- Add a supercampaign.
- Delete a supercampaign.
- Get a list of supercampaigns.
- Add an additional assistant.
- Add an additional advertiser.
- Delete an additional assistant.
- Delete an additional advertiser.
ID of the supercampaign whose parameters you want to edit.
Supercampaign name.
An entry can contain Russian and Latin letters, numbers, and any special characters.
Advertiser ID.
Read also:
ID of the assistant who will be allowed access to the object according to their permissions.
Read also:
Object status. Only objects with the active status can be displayed.
Acceptable values:
0: Active. The object is ready for delivery.1: Suspended. 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 have completed its delivery. By default, filters in the Adfox web interface hide completed objects.
Default value: 0.
For more information on how to get the list of industries, see utility-sector.
Maximum number of banner impressions.
Acceptable values: an integer from 1 to 2147483647.
Maximum number of impressions per day.
Acceptable values: an integer from 1 to 2147483647.
Maximum number of impressions per hour.
Acceptable values: an integer from 1 to 2147483647.
Maximum total number of click-throughs.
Acceptable values: an integer from 1 to 2147483647.
Maximum number of clicks per day.
Acceptable values: an integer from 1 to 2147483647.
Maximum number of clicks per hour.
Acceptable values: an integer from 1 to 2147483647.
How often a user is exposed to an ad campaign over its entire duration.
Maximum number of banner impressions per user.
Acceptable values: an integer from 1 to 2147483647.
The value must be greater than or equal to minUniqueImpressions.
How often a user is exposed to an ad campaign during the selected period. 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.
You need to specify at least one of these parameters:
minImpressionsPerPeriodimpressionsPerPeriodavgImpressionsPerPeriod
How often a user is exposed to an ad campaign during the selected period.
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 transmission format: HH:mm.
How often a user is exposed to an ad campaign during the selected period.
Maximum number of impressions for the selected period.
How often a user is exposed to an ad campaign over its entire duration.
Minimum period between banner impressions for a unique user (hours:minutes:seconds).
Time transmission format with seconds: HH:mm:ss.
Ad running start date.
Date and time transmission format: YYYY-MM-DD HH:mm.
Default value: today from 00:00.
Ad running end date.
Date and time transmission 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).
ID of a direct or primary contract.
Required if sendToErir=1. Find out how to get the 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.
Required parameter.