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

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

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

{
  "method": "add",
  "params": {
    "Campaigns": [{  /* CampaignAddItem */
      ...  
      "MobileAppCampaign": {  /* MobileAppCampaignAddItem */
        "BiddingStrategy": {  /* MobileAppCampaignStrategyAdd */
          "Search": {  /* MobileAppCampaignSearchStrategyAdd */
            "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */
            "WbMaximumClicks": {  /* StrategyMaximumClicksAdd */
              "WeeklySpendLimit": (long), /* required */
              "BidCeiling": (long)
            },
            "WbMaximumAppInstalls": {  /* StrategyMaximumAppInstallsAdd */
              "WeeklySpendLimit": (long), /* required */
              "BidCeiling": (long)
            },
            "AverageCpc": {  /* StrategyAverageCpcAdd */
              "AverageCpc": (long), /* required */
              "WeeklySpendLimit": (long)
            },
            "AverageCpi": {  /* StrategyAverageCpiAdd */
              "AverageCpi": (long), /* required */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long)
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackageAdd */
              "ClicksPerWeek": (long), /* required */
              "AverageCpc": (long),
              "BidCeiling": (long)
            }
          }, /* required */
          "Network": {  /* MobileAppCampaignNetworkStrategyAdd */
            "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */
            "NetworkDefault": {  /* StrategyNetworkDefaultAdd */
              "LimitPercent": (int),
              "BidPercent": (int)
            },
            "WbMaximumClicks": {  /* StrategyMaximumClicksAdd */
              "WeeklySpendLimit": (long), /* required */
              "BidCeiling": (long)
            },
            "WbMaximumAppInstalls": {  /* StrategyMaximumAppInstallsAdd */
              "WeeklySpendLimit": (long), /* required */
              "BidCeiling": (long)
            },
            "AverageCpc": {  /* StrategyAverageCpcAdd */
              "AverageCpc": (long), /* required */
              "WeeklySpendLimit": (long)
            },
            "AverageCpi": {  /* StrategyAverageCpiAdd */
              "AverageCpi": (long), /* required */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long)
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackageAdd */
              "ClicksPerWeek": (long), /* required */
              "AverageCpc": (long),
              "BidCeiling": (long)
            }
          } /* required */
        }, /* required */
        "Settings": [{  /* MobileAppCampaignSetting */
          "Option": ( "ADD_TO_FAVORITES" | ... | "REQUIRE_SERVICING" ), /* required */
          "Value": ( "YES" | "NO" ) /* required */
        }, ... ],
      }
    }, ...] /* required */
  }
}
Параметр Тип Описание Обязательный
Структура MobileAppCampaignAddItem
Settings array of MobileAppCampaignSetting Массив настроек, допускающих только значения YES или NO. Нет
BiddingStrategy MobileAppCampaignStrategyAdd Стратегия показа. Да
Структура MobileAppCampaignSetting
Option MobileAppCampaignSettingsEnum

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

Да
Value YesNoEnum Значение настройки. Да
Структура MobileAppCampaignStrategyAdd
Network MobileAppCampaignNetworkStrategyAdd Стратегия показа в сетях. Да
Структура MobileAppCampaignSearchStrategyAdd
BiddingStrategyType MobileAppCampaignSearchStrategyTypeEnum

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

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

Да
WbMaximumClicks StrategyMaximumClicksAdd Параметры стратегии Недельный бюджет (максимум кликов). При значении WB_MAXIMUM_CLICKS в параметре BiddingStrategyType
WbMaximumAppInstalls StrategyMaximumAppInstallsAdd Параметры стратегии Недельный бюджет (максимальное количество установок). При значении WB_MAXIMUM_APP_INSTALLS в параметре BiddingStrategyType
AverageCpc StrategyAverageCpcAdd Параметры стратегии Средняя цена клика. При значении AVERAGE_CPC в параметре BiddingStrategyType
AverageCpi StrategyAverageCpiAdd Параметры стратегии Средняя цена установки приложения. При значении AVERAGE_CPI в параметре BiddingStrategyType
WeeklyClickPackage StrategyWeeklyClickPackageAdd Параметры стратегии Недельный пакет кликов. При значении WEEKLY_CLICK_PACKAGE в параметре BiddingStrategyType
Структура MobileAppCampaignNetworkStrategyAdd
BiddingStrategyType MobileAppCampaignNetworkStrategyTypeEnum

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

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

Да
NetworkDefault StrategyNetworkDefaultAdd

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

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

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

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

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

Да
BidCeiling long

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

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

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

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

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

Да
BidCeiling long

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

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

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

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

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

Да
WeeklySpendLimit long

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

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

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

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

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

Да
WeeklySpendLimit long

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

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

Нет
BidCeiling long

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

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

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

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

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

Примечание. Параметры AverageCpc и BidCeiling являются взаимоисключающими: нельзя указывать оба.
Нет
BidCeiling long

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

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

Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии.
Нет
Структура StrategyNetworkDefaultAdd
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, параметр не используется, переданное значение игнорируется.

Нет