El objeto SupplyChain permite que los compradores y los intermediarios vean a todas las partes que venden o distribuyen inventario publicitario. El objeto funciona junto con ads.txt
o app-ads.txt
y con sellers.json
para aportar transparencia al ecosistema publicitario.
- Un editor envía una solicitud de puja.
- Un comprador recibe del objeto SupplyChain la solicitud de puja y los datos correspondientes.
- El comprador busca las identidades de todos los intermediarios que distribuyen el inventario.
- El comprador rastrea y verifica qué proveedores están autorizados a vender el inventario.
Google creará automáticamente objetos de este tipo en las solicitudes OpenRTB o del protocolo RTB de Google, si procede.
Cómo funciona el objeto SupplyChain
El objeto SupplyChain, también denominado
, forma parte de las solicitudes de puja OpenRTB y está compuesto de "nodos". Cada nodo del objeto schain
schain
representa una entidad concreta que participa en la solicitud de puja, lo que incluye a todas las entidades implicadas en el flujo directo de pago por el inventario.
sid
) de sus editores secundarios a través de Ad Manager o mediante la API.
// Ejemplo de objeto
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // El mismo valor que figura en el campo seller_id del editor en sellers.json
"hp":1
}],
"ver":"1.0"
}
Consulte más información en la documentación de OpenRTB para desarrolladores y en la documentación de la IAB.
El objeto SupplyChain varía dependiendo de la forma en que usted trabaje con los compradores.
Editores que venden directamente con Google
En el caso de los editores que venden inventario directamente a través de Ad Manager, AdMob o AdSense, el objeto schain
contiene solo un nodo para "google.com" con el mismo valor que figura en el campo seller_id
de sellers.json.
Editores que usan Puja Abierta
En el caso de los editores que usan Subasta Abierta para trabajar con exchanges de terceros, el objeto schain
tiene dos nodos: uno para google.com con el mismo valor que figura en el campo seller_id
de sellers.json y otro para el partner de rendimiento del exchange.
Del mismo modo en que Google crea el nodo para google.com antes de enviar la solicitud de puja, el exchange de terceros debe añadir su nodo antes de enviar la solicitud.
Todos los intermediarios que no comportan ningún pago
El objeto SupplyChain no incluye los intermediarios que no gestionan pagos, como las subastas de encabezado del cliente, las subastas de encabezado no relacionadas con pagos, el inventario compartido y otras mediaciones.
Editores que utilizan intermediarios de pagos antes de la solicitud (Beta)
Es posible que las funciones en fase beta no estén disponibles en su red. Para saber cuándo tendrá disponibilidad general, consulte las notas de la versión.
Los editores que utilicen intermediarios de pagos antes de la solicitud a Google Ad Manager deben enviar el objeto SupplyChain
de acuerdo con las directrices de IAB. El objeto SupplyChain
solo debe contener intermediarios que participen directamente en el flujo de pago del inventario. Estos intermediarios pueden incluir la tecnología de servidores de anuncios de terceros que utiliza el editor. El objeto SupplyChain
se puede enviar en la solicitud de anuncio mediante el parámetro
schain.
Descripción
El parámetro de cadena de suministro (schain
) acepta un valor variable que debe ser un objeto SupplyChain serializado. Cuando se incluye este parámetro, Google agrega un nodo a los objetos schain
recibidos antes de enviarlos a los compradores.
Consulte la documentación completa de IAB para comunicar la información de SupplyChain a través de una etiqueta (en lugar de OpenRTB).
Consulte los requisitos para queschain
se analice correctamente.
Según la documentación de IAB, a continuación se define la serialización del objeto SupplyChain
:
- Las propiedades de
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject
ySupplyChainNode
están delimitadas por comas, de modo que pueden omitirse los campos opcionales y excluirse opcionalmente los separadores por comas. - Cada elemento
SupplyChainNode
está separado por un "!
". - Si el valor de una propiedad contiene caracteres que requieren codificación de URL (por ejemplo,
,
o!
), el valor debe estar codificado como URL antes de la serialización.
Orden de serialización
Las propiedades de SupplyChainObject
se serializan en este orden:
ver,complete
Las propiedades de SupplyChainNode
se serializan en este orden:
asi,sid,hp,rid,name,domain,ext
ext
es específico de cada exchange. Google Ad Manager no analiza esta propiedad.Ejemplos de cómo serializar el objeto SupplyChain
A continuación se muestran dos ejemplos de cómo serializar el objeto SupplyChain
anterior:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Ejemplos de uso
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Si el valor de asi
fuera exchange,1
, la serialización con caracteres escape sería la siguiente:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos y recomendaciones
Aunque este parámetro no es obligatorio para publicar anuncios en ninguna implementación o tipo de transacción específico, sí lo es para los editores que utilicen intermediarios de pagos antes de la solicitud a Google Ad Manager. Esto incluye a los editores que utilizan tecnología de servidores de anuncios externos.
SupplyChain
también deben representarse en el archivo ads.txt/app-ads.txt de los editores. De lo contrario, los compradores podrían considerar que el tráfico no está autorizado.Editores que usan Administración de Múltiples Clientes
La Administración de Múltiples Clientes (MCM) permite que los editores gestionen las cuentas de AdMob de sus clientes con la misma visibilidad y control que los propios editores.
En el caso de los editores superiores y secundarios que utilicen MCM con AdMob, el objeto schain
tendrá un nodo con el ID de vendedor del editor secundario, otro nodo para el editor superior, y la cadena se marcará como completada. Cuando se usa MCM con AdMob, se monetizan las cuentas de los editores secundarios. El editor secundario adopta el rol de editor final.