Объект SupplyChain позволяет покупателям и посредникам видеть все стороны, принимающие участие в продаже и перепродаже рекламного инвентаря. Вместе с файлами ads.txt
, app-ads.txt
и sellers.json
он помогает обеспечить прозрачность рекламной экосистемы.
- Издатель отправляет запрос ставки.
- Покупатель получает запрос ставки и данные из объекта SupplyChain.
- Покупатель изучает сведения о каждом посреднике, который будет заниматься перепродажей инвентаря.
- Покупатель сканирует и проверяет всех поставщиков, которым разрешено продавать инвентарь.
Google автоматически создает такие объекты в рамках запроса OpenRTB или протокола Google RTB.
Как работает объект SupplyChain
Объект SupplyChain (
) является частью запроса ставки OpenRTB и состоит из узлов. Каждый узел в объекте schain
schain
представляет сторону, участвующую в запросе ставки и задействованную в прямом потоке платежных операций для инвентаря.
// Пример объекта
"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 не включаются посредники, которые не работают с платежами, в частности те, кто предоставляет услуги назначения ставок в заголовке на стороне клиента или без оплаты.
Издатели, работающие с Инструментом управления клиентами
Инструмент управления клиентами (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). Не приведет ли это к снижению дохода? Будет ли цепочка поставок помечена как завершенная?