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. It can contain Russian and Latin letters, numbers, and any symbols. |
|
Advertiser ID. See also: |
|
The ID of the assistant to whom you want to give access to the object based on their permissions. See also: |
|
Object status. Only objects with the active status can be shown. Acceptable values:
|
|
See also: |
|
The maximum number of banner impressions. Acceptable values: |
|
The maximum number of impressions per day. Acceptable values: |
|
The maximum number of impressions per hour. Acceptable values: |
|
The maximum number of total clicks. Acceptable values: |
|
The maximum number of clicks per day. Acceptable values: |
|
The maximum number of clicks per hour. Acceptable values: |
|
The user's frequency cap for the campaign. The maximum number of impressions per user.
Acceptable values: |
|
The user's frequency cap for the campaign. Impression frequency period. Acceptable values:
|
|
The user's frequency cap for the campaign. If you set the impression frequency to other period ( Time format: |
|
The user's frequency cap for the campaign. Number of impressions per period. |
|
The user's frequency cap for the campaign. The minimum period between banner impressions for a unique user (hours:minutes:seconds). Time format with seconds: |
|
Ad running start date. Date and time format: |
|
Ad running end date. Date and time format: |
|
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. For the key, see Error handling. |
|
The ID of the supercampaign being edited. |
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:30
Response:
<response> <status> <code>0</code> <ID>39377</ID> </status> </response>
Other actions with the object
See also other 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. It can contain Russian and Latin letters, numbers, and any symbols.
Advertiser ID.
See also:
The ID of the assistant to whom you want to give access to the object based on their permissions.
See also:
Object status. Only objects with the active status can be shown.
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 on the list. -
2
: Completed — the object is assumed to be delivered in full. by default, filters in the Adfox web interface hide finished objects.
See also:
The maximum number of banner impressions.
Acceptable values: an integer from 1 to 2,147,483,647
.
The maximum number of impressions per day.
Acceptable values: an integer from 1 to 2,147,483,647
.
The maximum number of impressions per hour.
Acceptable values: an integer from 1 to 2,147,483,647
.
The maximum number of total clicks.
Acceptable values: an integer from 1 to 2,147,483,647
.
The maximum number of clicks per day.
Acceptable values: an integer from 1 to 2,147,483,647
.
The maximum number of clicks per hour.
Acceptable values: an integer from 1 to 2,147,483,647
.
The user's frequency cap for the campaign. The maximum number of impressions per user.
Acceptable values: an integer from 1 to 2,147,483,647
.
The user's frequency cap for 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.
The user's frequency cap for the campaign.
If you set the 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
.
The user's frequency cap for the campaign. Number of impressions per period.
The user's frequency cap for the campaign. The minimum period between banner impressions for a unique user (hours:minutes:seconds).
Time format with seconds: HH:mm:ss
.
Ad running start date.
Date and time format: YYYY-MM-DD HH:mm
.
Ad running end date.
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
.
Required