Marketing API

Создание брендированного контента

Авторы, знаменитости и медийные компании могут делиться на Facebook брендированным контентом. Публикации с брендированным контентом — это любые публикации, которые созданы с участием рекламодателя или деятеля рынка либо представляют его на возмездной основе. Чтобы использовать эту функцию, вы должны соблюдать наши Правила в отношении брендированного контента и Правила рекламной деятельности. Кроме того, вы должны отметить своего бизнес-партнера в таких публикациях. Для этого можно воспользоваться инструментом работы с брендированным контентом или API Marketing.

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

Для создания публикаций с брендированным контентом можно использовать API Marketing или инструмент работы с брендированным контентом в Ads Manager, а также приложение Mentions. Дополнительную информацию см. в Справочном центре для бизнеса.

Обзор

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

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

Чтобы разрешить своему бизнес-партнеру напрямую продвигать вашу публикацию, добавьте в нее параметр direct_share_status. Укажите direct_share_status = 1, чтобы предоставить бизнес-партнеру разрешение продвигать публикацию. Если в этом нет необходимости, установите direct_share_status = 0.

Обновление статуса

Сначала вам нужно отправить запрос POST к конечной точке feed Страницы, чтобы опубликовать обновление статуса. В запросе POST должны быть указаны значения полей sponsor_id, share_status и message.

curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1"
  
  {"id":"ID"}

Добавление фото

Вы можете добавить фото в запросе POST, отправляемом к конечной точке photos Страницы. В запросе POST должны быть указаны значения полей sponsor_id, share_status и message.

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

  curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1" 
  -F "url=https://xx.cdn.net/v/t31.0-8/13064650_505613696297499_6399089570275517473_o.jpg"
  
 {"id":"372501189608751_701886166670250"}

Добавление видео

Чтобы опубликовать видео с брендированным контентом, нужно выполнить несколько действий:

  • Сделайте вызов, указывающий на то, что вы хотите загрузить видео. API возвратит ID объекта видео, который можно использовать для загрузки.
  • Загрузите видео.
  • Завершите передачу видео, установив статус публикации. Укажите для видео параметр sponsor_id, добавляющий в новость брендированный контент.

Сведения о загрузке видео см. здесь.

В примере ниже мы отправляем запрос, загружаем видео и устанавливаем значения параметров sponsor_id и direct_share_status.

 curl -X POST "https://graph-video.facebook.com/VERSION/PAGE_ID/videos" 
  -F "access_token=$at" 
  -F "upload_phase=finish" 
  -F "upload_session_id=SESSION_ID" 
  -F "sponsor_id=ID" 
  **-F "direct_share_status=1"**

В случае успеха вы получите следующий ответ:

{"success":true}

Прямой эфир

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

  • Создайте объект прямого эфира.
  • Загрузите объект прямого эфира и добавьте sponsor_id.
  • Начните видеотрансляцию.

Подробные сведения о создании прямых видеотрансляций и управлении ими см. в статье API Live Video. Вы можете запросить список видеотрансляций для страницы и использовать ID видео для обновления sponsor_id. Другой вариант — использовать ID, полученный при создании прямого эфира.

Обновление брендированного контента

Изменение публикаций с брендированным контентом на мобильном устройстве или в браузере на компьютере не поддерживается, однако вы можете использовать API Marketing для добавления или изменения спонсора в публикации. Чтобы изменить спонсора, отредактируйте значение поля sponsor_id в объекте публикации.

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

Вы можете разрешить или запретить бизнес-партнеру непосредственное продвижение публикации. Предоставьте sponsor_id и укажите нужное значение direct_share_status.

curl -X POST "https://graph.facebook.com/PAGE_POST_ID" 
  -F "access_token=TOKEN" 
  -F "direct_share_status=1"
  
 {"success":true}