Версия 3.0

API Marketing

Выпуск: 1 мая 2018 г. | Доступно до: 1 февраля 2019 г. | Запись в блоге

• Новые функции
• Важные изменения
• Упраздненные элементы
• Элементы, упраздняемые в ближайшее время

Новые функции

Стратегия назначения ставок с минимальной стоимостью, поле bid_strategy

Мы ввели новое поле bid_strategy для {account-id}/adsets. Оно позволяет выбрать стратегию назначения ставок для рекламы в зависимости от бизнес-целей. У каждой стратегии есть свои преимущества и недостатки. Ниже перечислены возможные параметры.

• LOWEST_COST: позволяет получить максимальное количество результатов согласно бюджету группы объявлений и цели показа optimization_goal. Facebook автоматически продолжит назначать ставки, чтобы потратить заданный бюджет. Этот параметр позволяет установить максимальное значение для ставки или снять ограничение для нее.

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

Подробнее см. в справке по ставкам и оптимизации рекламы.

Создание рекламы с подборкой

Новый API для создания рекламы с подборкой. Ранее при каждом создании такой рекламы Facebook создавал холст в фоновом режиме. Доступ к такой рекламе был ограничен — вы не могли использовать ее для ретаргетинга аудиторий, которые взаимодействовали с холстом. Теперь при создании рекламы с подборкой из групп товаров нужно явным образом создать холст с правильными элементами. Чтобы Facebook автоматически сгенерировал рекламу с подборкой, примените в ней этот холст. Подробнее см. в разделе Реклама с подборкой из группы продуктов.

Важные изменения

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

• Недействительная реклама в правом столбце. Мы признаем недействительными объявления, размещаемые только в позиции right_hand_column, если в {ad_account_id}/adsets для right_hand_column указаны недействительные цели. Теперь в правом столбце можно размещать рекламу в поддерживаемых форматах только со следующими целями: "Трафик", "Конверсии" и "Продажи по каталогу товаров".

• Начиная с версии 3.0 is_autobid и is_average_price_pacing упразднены для GET и POST.

Аудитории и таргетинг рекламы

• Изменения синтаксиса правил для пользовательских аудиторий. Мы обновили структуру правил, используемых для создания пользовательских аудиторий с сайта, из мобильного приложения, пользовательских аудиторий на основе вовлеченности для Страницы, аудиторий для вовлеченности, связанных с рекламой для лидов, аудиторий вовлеченности для холста и пользовательских аудиторий в офлайне. Теперь вы можете создавать правила на основе общего поведения и правила для разных источников событий, а также исключать правила. См.:

  • правила для пользовательских аудиторий с сайта;

  • правила для пользовательских аудиторий из мобильного приложения;

  • правила для пользовательских аудиторий на основе вовлеченности для Страницы;

  • правила для аудиторий для вовлеченности, связанных с рекламой для лидов;

  • правила для аудиторий вовлеченности для холста;

  • правила для пользовательских аудиторий в офлайне.

Динамическая реклама

• Доступ к каталогу продуктов. Чтобы получить доступ к каталогу продуктов, необходимо указать правильную отрасль каталога. Если в запросе указана неправильная отрасль, вы получите ошибку. Например, к каталогу для электронной коммерции следует обращаться через соответствующую конечную точку /products, например GET {catalog_id}/products, GET {product_feed_id}/products или GET {product_set_id}/products. У вас не получится обратиться к нему через конечные точки для других отраслей, например GET {catalog_id}/autos, GET {product_feed_id}/hotels или GET {product_set_id}/flights.

• Пустые строки в тегах шаблона. В качестве параметров для тегов шаблона динамической рекламы больше не разрешается использовать пустые строки. Например, если вы попытаетесь передать пустую строку в {{trip.checkin_date date_format:}}, вы получите ошибку. См. раздел Управление рекламой.

Статистика рекламы и измерения

• Время ожидания для API Insights. Если, по нашим расчетам, запрос к API Insights превысит время ожидания, возвращается ошибка с кодом 100 и подкодом 1504033. Это решение принимается на основе размера запроса и скорости обработки по отношению к максимальному времени ожидания. Если вы получили такую ошибку, выполните асинхронный запрос к API Insights для получения этих данных. См. раздел Асинхронные задания API Insights.

• Отрицательные значения в данных событий. Если вы отправляете в {data_set_id}/events данные события с отрицательным значением, запрос завершается неудачно. Это затрагивает поле data для POST /{data_set_id-id}/events.

• Статистика по оптимизации бюджета кампании. Теперь adset_budget_value возвращает using campaign budget, если в кампании используется оптимизация бюджета. Это затрагивает следующие запросы:

  • GET {adaccount-id}/insights

  • GET {campaign-id}/insights

  • GET {adset-id}/insights

  • GET {ad-id}/insights

  • POST {adaccount-id}/insights

  • POST {campaign-id}/insights

  • POST {adset-id}/insights

  • POST {ad-id}/insights

• Сортировка по умолчанию для пикселя. Если вызвать границу контекста GET {account_id}/adspixel для бизнес-аккаунта или рекламного аккаунта, полученные результаты будут по умолчанию отсортированы по имени пикселя, а не по последнему времени активации пикселя.

• Переименование поля статистики пикселя. Поле timestamp границы контекста статистики пикселя переименовано в start_time. Теперь оно представляет время начала сбора почасовых данных об активации пикселя. Значение возвращается в формате ISO 8601 и включает сдвиг часового пояса. Таким образом устранена проблема с возвратом неправильных меток времени Unix. Это изменение затрагивает конечную точку GET {ads-pixel-id}/stats.

Упраздненные элементы

Business Manager

Упразднена конечная точка POST {pixel-id}/shared_agencies. Чтобы поделиться рекламным пикселем с агентством, используйте Business Manager.

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

• Упразднены поля kpi_custom_conversion_id, kpi_type и kpi_results для /{ad_campaign_id} и /ad_account_ID/campaigns.

• В целях упрощения API упразднен флаг redownload для следующих конечных точек:

  • POST {ad-id}/

  • POST {adset-id}/

  • POST act_{ad-account-id}

  • POST act_{ad-account-id}/ads

  • POST act_{ad-account-id}/adsets

  Эту информацию по-прежнему можно считать с помощью параметра fields.

• Упразднено поле zipbytes границы контекста POST act_{ad-account-id}/adimages. Для этой границы больше не возможно загружать ZIP-файлы. Используйте изображения со следующими расширениями: jpg, jpeg, gif, bmp, png, tiff или tif.

• Упразднен текущий метод создания рекламы с подборкой: один вызов API с указанием всех необходимых объектов в качестве параметров. Теперь нужно сначала создать холст, а затем использовать ссылку на него, чтобы создать рекламу с подборкой. Таким образом вы сможете работать с объектом холста, что позволяет, например, ретаргетировать аудитории. См. раздел Реклама с подборкой.

• Формат с кольцевой галереей больше не используется для рекламы с целью "Вовлеченность для публикации Страницы". Это сочетание больше не доступно. См. раздел Цели и креативы.

Ставки и покупка рекламы

• Упразднены поля is_autobid и is_average_price_pacing для конечных точек POST {ad-account-id}/adsets и POST {adset-id}. Вместо них следует использовать новое поле bid_strategy, чтобы указать стратегию назначения ставок для группы объявлений. Подробнее см. в разделе Ставки и оптимизация.

• Упразднены поля delivery_estimate для объявлений и рекламных аккаунтов. Результаты не отвечали требованиям рекламодателей. Кроме того, предлагаемая Facebook сумма ставки может не отвечать бизнес-целям многих рекламодателей. Упразднены следующие поля и параметры:

  • поле bid_estimate;

  • параметр currency;

  • параметр daily_budget;

  • параметр optimize_for.

  Рекомендуем основывать ставки на реальных результатах рекламы. Если вы ещё не знаете, насколько эффективна реклама, рекомендуем использовать автоматический выбор ставок. Подробнее см. в разделе, посвященном аукциону рекламы, в Справочном центре рекламодателя и в разделе Ставки и оптимизация рекламы.

• Изменен тип результата, возвращаемого в поле curve_budget_reach для запроса GET /{rf-prediction-id}. Теперь вместо сериализованной строки JSON возвращается карта. Это затрагивает GET /{rf-prediction-id}.

• Упразднена граница контекста GET /{ad-account-id}/ratecard.

• Упразднено несколько полей /ad_accounts, связанных с биллингом. В том числе:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Упразднены поля pixel_id и external_event_source границы контекста GET /customaudience.

Статистика рекламы и измерения

• Упразднено поле matched_unique_users узла OFFLINE_EVENT_SET_ID, возвращаемое запросами GET /{data-set-id} и GET /{data-set-upload-id}. См. раздел API Offline Conversions.

• Упразднены граница контекста attributed_events и поле attribute_stats для GET /{data_set_id} API. Используйте API GET /{data_set_id}/stats для получения статистики по событиям.

• Упразднено поле matched_unique_users узла OFFLINE_EVENT_SET_ID, возвращаемое запросами GET /{data-set-id} и GET /{data-set-upload-id}.

• Изменены возвращаемые значения по умолчанию для GET {data_set_upload_id}. По умолчанию больше не возвращаются следующие поля: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats и matched_unique_users.

• Изменены возвращаемые по умолчанию значения для GET {data_set_id}/stats. Теперь по умолчанию возвращается только статистика по количеству. Чтобы указать, какие значения должны быть возвращены, используйте параметр fields или summary для общей статистики, например average_upload_delay.

• Изменения возвращаемые по умолчанию значения для GET {data_set_id}. По умолчанию больше не возвращаются следующие поля: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Упразднена граница контекста GET {data-set-upload-id}/stats. Вместо нее используйте поле valid_entries или matched_entries узла GET {data-set-upload-id}.

• Упразднено поле canvas_component_avg_pct_view API Insights.