update: параметры MobileAppCampaign

Внимание. Все денежные параметры кампаний (дневной бюджет, недельный бюджет, средняя цена для автоматических стратегий) передаются через API Директа в виде целых чисел. Передаваемое значение представляет собой денежное значение в валюте рекламодателя, умноженное на 1 000 000.

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

{
  "method": "update",
  "params": {
    "Campaigns": [{  /* CampaignUpdateItem */
      ...
      "MobileAppCampaign": {  /* MobileAppCampaignUpdateItem */
        "BiddingStrategy": {  /* MobileAppCampaignStrategy */
          "Search": {  /* MobileAppCampaignSearchStrategy */
            "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */
            "WbMaximumClicks": {  /* StrategyMaximumClicks */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "WbMaximumAppInstalls": {  /* StrategyMaximumAppInstalls */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "AverageCpc": {  /* StrategyAverageCpc */
              "AverageCpc": (long),
              "WeeklySpendLimit": (long) /* nillable */
            },
            "AverageCpi": {  /* StrategyAverageCpi */
              "AverageCpi": (long),
              "WeeklySpendLimit": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackage */
              "ClicksPerWeek": (long),
              "AverageCpc": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            }
          }, 
          "Network": {  /* MobileAppCampaignNetworkStrategy */
            "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */
            "NetworkDefault": {  /* StrategyNetworkDefault */
              "LimitPercent": (int),
              "BidPercent": (int)
            },
            "WbMaximumClicks": {  /* StrategyMaximumClicks */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "WbMaximumAppInstalls": {  /* StrategyMaximumAppInstalls */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "AverageCpc": {  /* StrategyAverageCpc */
              "AverageCpc": (long),
              "WeeklySpendLimit": (long) /* nillable */
            },
            "AverageCpi": {  /* StrategyAverageCpi */
              "AverageCpi": (long),
              "WeeklySpendLimit": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackage */
              "ClicksPerWeek": (long),
              "AverageCpc": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            }
          } 
        },
        "Settings": [{  /* MobileAppCampaignSetting */
          "Option": ( "ADD_TO_FAVORITES" | ... | "REQUIRE_SERVICING" ), /* required */
          "Value": ( "YES" | "NO" ) /* required */
        }, ... ]
      }
    }, ....] /* required */
  }
}
Параметр Тип Описание Обязательный
Структура MobileAppCampaignUpdateItem
Settings array of MobileAppCampaignSetting Массив настроек, допускающих только значения YES или NO. Нет
BiddingStrategy MobileAppCampaignStrategy Стратегия показа. Нет
Структура MobileAppCampaignSetting
Option MobileAppCampaignSettingsEnum

Имя настройки:

Да
Value YesNoEnum Значение настройки. Да
Структура MobileAppCampaignStrategy
Network MobileAppCampaignNetworkStrategy Стратегия показа в сетях. Нет
Структура MobileAppCampaignSearchStrategy
BiddingStrategyType MobileAppCampaignSearchStrategyTypeEnum

Тип стратегии показа на поиске:

О совместимости стратегий на поиске и в сетях см. в разделе Стратегии показа.

Да
WbMaximumClicks StrategyMaximumClicks Параметры стратегии Недельный бюджет (максимум кликов). При значении WB_MAXIMUM_CLICKS в параметре BiddingStrategyType
WbMaximumAppInstalls StrategyMaximumAppInstalls Параметры стратегии Недельный бюджет (максимальное количество установок). При значении WB_MAXIMUM_APP_INSTALLS в параметре BiddingStrategyType
AverageCpc StrategyAverageCpc Параметры стратегии Средняя цена клика. При значении AVERAGE_CPC в параметре BiddingStrategyType
WeeklyClickPackage StrategyWeeklyClickPackage Параметры стратегии Недельный пакет кликов. При значении WEEKLY_CLICK_PACKAGE в параметре BiddingStrategyType
AverageCpi StrategyAverageCpi Параметры стратегии Средняя цена установки приложения. При значении AVERAGE_CPI в параметре BiddingStrategyType
Структура MobileAppCampaignNetworkStrategy
BiddingStrategyType MobileAppCampaignNetworkStrategyTypeEnum

Тип стратегии показа в сетях:

О совместимости стратегий на поиске и в сетях см. в разделе Стратегии показа

Да
NetworkDefault StrategyNetworkDefault

Настройки показов в сетях в зависимости от настроек на поиске.

Если выбрана стратегия на поиске AVERAGE_CPI или WB_MAXIMUM_APP_INSTALLS, передайте пустую структуру.

При значении NETWORK_DEFAULT в параметре BiddingStrategyType
WbMaximumClicks StrategyMaximumClicks Параметры стратегии Недельный бюджет (максимум кликов). При значении WB_MAXIMUM_CLICKS в параметре BiddingStrategyType
WbMaximumAppInstalls StrategyMaximumAppInstalls Параметры стратегии Недельный бюджет (максимальное количество установок). При значении WB_MAXIMUM_APP_INSTALLS в параметре BiddingStrategyType
AverageCpc StrategyAverageCpc Параметры стратегии Средняя цена клика. При значении AVERAGE_CPC в параметре BiddingStrategyType
WeeklyClickPackage StrategyWeeklyClickPackage Параметры стратегии Недельный пакет кликов. При значении WEEKLY_CLICK_PACKAGE в параметре BiddingStrategyType
AverageCpi StrategyAverageCpi Параметры стратегии Средняя цена установки приложения. При значении AVERAGE_CPI в параметре BiddingStrategyType
Структура StrategyMaximumClicks
WeeklySpendLimit long

Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000.

Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Нет
BidCeiling long, nillable

Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000.

Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии.
Нет
Структура StrategyMaximumAppInstalls
WeeklySpendLimit long

Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000.

Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Нет
BidCeiling long, nillable

Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000.

Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии.
Нет
Структура StrategyAverageCpc
AverageCpc long

Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000.

Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Нет
WeeklySpendLimit long, nillable

Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000.

Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Нет
Структура StrategyAverageCpi
AverageCpi long

Средняя цена установки приложения в валюте рекламодателя, умноженная на 1 000 000.

Минимальное допустимое значение представлено в разделе Валютные параметры и ограничения.

Нет
WeeklySpendLimit long, nillable

Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000.

Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Нет
BidCeiling long, nillable

Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000.

Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии.
Нет
Структура StrategyWeeklyClickPackage
ClicksPerWeek long Требуемое количество кликов в неделю. Нет
AverageCpc long, nillable

Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000.

Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Примечание. Параметры AverageCpc и BidCeiling являются взаимоисключающими. Если ранее был задан параметр BidCeiling, то, чтобы задать AverageCpc, нужно одновременно передать null (nil) для BidCeiling.
Нет
BidCeiling long, nillable

Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000.

Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Примечание. Параметры AverageCpc и BidCeiling являются взаимоисключающими. Если ранее был задан параметр AverageCpc, то, чтобы задать BidCeiling, нужно одновременно передать null (nil) для AverageCpc.
Нет
Структура StrategyNetworkDefault
LimitPercent int

Максимальный процент бюджета, расходуемый на показы в сетях. Значение кратно десяти: 10, 20, ..., 100. Значение по умолчанию — 100.

Если выбрана стратегия на поиске AVERAGE_CPI или WB_MAXIMUM_APP_INSTALLS, параметр не используется, переданное значение игнорируется.

Нет
BidPercent int

Ограничение ставки в сетях. Задается в процентах от ставки на поиске. Значение кратно десяти: 10, 20, ..., 100. Значение 100 делает ставку в сетях равной цене на поиске. Значение по умолчанию — 100.

Если выбрана стратегия на поиске AVERAGE_CPI или WB_MAXIMUM_APP_INSTALLS, параметр не используется, переданное значение игнорируется.

Нет