Introducing Graph API v20.0 and Marketing API v20.0

Сегодня мы выпускаем Facebook Graph API 20.0 и Marketing API 20.0. Ниже перечислены изменения, которые, по нашему мнению, наиболее важны для сообщества разработчиков. К ним относятся объявления, информация об обновлении продуктов и уведомления о прекращении поддержки интеграции некоторых приложений с нашей платформой.

Полный список изменений и подробные сведения о них доступны в журнале.

Общие обновления

Автоматическое обновление версии Marketing API

Мы с радостью сообщаем о предстоящем запуске функции автоматического обновления версии MAPI. Это позволит улучшить работу с API в целом, сделать ее более удобной и эффективной. С сегодняшнего дня мы включим автоматическое обновление версии для конечных точек Marketing API, не претерпевших изменений в новой версии. Если по сравнению с упраздненной версией в следующей доступной версии конечная точка не изменилась, платформа автоматически обновит вызов до этой версии, чтобы он не завершался ошибкой.

Узнать больше можно в статье о версиях Marketing API и блоге.

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

Узнать больше об изменениях в версии 20.0 можно ниже.

Реклама с напоминаниями для Marketing API

До 13 мая 2024 года разработчики не могли обеспечивать поддержку создания рекламы с напоминаниями в Instagram через Instagram Marketing API. Соответственно, их клиенты могли создавать такую рекламу только в Meta Ads Manager. Это могло спровоцировать разногласия между нашими партнерами и их клиентами, которые хотят показывать рекламу с напоминаниями.

Мы часто получали негативные отзывы об этой несовместимости, поэтому с 13 мая 2024 года рекламу с напоминаниями можно создавать через Marketing API.

Мы ценим обратную связь от сообщества разработчиков и их клиентов и надеемся и дальше улучшать процесс работы с рекламой такого типа через Marketing API.

О рекламе с напоминаниями в Instagram

Реклама с напоминаниями в Instagram помогает рекламодателям добавить ещё одну точку взаимодействия с клиентами между продвижением и запуском товара, побуждая заинтересованных людей устанавливать напоминания. Люди, которые предоставят разрешение, получают напоминания в наиболее важный момент перед мероприятием.

О создании и редактировании мероприятий

Чтобы определять, когда нужно отправить напоминание, реклама использует сведения о дате и времени начала мероприятия. Это изменение позволяет разработчикам создавать и редактировать события через Graph API для Instagram. Вы можете создать рекламу с напоминаниями через Instagram Marketing API, добавив в рекламный креатив мероприятия.

Новый API в узле рекламного аккаунта

Это обновление не внесло кардинальные изменения в узел рекламного аккаунта — мы лишь добавили в него API. Вызов API возвращает список всех кампаний в рекламном аккаунте, для которых доступны рекомендации, в том числе связанные с понижением цены за действие.

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

PA_GUIDANCE API автоматизирует доступ к данным. Теперь вам не придется вручную проверять рекомендации для рекламного аккаунта. Нашим партнерам этот API даст возможность создавать внутренние пользовательские представления и отслеживать с их помощью тенденции с течением времени.

Компаниям, которые управляют сотнями или даже тысячами аккаунтов, сложно отслеживать метрики в каждом из них, особенно те, которые чувствительны ко времени. Рекомендации RSS обновляются ежедневно, охватывая кампании, которые были активны в последние 28 дней. Благодаря этому API агентства смогут определять самые перспективные кампании, которые можно оптимизировать с помощью рекомендаций. В последствии эти решения можно будет внедрить во внутренние системы.

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

Кроме того, агентства смогут отслеживать внедрение рекомендаций, анализируя изменения CPA.

Объявления в рекламном блоке с несколькими рекламодателями

Сегодня мы представляем возможность показывать рекламу в рекламном блоке с несколькими рекламодателями через Marketing API. До этого обновления разработчики не могли обеспечивать создание объявлений в рекламном блоке с несколькими рекламодателями через API, а их клиенты могли настраивать такие объявления только в Meta Ads Manager.

Об объявлениях в рекламном блоке с несколькими рекламодателями

Благодаря объявлениям в рекламном блоке с несколькими рекламодателями люди могут находить товары или услуги разных компаний. В некоторых местах размещения на Facebook и в Instagram можно показывать людям персонализированные предложения товаров и услуг от вашей и других компаний. Рекламный блок — это контейнер, в котором показываются несколько объявлений (как правило, на одной странице). Узнать больше можно в Справочном центре для бизнеса.

Что это означает для разработчиков?

На момент запуска показ объявлений в рекламном блоке с несколькими рекламодателями, созданных через Marketing API, по умолчанию отключен. Это значит, что разработчикам потребуется изменить код, чтобы объявления их клиентов показывались в рекламных блоках. Создание объявлений в рекламном блоке с несколькими рекламодателями поддерживается во всех версиях Marketing API. Однако во всех запросах на создание объявлений, которые могут показываться в рекламных блоках с несколькими рекламодателями, должно быть указано, разрешен ли такой показ для этих объявлений. С 19 августа 2024 года объявления в рекламных блоках с несколькими рекламодателями будут включены по умолчанию. Если ваш клиент не захочет показывать свои объявления в таких рекламных блоках, вам потребуется внести в код соответствующие изменение (если вы этого ещё не сделали).

Функции генеративного ИИ в Marketing API: генерация текста, расширение изображений, генерация фона

В октябре 2023 года мы анонсировали запуск наших первых функций для рекламодателей на основе ИИ. Речь о генерации текста, расширении изображений и генерации фона в Ads Manager. С радостью сообщаем, что теперь эти функции генеративного ИИ доступны партнерам, агентствам и рекламодателям через наш Marketing API (MAPI).

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

• Генерация фона. Создавайте до четырех фонов для изображений товаров, чтобы показывать разной аудитории разные креативы. Фоны генерируются на основе исходных изображений товаров и обычно представляют собой простые узоры или заливки.

• Расширение изображений. Легко изменяйте соотношение сторон изображений, чтобы они соответствовали требованиям для разных платформ. Сейчас эта функция поддерживается для ленты, а скоро станет доступна и для видео Reels. Благодаря ей вы сможете тратить меньше времени и ресурсов на преобразование креативов для разных целей.

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

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

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

Как это будет работать?

Эти функции становятся доступны в рамках Marketing API, а если точнее — API для рекламных креативов. Через API рекламодатели смогут отключать эти функции, а также просматривать креативы, созданные ИИ.

На примере ниже показано, как включить функции генеративного ИИ для вашего креатива через Marketing API.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

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

Рекламодатели также смогут просматривать с помощью API креативы, измененные генеративным ИИ. Узнать больше о том, как генерировать рекламные креативы, а также просматривать контент, сгенерированный каждой из функций GenAI, можно в документации для разработчиков.

Instagram Video API: возобновляемая загрузка для Instagram Video API

С 15 мая 2024 года протокол возобновляемой загрузки будет поддерживать публикацию в Instagram как локальных видео, так и роликов, доступных по URL. Речь идет о таких местах размещения роликов, как видео Reels, истории и кольцевые галереи. Новый протокол позволит загружать локальные видео, более длинные ролики ( только Reels, например до 15 минут), а также возобновлять загрузку после сбоя сети или ошибки передачи файла.

Раньше для создания видео в Instagram было нужно загрузить видеофайлы на общедоступный хостинг, где генерировался URL, который передавался Meta для публикации видео.

Узнать больше о новом процессе размещения видео можно в документации о публикации контента для разработчиков. Дополнительные сведения о медиафайлах в Instagram доступны здесь.

Instagram Graph API: новые метрики

Сегодня в Graph API станут доступны шесть дополнительных метрик для медиафайлов в контейнере кольцевой галереи: "Отметки "Нравится", "Комментарии", "Репосты", "Подписки", "Действия в профиле" (количество действий, которые выполняет посетитель вашего профиля), "Посещения профиля" (количество посещений вашего профиля). Эти метрики уже были доступны в статистике Instagram, а теперь вы сможете просматривать их и через Graph API.

Добавив в публикации с кольцевой галереей конечные точки Graph API "Отметки "Нравится", "Комментарии", "Репосты", "Подписки", "Действия в профиле" и "Посещения профиля", вы сможете просматривать эту метрики прямо через вызовы API.

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

Обновленный график прекращения поддержки: Offline Conversion API (OCAPI) от Meta

В прошлом году мы объявили, что Offline Conversions API версии 17 больше не будет поддерживать офлайн-конверсии. Мы также заявили, что поддержка Offline Conversions API будет прекращена в третьем квартале 2024 года. С тех пор мы обновили график упразднения и подтверждаем, что Offline Conversions API (OCAPI) будет недоступным с мая 2025 года. Несмотря на то, что прекращение поддержки OCAPI было перенесено с 3 квартала 2024 года на май 2025 года, мы призываем рекламодателей, которые отправляют офлайн-конверсии через Offline Conversions API, переносить существующие настройки и начинать отправлять офлайн-события через Conversions API (CAPI for Offline).

Упраздненные элементы и важные изменения

Прекращение поддержки кнопки "Забронировать" в Messenger API

С этого момента вызовы Messenger API больше не будут поддерживать кнопку "Забронировать". Это изменение не повлияет на другие шаблоны и кнопки, а компании по-прежнему смогут управлять бронированиями с помощью Meta Business Suite.

Прекращение поддержки создания рекламных сообщений через Marketing API

С сегодняшнего дня создание рекламных сообщений будет недоступно в Marketing API версии 20.0. Возможность создавать рекламные сообщения через API предыдущих версий прекратится через 90 дней. Это изменение не повлияет на другие типы рекламы с переходом к переписке.

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

Удаление некритичных временных рамок для демографических данных (через внешний Instagram Graph API)

21 мая 2024 года мы выпустили Graph API 20 для Instagram.

Спустя 90 дней (19 августа 2024 года) Graph API прекратит передавать демографические показатели аудитории, привлеченной и охваченной в некритичные для Graph API временные рамки (например, информацию о разбивке по странам, городам, возрасту и полу за последние 14 и 90 дней).

Graph API для Instagram будет по-прежнему возвращать демографические данные за предыдущий месяц (this_month) и неделю (this_week), как в приложении Instagram. Это необходимо, чтобы обеспечить согласованность между платформами.

С этим обновлением наша отчетность станет понятнее и качественнее.

Узнать больше можно в документации для разработчиков.

Упраздненные версии API

Обратите внимание на следующие упразднения в рамках графика управления версиями Graph API и Marketing API для Facebook.

Graph API

• 28 мая 2024 года будет упразднена и удалена с платформы версия Graph API 13.0.

• 17 сентября 2024 года будет упразднена и удалена с платформы версия Graph API 14.0.

• 20 ноября 2024 года будет упразднена и удалена с платформы версия Graph API 15.0.

Marketing API

• 13 августа 2024 года будет упразднена и удалена с платформы версия Marketing API 18.0.

• 4 февраля 2025 года будет упразднена и удалена с платформы версия Marketing API 19.0.

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

Meta Business SDK

Выпуск Meta Business SDK 20

Meta Business SDK 20 будет выпущен вскоре после Graph API 20. В этот выпуск войдут исправления ошибок, обновление зависимости, новые функции и, что наиболее важно, обновленный интерфейс API в соответствии с Graph API 20.

В этом выпуске также будет представлена дополнительная поддержка API для Instagram: IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI и IGAccessTokenForIGOnlyAPI. Это расширит функционал API для Instagram, чтобы вы могли извлекать медиафайлы напрямую. Наша цель — внедрить больше API, охватывающих другие продукты Meta, чтобы расширить экосистему Business SDK.

Обратите внимание на предстоящие упразднения и прекращение поддержки в рамках нашего 2-летнего графика упразднения SDK платформы.

• Май 2024 года: поддержка Facebook SDK версии 13 и более ранних будет прекращена.