add

Не более 1 корректировки ставок на мобильных для одной кампании или группы объявлений.

Не более 1 корректировки ставок для видеодополнений для одной кампании или группы объявлений.

Не более 1 корректировки ставок для смарт-объявлений для одной кампании или группы объявлений.

Не более 12 корректировок по полу и возрасту для одной кампании или группы объявлений.

Не более 100 корректировок для целевой аудитории для одной кампании или группы объявлений.

Корректировки на мобильных нельзя создать для кампаний и групп объявлений для рекламы мобильных приложений.

Корректировки на компьютерах, планшетах, Smart TV можно создать для групп текстово-графических объявлений, динамических, медийных объявлений и для групп смарт-баннеров.

Корректировки для видеодополнений можно создать только для кампаний и групп текстово-графических объявлений.

Корректировки для смарт-объявлений можно создать только для кампаний и групп смарт-баннеров.

Корректировки на группу можно создать только для единых перфоманс групп.

Подробнее о соответствии типов корректировок типам кампаний и групп объявлений см. в разделе Соответствие типов корректировок типам кампаний и групп.

Структура запроса в формате JSON:

{
  "method": "add",
  "params": { /* params */
    "BidModifiers": [{  /* BidModifierAddItem */
      "MobileAdjustment": {  /* MobileAdjustmentAdd */
        "BidModifier": (int), /* required */
        "OperatingSystemType": ( "IOS" | "ANDROID" )
      },
      "TabletAdjustment": {  /* MobileAdjustmentAdd */
        "BidModifier": (int), /* required */
        "OperatingSystemType": ( "IOS" | "ANDROID" )
      },
      "DesktopAdjustment": {  /* DesktopAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "DesktopOnlyAdjustment": {  /* DesktopAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "DemographicsAdjustments": [{  /* DemographicsAdjustmentAdd */
        "Gender": ( "GENDER_MALE" | "GENDER_FEMALE" ),
        "Age": ( "AGE_0_17" | "AGE_18_24" | "AGE_25_34" | "AGE_35_44" | "AGE_45" | "AGE_45_54" | "AGE_55" ),
        "BidModifier": (int) /* required */
      }, ... ],
      "RetargetingAdjustments": [{  /* RetargetingAdjustmentAdd */
        "RetargetingConditionId": (long), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "RegionalAdjustments": [{    /* RegionalAdjustmentAdd */
        "RegionId": (long), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "VideoAdjustment": { /* VideoAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "SmartAdAdjustment" : { /* SmartAdAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "SerpLayoutAdjustments": [{  /* SerpLayoutAdjustmentAdd */
        "SerpLayout": ( "ALONE" | "SUGGEST" ), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "IncomeGradeAdjustments": [{  /* IncomeGradeAdjustmentAdd */
        "Grade": ( "VERY_HIGH" | "HIGH" | "ABOVE_AVERAGE" ), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "AdGroupAdjustment" : {
        "BidModifier" : (int) /* required */
      }
      "CampaignId": (long),
      "AdGroupId": (long)
    }, ... ] /* required */
  }
}

Структура ответа в формате JSON:

{
  "result": { /* result */
    "AddResults": [{  /* MultiIdsActionResult */
      "Ids": [(long), ... ],
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}

Пример запроса

{
  "method": "add",
  "params": {
    "BidModifiers": [
      { // 1. Две корректировки по полу и возрасту
        "CampaignId": 10001,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 101
          },
          {
            "Age": "AGE_45_54",
            "BidModifier": 140
          }
        ]
      },
      { // 2. Корректировки с пересекающимися срезами аудитории   
        "CampaignId": 10002,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 120
          },
          {
            "Age": "AGE_25_34",
            "BidModifier": 170
          }
        ]
      }, 
      { // 3. Недопустимое значение коэффициента
        "CampaignId": 10003,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 120
          },
          {
            "Gender": "GENDER_FEMALE",
            "Age": "AGE_35_44",
            "BidModifier": 10000
          }
        ]
      },
      { // 4. Корректировка для целевой аудитории на уровне группы объявлений
        "AdGroupId": 500001,
        "RetargetingAdjustments": [
          {
            "RetargetingConditionId": 2004,
            "BidModifier": 201
          }
        ]
      }
    ]
  }
}

Пример ответа

{
  "result" : {
    "AddResults" : [
      { // 1. Созданы две корректировки по полу и возрасту
        "Ids": [ 1003, 1004 ]
      },
      { // 2. Пересекающиеся срезы - ни одна корректировка не создана
        "Errors": [
          {
            "Code": 6000,
            "Message": "Неконсистентное состояние объекта",
            "Details": "Пересекаются условия корректировок в наборе"
          }
        ]
      },
      { // 3. Недопустимое значение - ни одна корректировка не создана
        "Errors": [
          {
            "Code": 5005,
            "Message": "Поле задано неверно",
            "Details": "Значение коэффициента не может быть больше 1300"
          }
        ]
      },
      { // 4. Создана корректировка для целевой аудитории на уровне группы объявлений
        "Ids": [ 1005 ]
      }
    ]
  }
}