Объект SupplyChain позволяет покупателям и посредникам видеть все стороны, принимающие участие в продаже и перепродаже рекламного инвентаря. Вместе с файлами ads.txt
, app-ads.txt
и sellers.json
он помогает обеспечить прозрачность рекламной экосистемы.
- Издатель отправляет запрос ставки.
- Покупатель получает запрос ставки и данные из объекта SupplyChain.
- Покупатель изучает сведения о каждом посреднике, который будет заниматься перепродажей инвентаря.
- Покупатель выполняет сканирование и проверку всех поставщиков, которым разрешено продавать инвентарь.
Google автоматически создает такие объекты в рамках запроса OpenRTB или протокола Google RTB.
Как работает объект SupplyChain
Объект SupplyChain (
) является частью запроса ставки OpenRTB и состоит из узлов. Каждый узел в объекте schain
schain
представляет сторону, участвующую в запросе ставки, который включает все стороны, задействованные в прямом потоке платежных операций для инвентаря.
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Тот же идентификатор издателя, что и seller_id в файле sellers.json
"hp":1
}],
"ver":"1.0"
}
Более подробная информация приведена в документации для разработчиков по OpenRTB и в этом документе IAB.
Объект SupplyChain имеет разный вид в зависимости от того, как вы работаете с покупателями.
Издатели, продающие инвентарь напрямую через Google
Для издателей, которые продают инвентарь напрямую через Менеджер рекламы, Рекламу в приложении или AdSense, объект schain
содержит только один узел для "google.com" с идентификатором seller_id
, указанным в файле sellers.json.
Издатели, использующие Open Bidding
Для издателей, которые работают со сторонними аукционами через функцию Open Bidding, объект schain
содержит два узла: один для google.com с идентификатором seller_id
, указанным в файле sellers.json, и один для партнера по группе доходности на аукционе.
Прежде чем отправить запрос ставки, система Google создает узел для google.com. Сторонний аукцион также должен добавлять свой узел перед отправкой запроса.
Посредники, не работающие с платежами
В объект SupplyChain не включаются посредники, которые не обрабатывают платежи, в частности предоставляющие услуги назначения ставок в заголовке на стороне клиента или без оплаты.
Издатели, которые пользуются услугами посредников в вопросах оплаты до запроса
В соответствии с правилами IAB издателям, которые собирают информацию о посредниках в цепочке платежей Google Менеджера рекламы, необходимо передавать объект SupplyChain
. В объекте SupplyChain
должны быть указаны только посредники, которые непосредственно вовлечены в цепочку платежей за инвентарь. Это могут быть поставщики технологий стороннего сервера объявлений, которыми пользуется издатель. Объект SupplyChain
можно передать в запрос объявления с помощью параметра schain.
SupplyChain
, необходимо также указать в файле ads.txt или app-ads.txt издателя. В противном случае покупатели могут посчитать, что трафик привлечен запрещенными способами.Издатели, работающие с Инструментом управления клиентами
Инструмент управления клиентами (MCM) позволяет родительским издателям монетизировать инвентарь дочерних издателей на уровне отдельных аккаунтов (тип делегирования "Управление аккаунтом") или на более высоком уровне (тип делегирования "Управление инвентарем").
Партнеры, использующие тип делегирования "Управление аккаунтом"
Если родительские и дочерние издатели используют тип делегирования Управление аккаунтом, их объект schain
содержит один узел с идентификатором продавца дочернего издателя, а цепочка ставок помечается как завершенная. При типе делегирования "Управление аккаунтом" монетизация происходит в аккаунте дочернего издателя. Дочерний издатель считается конечным. Информация о родительском издателе не включается в объект schain
.
Партнеры, использующие тип делегирования "Управление инвентарем"
Теперь объект SupplyChain Object помечается как созданный для издателей, работающих с типом делегирования Управление инвентарем в Инструменте управления клиентами (MCM). Существует один узел для дочерних издателей MCM, один узел для родительских издателей MCM, и объект SupplyChain помечается как созданный.
Это изменение обязывает всех родительских издателей, работающим с типом делегирования "Управление инвентарем", передать идентификатор продавца своих дочерних издателей, используя интерфейс Менеджера рекламы или Ad Manager API.
Пример созданного объекта SupplyChain
"schain" : {
"ver": "1.0",
"complete" : 1,
"nodes" : [
// Узел для дочернего издателя, использующего Инструмент управления клиентами
{
"asi":"mcm-parent-example.com", // Это пример кода. Укажите выше действительный домен родительского издателя.
"sid":"52e41fac28963d1e058a106f", // Идентификатор продавца, принадлежащий дочернему издателю, в файле seller.json родительского издателя
"hp":1,
},
// Узел для родительского издателя, использующего Инструмент управления клиентами и тип делегирования "Управление инвентарем"
{
"asi":"google.com",
"sid":"pub-1234567891234567", // Идентификатор родительского издателя, использующего Инструмент управления клиентами в файле seller.json, который принадлежит Google
"hp":1,
}
]
}
Часто задаваемые вопросы
Для чего родительским издателям, использующим Инструмент управления клиентами, необходимо создавать файл sellers.json?
Публикуя партнерскую информацию в файле sellers.json, издатели помогают покупателям проверять инвентарь, предлагаемый такими издателями.
Подробнее о спецификации файла sellers.json от организации IAB…
У всех моих дочерних издателей должен быть действительный файл ads.txt?
Предположим, файл ads.txt дочернего издателя не содержит строку, где родительский издатель в Инструменте управления клиентами указан с пометкой DIRECT (например, MCM-parent-example.com, идентификатор продавца для дочернего издателя в Инструменте управления клиентами, DIRECT), но включает строку для Google с идентификатором родительского издателя (например, google.com, идентификатор родительского издателя в Инструменте управления клиентами, RESELLER, f08c47fec0942fa0). Не приведет ли это к снижению дохода? Будет ли цепочка поставок помечена как завершенная?