Делитесь пользовательскими аудиториями между бизнес-менеджерами
API Business Manager устанавливает четкие роли и обязанности при доступе к аудитории, принадлежащей другому бизнесу.
Когда пользовательская аудитория используется совместно сторонами, сначала должны быть установлены партнерские отношения между бизнес-менеджерами. Это находится в разделе «Партнеры» бизнес-настроек в Business Manager. Сторона, совместно использующая аудиторию, также должна подтвердить, что она соблюдает наши условия обслуживания индивидуальной аудитории, представленные в Business Manager, см. Facebook, Условия пользовательской аудитории.
После установления отношения совместного использования компания может делиться аудиторией с другим бизнес-менеджером. Однако аудитория может быть разделена только в одном направлении. Это означает, что аудитория распределяется между бизнесом №1 и бизнесом №2. Бизнес № 2 не сможет обмениваться аудиторией с бизнесом № 1, если не будут установлены отдельные отношения совместного использования от бизнеса № 2 до № 1.
С 2018 года для того, чтобы поделиться пользовательской аудиторией между бизнес-менеджерами, такие компании должны установить отношения совместного использования аудитории следующим образом. Вам необходимо разрешение администратора Business Manager, чтобы запросить отношения для совместного использования аудитории. Если два бизнес-менеджера уже установили отношения, рекламодатель может напрямую поделиться аудиторией с другим бизнесом. См. также Справочник, Пользовательская аудитория и Справочник, Информация об общей учетной записи пользовательской аудитории.
Чтобы создать отношение, сделайте этот вызов для определенного custom_audience_id :
POST {custom_audience_id}/adaccounts?adaccounts=[]&relationship_type=[]
Мы обрабатываем запрос на основе статуса отношений с другим бизнесом:
- Для рекламных аккаунтов, у которых есть утвержденные отношения, мы делимся аудиторией напрямую с ними.
- Для рекламных аккаунтов, у которых есть текущие отношения, мы добавляем идентификатор аудитории в запрос, чтобы, когда компания-получатель одобряла этот запрос, мы делились аудиторией.
- Для рекламных аккаунтов, которые не имеют никакого отношения, мы создаем соглашение о совместном использовании с прикрепленным к нему идентификатором аудитории, чтобы, когда компания-получатель утвердила этот запрос, мы могли затем поделиться аудиторией.
Facebook возвращает объект sharing_data для каждой рекламной учетной записи, переданной в запросе. Например:
{ успех: bool, sharing_data : [ { "ad_acct_id": id "business_id": id "audience_share_status" : строка "errors" : список }, . ] }
Опции и параметры для этого запроса включают в себя:
Идентификаторы рекламных аккаунтов, с которыми вы хотите поделиться аудиторией.
Необходимый.
Обозначает отношения между бизнесом, владеющим аудиторией, и бизнесом-получателем, с которым делится аудитория. Массив всех применимых значений.
Возможные значения: Поставщик информации об аудитории , Менеджер информации , Оптимизатор рекламы , Агентство.
Примеры
Если у вас нет прав администратора для Бизнес-менеджера и вы пытаетесь поделиться аудиторией, вы получаете сообщение об ошибке, похожее на это:
[ { "ad_acct_id": "" "share_status" : "NOT_SHARED" "ошибки" : [ "У вас нет разрешения инициировать отношения совместного использования для этого рекламного аккаунта/бизнеса" ] } . ]
После того, как вы сделаете запрос, компания, которой принадлежит рекламный аккаунт получателя, может получить ожидающий запроса на отношения с общей аудиторией, если они не имеют отношения к вам. Они могут видеть этот статус в своем Business Manager. В тот момент, когда бизнес может одобрить или отклонить запрос на отношения:
POST ?request_response="одобрить"
В случае успеха бизнес получает следующий ответ:
{ успех: логическое значение }
Утверждает ли бизнес, получающий запросы на отношения, или отклоняет запрос.
Возможные значения: одобрить, отклонить
После того, как компания, получившая запрос на установление отношений, одобрит его, вы сможете поделиться с ними аудиторией.Когда вы делаете запрос, sharing_data выглядит так:
[ { "ad_acct_id": "" "share_status" : "SHARED" "ошибки" : [] } . ]
Если вы являетесь администратором Business Manager и делитесь аудиторией с ожидающий запрос на отношения, Facebook добавляет идентификатор аудитории к существующей связи:
[ { "ad_acct_id": "" "share_status" : "IN_PROGRESS" "ошибки" : [] } . ]
Поскольку вы можете указать несколько рекламных аккаунтов в своем запросе на совместное использование аудитории, в ответе появятся результаты для каждого аккаунта:
[ { "ad_acct_id": "" "share_status" : "SHARED" "ошибки" : [] } { "ad_acct_id": "" "share_status" : "IN_PROGRESS" "ошибки" : [] } { "ad_acct_id": "" «share_status» : «NOT_SHARED» «errors» : [ «У вас нет разрешения на инициирование отношений совместного использования для этого рекламного аккаунта/бизнеса» ] } . ]
Чтобы просмотреть запросы на обмен аудиторией, полученные вашей компанией:
ПОЛУЧИТЬ /received_audience_sharing_requests
Ответ выглядит так:
[ { "инициатор": { "id": "", "name": "business_name1" }, "recipient": { "id": "", "name": "business_name2" }, "request_status": "IN_PROGRESS ", "relationship_type": "[]", "id": "", "custom_audiences": [ { "id": "", "name": "", "share_account_name": "", "share_account_id": " ", } ] } . ]
Чтобы просмотреть запросы, отправленные вашей компанией, чтобы поделиться аудиторией с другими:
ПОЛУЧИТЬ /initiated_audience_sharing_requests
Ответ выглядит так:
[ { "инициатор": { "id": "", "name": "business_name1" }, "recipient": { "id": "", "name": "business_name2" }, "request_status": "IN_PROGRESS ", "relationship_type": "[]", "id": "", "custom_audiences": [ { "id": "", "name": "", "share_account_name": "", "share_account_id": " ", } ] } . ]