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>]

objectID*

ID of the supercampaign whose parameters you want to edit.

name

Supercampaign name.

An entry can contain Russian and Latin letters, numbers, and any special characters.

advertiserID

Advertiser ID.

Read also:

assistantID

ID of the assistant who will be allowed access to the object according to their permissions.

Read also:

status

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.

sectorID

Industry.

For more information on how to get the list of industries, see utility-sector.

maxImpressions

Maximum number of banner impressions.

Acceptable values: an integer from 1 to 2147483647.

maxImpressionsPerDay

Maximum number of impressions per day.

Acceptable values: an integer from 1 to 2147483647.

maxImpressionsPerHour

Maximum number of impressions per hour.

Acceptable values: an integer from 1 to 2147483647.

maxClicks

Maximum total number of click-throughs.

Acceptable values: an integer from 1 to 2147483647.

maxClicksPerDay

Maximum number of clicks per day.

Acceptable values: an integer from 1 to 2147483647.

maxClicksPerHour

Maximum number of clicks per hour.

Acceptable values: an integer from 1 to 2147483647.

maxUniqueImpressions

Frequency of the user's contact with the ad campaign. Maximum number of impressions per user.

Acceptable values: an integer from 1 to 2147483647.

frequencyTypeImpressions

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.

uniquePeriodImpressions

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 transmission format: HH:mm.

impressionsPerPeriod

Frequency of the user's contact with the campaign. Number of impressions per period.

minimalPeriodImpressions

Frequency of the user's contact with the campaign. Minimum period between banner impressions for a unique user (hours:minutes:seconds).

Time transmission format with seconds: HH:mm:ss.

dateStart

Ad running start date.

Date and time transmission format: YYYY-MM-DD HH:mm.

Default value: today from 00:00.

dateEnd

Ad running end date.

Date and time transmission format: YYYY-MM-DD HH:mm.

sendToErir

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).

contractID

ID of a direct or primary contract.

This parameter is required if sendToErir=1. Learn more about getting a list of contracts.

publisherContractID

ID of the contract with the end advertiser.

Required if contractID points to a primary contract.

costType

Campaign type.

Acceptable values:

  • 0: Other.
  • 1: CPM.
  • 2: CPC.
  • 3: CPA.

Default value: 0.

Response format

<response>
  <status>
    <code>{integer}</code>
    <ID>{integer}</ID>
  </status>
</response>

Тексты

Response parameters

code

Request processing status. If the value is 0, the request was completed successfully. For the key, see Error handling.

ID

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:30

Response:

<response>
  <status>
    <code>0</code>
    <ID>39377</ID>
  </status>
</response>

Other actions with the object

See more actions with the superCampaign object:

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: 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.

Industry.

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.

Frequency of the user's contact with the ad campaign. Maximum number of impressions per user.

Acceptable values: an integer from 1 to 2147483647.

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 transmission 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 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.

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 parameter.