Версия 13.0

API Graph

Выпуск 8 февраля 2022 г. | Доступно до: уточняется | Запись в блоге

API Graph для Instagram

IG Media

Версия 13 будет последней версией, позволяющей запрашивать поле video_title для объекта IG Media без возврата ошибки. Напоминаем, что текущее поведение API, описанное в записи в блоге от 5 октября 2021 г., следующее:

Поле media_product_type возвращает значение FEED для всех версий.
Поле video_title опускается в ответах для всех версий.
Поля <comments и mentions в Instagram Webhooks поддерживаются для всех версий.

Описанное выше поведение применяется ко всем объектам IG Media, включая созданные с помощью приложения Instagram TV, независимо от даты создания.

Статистика пользователей

Относится к версии 13.0 и более поздним.

Следующие метрики статистики объекта IG User больше не поддерживают параметры since и until, и ответы не будут содержать свойство JSON end_time.

API Marketing

Выпуск 8 февраля 2022 г. | Доступно до: 25 января 2023 г. | Запись в блоге

Рекламный креатив

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

Относится к версии 13.0 и более поздним.

Узел asset_feed_spec конечной точки POST /{ad-account-id}/adcreatives теперь позволяет создавать рекламу с кольцевой галереей с кастомизацией креативов для мест размещения.

API Библиотеки рекламы

Библиотека рекламы

Относится к версии 13.0 и более поздним.

Упразднены и заменены следующие поля и границы контекста запросов для конечной точки GET /ads_archive:

Старая граница контекста/поле	Новая граница контекста/поле
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`
`potential_reach_min`	`estimated_audience_size_min`
`potential_reach_max`	`estimated_audience_size_max`
`potential_reach`	`estimated_audience_size`

Упразднены и заменены следующие возвращаемые параметры для конечной точки GET /ads_archive:

Старая граница контекста/поле	Новая граница контекста/поле
`ad_creative_body`	`ad_creative_bodies`
`ad_creative_link_caption`	`ad_creative_link_captions`
`ad_creative_link_description`	`ad_creative_link_descriptions`
`ad_creative_link_title`	`ad_creative_link_titles`
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`

Группы объявлений

Расширение похожей аудитории

Относится к версии 13.0 и более поздним. Начнет действовать для всех версий с 9 мая 2022 г.

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

Это изменение повлияет на следующие конечные точки:

API Conversions

Параметры информации о клиентах

Относится к версии 13.0 и более поздним.

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

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

Чтобы ваши события не вызывали ошибку, советуем ознакомиться с рекомендациями по работе с API Conversions.

Это изменение повлияет на следующие конечные точки:

Торговая платформа

API профилей отправки

Относится к версии 13.0 и более поздним.

Поле handling_time конечной точки GET /{cms-id}/shipping_profiles перемещено из объекта shipping_profile в объект address_category.

Каталог

API фидов

Относится к версии 13.0 и более поздним.

Код ошибки загрузки фида данных о товарах XML_JUNK_AFTER_DOCUMENT переименован в DATA_OUTSIDE_XML_TAGS. Изменено только имя.

Изменение затронет следующую конечную точку:

GET /{feed_upload_session_id}