Резервирование

Резервирование позволяет планировать и покупать кампании с фиксированной стоимостью, предлагает оптимизированный охват и контролируемую частоту показа рекламы, а также помогает прогнозировать результативность кампании. Аналогичный подход используется в телевизионной рекламе. Это специализированная расширенная возможность. Большинство рекламодателей используют ее, только если хотят получить надежную гарантию того, что их объявления охватят определенное количество аккаунтов из Центра аккаунтов.

Резервирование доступно для всех типов рекламы и устройств. Meta использует таргетинг на реальных людей, а не на файлы cookie, что позволяет точнее прогнозировать охват и управлять частотой показа.

Ограничения

  • Функция доступна не для всех рекламных аккаунтов. Проверьте параметр CAN_USE_REACH_AND_FREQUENCYрекламного аккаунта.
  • Значение параметра stop_time группы объявлений должно быть в пределах 180 дней от даты прогноза.
  • Для аккаунтов также действуют ограничения на уровне стран. Для проверки используйте запрос API GET к https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
  • Задавайте в target_spec по одной стране за раз.
  • Не указывайте в user_os минимальную версию iOS (например, iOS_ver_2.0_and_above).
  • При создании или обновлении кампании с резервированием нельзя задать срок действия или дневной бюджет, срок действия или ограничение количества показов за день, ограничение частоты или внешней ставки, а также значение поля PacingType.

Чтобы проверить действующие ограничения, выполните поиск с запросом rf_spec:

Имя Описание

countries

Массив

Поддерживаемые страны для резервирования

min_campaign_duration

Объект

Минимальная продолжительность кампании в днях (на каждую поддерживаемую страну).

max_campaign_duration

Объект

Максимальная продолжительность кампании в днях (на каждую поддерживаемую страну).

max_days_to_finish

Объект

Максимальный срок до завершения кампании в днях (на каждую поддерживаемую страну) на момент создания прогноза.

min_reach_limits

Объект

Минимальное количество охваченных аккаунтов (на каждую поддерживаемую страну).

Результаты будут выглядеть следующим образом:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Создание прогнозов

Прогнозы показывают, сколько аккаунтов ваша реклама может охватить в указанный диапазон дат, исходя из заданного охвата, частоты показа, размера аудитории и бюджета. Оценки резервирования помогут вам смоделировать результаты кампании за весь период ее существования и будут корректироваться в зависимости от цели, бюджета, аудитории, форматов и мест размещения, безопасности бренда, цели результативности и настроек управления частотой.

Редактировать кампании с резервированием можно после бронирования, однако после запуска кампанию будет нельзя редактировать или приостановить (за исключением замены рекламных креативов). Если вы редактируете только рекламный креатив, прогноз не изменится. Вы можете удалить кампанию, чтобы отменить и остановить ее, но при этом вам придется заново бронировать кампанию и вы можете получить новый CPM и прогноз по результатам кампании. Бронируйте только кампании, которые действительно собираетесь запускать **. При тестировании выбирайте минимальный размер и продолжительность. Не забывайте отменять зарезервированный рекламный ассортимент, так как это реальные ресурсы.

Ограничения

По умолчанию для прогнозов действуют следующие ограничения:

  • целевая аудитория — не менее 300 000 аккаунтов из Центра аккаунтов;
  • минимальный охват — 200 000 аккаунтов из Центра аккаунтов;
  • продолжительность показа рекламы — от 1 до 90 дней на каждую группу объявлений (учитывается, сколько суток действует кампания: например, если она начнется 1 декабря в 12:00, а закончится 2 декабря в 10:00, то будет считаться, что продолжительность этой кампании — 2 дня, хотя фактически прошло меньше 24 часов);
  • время окончания показа групп объявлений должно находиться в пределах 180 дней от прогноза;
  • кампания должна заканчиваться после 06:00 в последний день в часовом поясе рекламного аккаунта.

Просмотр прогнозов

Для получения подробной информации задайте поля. Чтобы посмотреть все прогнозы (reachfrequencyprediction) по аккаунту, отправьте запрос HTTP GET к https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

Чтобы получить все прогнозы reachfrequencyprediction по конкретному ID reachfrequencyprediction, используйте запрос HTTP GET с нужными полями: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

По умолчанию Meta возвращает ID. Подробнее о полях см. в этом разделе.

Коды статуса в ответах

Ниже приведены возможные результаты status в reachfrequencyprediction. Там, где это применимо, могут действовать исходные ограничения, однако в дальнейшем они могут варьироваться для разных стран или рекламных аккаунтов.

Код Статус Описание

1

SUCCESS

Прогноз создан.

2

PENDING

Прогноз ещё формируется.

3

FAIL

Невозможно охватить аудиторию. Слишком большой охват или бюджет.

4

FAIL

Недействительные настройки прогноза (например, продолжительность).

5

FAIL

Недействительный параметр targeting_spec.

6

FAIL

Бюджет или ставка слишком малы для заданного охвата.

7

FAIL

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

8

FAIL

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

9

FAIL

Дата окончания показа для группы объявлений слишком далеко в будущем.

10

FAIL

Не задано ограничение частоты.

11

FAIL

Недопустимое место размещения рекламы (например, одновременно в Ленте новостей и правом столбце).

12

FAIL

Проблемы с датами, заданными для групп объявлений (время начала или время окончания). Время начала в прошлом, не в полночь или показ выполняется неполный день. Время окончания в прошлом, превышает 90 дней со времени начала или не заканчивается после 6:00.

13

FAIL

Целевая страна пока не поддерживается.

14

FAIL

Даты, заданные для групп объявлений, содержат закрытые дни.

15

FAIL

Невозможно зарезервировать: недостаточно ассортимента. См. раздел "Резервирование прогноза".

16

FAIL

Не достигнут минимальный охват для аккаунта. См. раздел "Ограничения аккаунта".

17

FAIL

Фактический охват, доступный для этого прогноза, меньше минимального охвата для целевой страны (обычно это 200 000 человек).

18

FAIL

Задан недействительный почасовой график.

19

FAIL

Недостижимая цель по CPM.

20

FAIL

Слишком низкое ограничение частоты для смешанного показа.

21

FAIL

Невозможно дать точный прогноз из-за значительных изменений в рекламном ассортименте.

23

FAIL

Интервал, заданный для ограничения частоты, не поддерживается в целевой стране.

24

FAIL

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

25

FAIL

Продолжительность ограничения частоты не может превышать продолжительность кампании.

26

FAILURE_EMPTY_AUDIENCE

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

27

FAIL

В запущенную кампанию нельзя вносить изменения.

28

FAIL

В запущенную кампанию, созданную с помощью заказа на размещение рекламы, нельзя вносить изменения.

29

FAIL

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

30

FAIL

Чтобы изменить запущенную группу объявлений с резервированием, выберите бюджет, превышающий текущие затраты.

31

FAIL

Исследование прироста на уровне аккаунта или группы кампаний начинается после запуска кампании.

32

FAIL

Исследование прироста на уровне аккаунта или группы кампаний заканчивается до завершения кампании.

35

FAIL

Время начала кампании "Резервирование" не может быть в прошлом.

36

FAIL

Убедитесь, что длительность группы объявлений кампании "Резервирование" превышает один день и что время ее начала и завершения указаны верно.

37

FAIL

Эта цель не поддерживается в Audience Network с типом закупки "Резервирование".

39

FAIL

Выбранную комбинацию мест размещения нельзя использовать с типом закупки "Резервирование".

40

FAIL

С типом закупки "Резервирование" таргетинг на некоторые версии мобильных ОС невозможен.

41

FAIL

С типом закупки "Резервирование" таргетинг на друзей вовлеченных пользователей невозможен.

42

FAIL

Запуск кампаний "Резервирование" невозможен, если выбрано единственное место размещения Audience Network. Выберите место размещения Audience Network и задайте в качестве дополнительных мест размещения Ленту Facebook или Ленту Instagram.

44

FAIL

Резервирование не поддерживает истории на Facebook.

45

FAIL

Чтобы использовать в качестве места размещения истории на Facebook, выберите дополнительно Ленту Facebook или истории в Instagram.

50

FAIL

Выбранную комбинацию мест размещения нельзя использовать с типом закупки "Резервирование". Для типа закупки "Резервирование IO" убедитесь, что выбрана цель "Просмотры видео". В противном случае, чтобы использовать видеообъявления In-Stream на Facebook, выберите место размещения "Ленты Facebook".

53

FAIL

Место размещения "Видеообъявления In-Stream" доступно только для аудиторий в США, Великобритании, Австралии, Новой Зеландии, Ирландии, Таиланде, Мексике, Перу, Франции, Германии, Аргентине, Колумбии, Испании, Чили, Эквадоре, Доминиканской Республике, Гватемале, Боливии, Гондурасе, Сальвадоре, Норвегии, Швеции, Нидерландах, Бельгии, Польше, Португалии, Дании, Индии, Малайзии, на Филиппинах, в Индонезии и Вьетнаме. Чтобы продолжить, проверьте свою аудиторию. В ней должны быть люди только из этих стран.

60

FAIL

Чтобы использовать Facebook Marketplace, выберите место размещения "Ленты Facebook".

66

FAIL

Место размещения "Правый столбец на Facebook" нельзя использовать совместно с другими местами размещения.

69

FAIL

Если вы хотите, чтобы ваша реклама отображалась в разделе "Интересное" в Instagram, выберите также место размещения "Лента Instagram".

100+

FATAL

Системный сбой. Повторите попытку.

Использование прогнозов

Укажите ID и данные прогноза. На их основании будет создан ID резервирования. Добавьте его в группу объявлений. При резервировании ассортимент становится недоступен другим пользователям, поэтому его нужно прикрепить до истечения его срока действия.

Если операция пройдет успешно, ассортимент будет временно зарезервирован для вас. После резервирования у вас будет примерно час на то, чтобы назначить объявление группе объявлений.

Если часовое ограничение для запросов резервирования будет превышено, вы увидите сообщение об ошибке 613: Calls to this API have exceeded the rate limit (613. Количество вызовов этого API превышает установленное ограничение числа обращений).

Резервирование

Можно резервировать прогнозы для групп объявлений, чтобы зафиксировать цену и получить предсказуемый охват. Чтобы зарезервировать аудиторию, определенную в reachfrequencyprediction, на определенное время, укажите в поле action действие reserve. Один ID прогноза можно использовать для нескольких резервирования. Пример:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Чтобы зарезервировать ассортимент на основании прогноза, отправьте запрос API POST к https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

Для полей reach, budget и impression можно зарезервировать прогноз для конкретной точки на кривой бюджета и охвата curve_budget_reach, а не исходного кортежа охвата и бюджета. Используйте следующие поля:

Имя Описание

rf_prediction_id

Целое число

Обязательный параметр.

ID reachfrequencyprediction

action

Строка

Обязательный параметр для резервирования и отмены.

Возможные значения:

  • reserve — резервирует ассортимент на основе предыдущего прогноза;
  • cancel — отменяет зарезервированный прогноз.

rf_prediction_id_to_release

Целое число

Необязательный параметр.

ID резервирования или зарезервированного прогноза. Для новых резервирований высвобождается и используется аудитория, зарезервированная ранее. См. раздел Повторное использование зарезервированных аудиторий.

rf_prediction_id_to_share

Целое число

Необязательный параметр.

ID ранее созданного прогноза. Для новых прогнозов используется аудитория из этого прогноза.


Примечание. Для параметра rf_prediction_id_to_share должен быть задан действительный ID прогноза для использования с целью TRAFFIC или вариантами оптимизации POST_ENGAGEMENT и LINK_CLICKS. Дополнительные сведения см. в журнале изменений.

reach

Целое число

Необязательный параметр. Если это поле задано, необходимо указать budget и impression.

Задайте reach, budget и impression для нужной точки на кривой бюджета и охвата curve_budget_reach. Это значение можно переопределить.

budget

Целое число

Необязательный параметр. Если это поле задано, необходимо указать reach и impression.

Задайте reach, budget и impression для нужной точки на кривой бюджета и охвата curve_budget_reach. Это значение можно переопределить.

impression

Целое число

Необязательный параметр. Если это поле задано, необходимо указать reach и budget.

Это значение можно переопределить. Для этого задайте reach, budget и impression для нужной точки на кривой бюджета и охвата curve_budget_reach.

Meta резервирует прогнозы в асинхронном режиме, поэтому вам нужно проверять статус прогноза с помощью опроса. Исходный статус прогноза — 2 (PENDING), т. е. "Ожидается". Когда прогноз будет сформирован, его статус изменится на 1 (SUCCESS, "Успех") или 15 (FAIL, "Ошибка"). Последнее бывает, когда для резервирования не хватает ассортимента.

Система резервирования работает динамически, поэтому в период между прогнозом и резервированием могут наблюдаться незначительные изменения в данных о доступности ассортимента. Однако если эти изменения находятся в разумных пределах, Meta придерживается значений прогноза.

Назначение группам объявлений

После успешного резервирования прогноза вы можете создать с ним группу объявлений:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Чтобы группе объявлений можно было назначить прогноз, она должна отвечать следующим критериям:

  • не указывайте:
  • start_time — извлекается из прогноза;
  • end_time — извлекается из прогноза;
  • targeting — извлекается из прогноза;
  • bid_amount;
  • optimization_goal;
  • lifetime_budget или daily_budget;
  • резервирования можно назначать группам объявлений без активных объявлений, однако перед началом показа рекламы в группе уже должно быть как минимум одно активное объявление;
  • чтобы прикрепить прогноз к новой группе объявлений, нужно задать его rf_prediction_id;
  • для атрибута buying_type рекламной кампании следует указать значение RESERVED.

Вы также можете прикреплять к группам объявлений reachfrequencyprediction, чтобы менять прогноз для них. Отправьте запрос POST к https://graph.facebook.com/{ad_set_id} и укажите rf_prediction_id для прогноза reachfrequencyprediction, который нужно использовать.

Для групп объявлений действуют следующие ограничения:

  • Допустимые издательские платформы: facebook, instagram.
  • Допустимые места размещения на Facebook: feed и rightcolumn.
  • Допустимые места размещения в Instagram: stream, story, explore, explore_home и reels. Если используются места размещения в instagram, укажите destination_ids, а не destination_id. Поле destination_ids должно содержать ID аккаунта Instagram и ID Страницы Facebook, используемый в качестве destination_id.
  • Можно применять пользовательскую аудиторию либо партнерские категории, но не оба варианта одновременно.
  • Не разрешается применять пользовательские аудитории с сайта, а также таргетинг с исключением поклонников и людей, взаимодействовавших с видео.
  • promoted_object в группе объявлений и destination_id в прогнозе должны совпадать. Для публикаций страниц это должен быть ID страницы, а для рекламы приложений — ID приложения.
  • Стандартный и плановый показ рекламы поддерживаются, а ускоренный — нет.

Средства за кампании с резервированием списываются согласно выполненным показам. Если на момент начала кампании в группе объявлений нет активной рекламы, кампания не запускается и средства не списываются. Сначала Meta просто высвободит остаток ассортимента, но если подобная ситуация будет повторяться, мы можем оштрафовать рекламный аккаунт.

При создании кампании с резервированием вы соглашаетесь платить предлагаемую цену за резервируемый рекламный ассортимент. Если вы захотите изменить размер аудитории или частоту показа объявлений, ваши расходы тоже изменятся. Правки нужно вносить до запуска кампании. В этот период также можно отредактировать рекламный креатив.

Управление рекламой

Группы объявлений с резервированием могут содержать по несколько объявлений. Новые объявления в такие группы можно добавлять в любой момент. Если на момент начала показа в группе объявлений не будет активных объявлений, вы должны создать первое объявление в течение 24 часов для групп объявлений продолжительностью от 3 до 30 дней и в течение 6 часов для групп объявлений продолжительностью от 1 до 2 дней. В противном случае резервирование будет удалено.

Отключение прогнозов и изменение групп объявлений

Кампанию с резервированием можно отредактировать или приостановить до ее начала. После запуска кампании можно только отредактировать рекламный креатив, изменить бюджет или перенести дату завершения. Если вы редактируете только рекламный креатив, прогноз не изменится.

Если вы измените бюджет или дату завершения, для кампании может быть сгенерирован новый прогноз. Он будет отражен в оценке резервирования.

Активную кампанию с резервированием нельзя приостановить. Чтобы отменить кампанию, удалите ее.

Узнайте, как приостановить или перезапустить, а также отредактировать активную группу объявлений. Вы также можете ее удалить. За выполненные показы будут списаны средства.

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

Если вы назначите резервирование группе объявлений до начала показа рекламы, то для изменения большинства атрибутов его придется отключить. Для этого отправьте группе запрос HTTP POST и задайте для rf_prediction_id значение 0. В объекте группы объявлений можно редактировать только атрибут name.

Вот как отключить резервирование:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

После запуска группы объявлений отключить резервирование и изменить ее атрибуты невозможно. Исключение составляют некоторые атрибуты объявлений:

  • name;
  • creative_id;
  • creative_spec;
  • conversion_specs;
  • tracking_specs;
  • view_tags.

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

Вы можете приостановить активную группу объявлений. Но если приостановка продлится более 30 минут, мы не сможем гарантировать точность прогноза для этой группы.

Чтобы повторно активировать группу объявлений, приостановленную более чем на 30 минут, понадобится новый прогноз. Отправьте запрос POST к reachfrequencypredictions. См. разделы о создании и резервировании прогнозов. В запросе нужно передать existing_campaign_id для группы объявлений, которую требуется активировать повторно. Создав и зарезервировав новый прогноз, прикрепите к группе объявлений reachfrequencyprediction. Для этого отправьте к https://graph.facebook.com/{ad_set_id} запрос HTTP POST и укажите rf_prediction_id нужного прогноза.

Редактирование активных групп объявлений

После начала показа рекламы в группу объявлений можно вносить следующие изменения:

  • Увеличивать или уменьшать бюджет и охват. Новое значение должно быть больше текущих фактических затрат или охвата соответственно.
  • Продлевать показ объявлений до 90 дней.

Нельзя редактировать и приостанавливать активные группы объявлений, отвечающие хотя бы одному из следующих критериев:

  • Показов очень мало (менее 10 % от прогноза). Затраты превышают бюджет.
  • Реклама показывается только сутки.
  • Показ заканчивается в ближайшие 24 часа.

Чтобы отредактировать активную группу объявлений, создайте новый прогноз. См. разделы, посвященные созданию и резервированию прогнозов. Передайте в запросе existing_campaign_id для группы объявлений, которую нужно активировать повторно.

Создав и зарезервировав новый прогноз, прикрепите к группе объявлений reachfrequencyprediction. Для этого отправьте к https://graph.facebook.com/{ad_set_id} HTTP-запрос POST и укажите rf_prediction_id нужного прогноза reachfrequencyprediction.

Повторное использование зарезервированных аудиторий

Если отменить резервирование, соответствующий ассортимент станет доступен другим рекламодателям. Однако если вы ещё не используете аудиторию из ранее зарезервированного прогноза, то можете добавить ее в другой прогноз. Так вам не придется отменять существующее резервирование, а мы сможем учесть в новом прогнозе дополнительный ассортимент.

При создании резервирования укажите rf_prediction_id_to_share. Это ID предыдущего прогноза. После этого старое резервирование станет недействительным, и вы сможете использовать связанный с ним ассортимент для нового резервирования.

Чтобы зарезервировать новый прогноз, передайте в запросе дополнительный параметр rf_prediction_id_to_release. Это ID предыдущего резервирования.

Ротация рекламы и последовательный показ

В группе объявлений можно активировать ротацию рекламы. Для этого не требуется отключать резервирование для группы. Добавьте в группу объявления и дождитесь ее активации. После этого вы сможете изменить статус исходного объявления на "Приостановлено". В группе объявлений должно быть хотя бы одно активное объявление.

Вы можете выбрать, в какой последовательности нужно показывать объявления. Сначала создайте группу и отдельные объявления. Затем задайте последовательность на уровне группы объявлений в поле creative_sequence. Отдельные объявления могут повторяться в этой последовательности по несколько раз, появляться в ней только однажды или вообще в нее не входить.

Если длина массива creative_sequence равна нулю, это означает, что последовательный показ не используется. А если у нее другое значение, рекомендуем сделать его равным frequency_cap в rf_prediction_id. Если длина превышает frequency_cap, система не показывает последние объявления в массиве. Если же длина меньше frequency_cap, система рекурсивно заполняет массив, повторяя последовательность сначала. Поэтому для оптимальных результатов длина creative_sequence должна равняться frequency_cap.

Каждое объявление в последовательности может иметь статус ACTIVE, PENDING_REVIEW или CREDIT_CARD_NEEDED. Объявления отображаются строго по порядку, только после показа всех предыдущих объявлений из последовательности. Объявления, не входящие в creative_sequence, не показываются.

Если в группе включен последовательный показ, то входящие в нее объявления нельзя ни приостановить, ни архивировать, ни удалить, даже если они не входят в последовательность.

Эта функция доступна только для групп объявлений с резервированием. Это значит, что поле buying_type в конфигурации родительской кампании должно иметь значение RESERVED, а для группы объявлений должен быть задан rf_prediction_id.

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

Резервирование в Instagram

Для прогнозируемого охвата в Instagram создайте кампанию с резервированием и задайте для параметра buying_type значение RESERVED.

Резервирование помогает планировать и бронировать кампании по повышению узнаваемости и вовлеченности, оптимизируя охват, прирост запоминаемости рекламы и ThruPlay.

Оценить ожидания партнеры могут с помощью прогнозов охвата в Ads Manager и с использованием API. Интересы сообщества Instagram для нас в приоритете. Мы применяем консервативный подход к достижению целей по охвату и планируем постепенное развитие. В Instagram действуют те же политики в отношении оценки резервирования, что и на Facebook.

Коды ошибок

Код Описание

1487583

Если в группе объявлений отсутствуют объявления, ей нельзя назначить прогноз резервирования.

1487055

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

1487600

Группа объявлений уже связана с резервированием. Чтобы использовать другой прогноз, сначала отключите текущий, задав в соответствующем поле значение null. После этого можно назначить новый прогноз.

1487578

Указанный ID reachandfrequencyprediction не существует или не принадлежит данному аккаунту.

1487581

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

1487594

В группе объявлений с резервированием отсутствуют объявления.

1487595

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

1487614

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

1487615

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

1487616

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

1487671

Группу объявлений нельзя напрямую переключить с одного прогноза на другой.

1487244

Ошибка редактирования группы объявлений. Причина указывается в ответе.

1487672

Не удалось назначить прогноз группе объявлений.

1487680

У вас нет разрешения на использование групп объявлений с резервированием.

Примеры

Вот как создать reachfrequencyprediction для destination_id приложения:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Вот как создать reachfrequencyprediction для destination_id страницы:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Вот как создать reachfrequencyprediction для destination_id приложения с местом размещения в Instagram:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Отправляйте запросы HTTP GET к следующей конечной точке, пока не получите статус, отличный от 2:

https://graph.facebook.com/67890123456?fields=status

Если получен статус 1 (успех), прогноз можно прикрепить к группе объявлений или зарезервировать.

Вот как зарезервировать прогноз:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Отправляйте на следующую конечную точку HTTP-запросы GET, пока не получите статус, отличный от 2:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Если получен статус 1 (успех), прогноз можно прикрепить к группе объявлений. Настроим структуру кампании. Для этого нужно создать кампанию, группу объявлений, креатив и объявление, а затем назначить резервирование группе объявлений.

Создайте рекламную кампанию:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Создайте группу объявлений:

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Сгенерируйте рекламный креатив:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Создайте объявление:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Назначьте новый прогноз группе объявлений:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"