PROGRAMMATIC SPAIN

View Original

Análisis del Supply Chain Object para Open RTB por Álvaro Vasco

Diego Ruiz Cano

En 2023, varios DSPs dejaron de pujar por aquellos inventarios donde el Supply Chain Object (SCO) no se enviaba correctamente en las solicitudes de puja. Esto ha supuesto un gran problema para muchos editores.

Álvaro Vasco Hidalgo ha realizado una investigación sobre el SCO basada en las directrices de IAB, el feedback de diferentes SSPs y editores que resumimos en este artículo.

Al analizar la forma en que los editores y los SSPs  interpretan el SCO, he podido observar que hay mucha confusión en el sector y no existe un entendimiento consolidado de la forma adecuada de proceder.

  1. Dominios "own&operated". Dominio ejemplo: holaown.com

    • NO es necesario tener su propio archivo “sellers.json".

    • “Sellers.json” del SSP

                                          {"seller_id": "8509",

                                          "name": "holaown",

                                          “domain": "holaown.com",

                                          "seller_type": "PUBLISHER"}

    • holaown.com/ads.txt

      OWNERDOMAIN = holaown.com
      ssp.com, 123, DIRECT, certification_authority_id

    • El SSP debe marcar el dominio en su sistema como "own&operated".

  2. Dominios "managed". Dominio ejemplo: hola2notown.com

    • El gestor de dominios debe tener un fichero “sellers.json". Ejemploj:

      {"seller_id": "456",

      “name": "hola2notown",

      “domain": "hola2notown.com",

      “seller_type": "PUBLISHER"}

    • Archivo “sellers.json” del SSP (apuntando al gestor de dominios):

      {"seller_id": "789",

      "name": "domainmanager",

      "domain": "domainmanager.com",

      "seller_type": "INTERMEDIARY"}

    • hola2notown.com/ads.txt

      OWNERDOMAIN = hola2notown.com

      MANAGERDOMAIN = domainmanager.com

      domainmanager.com, 456, DIRECT

      ssp.com, 789, RESELLER, certification_authority_id

    • El SSP debe marcar el dominio en su sistema como "Managed".

  3. Dominios "own&operated" y dominios "managed"

    • Dominio "own&operated" ejemplo: adiosown.com

    • Dominio "managed”  ejemplo: adios2notown.com

      3.1 El gestor de los dominios debe tener un “sellers.json” que incluya sólo los dominios "managed”. Ejemplo:

      {"seller_id": "321",

      "name": "adios2notown",

      “domain": "adios2notown.com",

      "seller_type": "PUBLISHER"}

      3.2 Archivo “sellers.json” del SSP ( apuntando al gestor de dominios). Ejemplo:

      {"seller_id": "980",

      "name": "domainmanager",

      "domain": "domainmanager.com",

      "seller_type": "BOTH"}

      1. El nodo en el “sellers.json” de los SSP debe marcarse como "BOTH"

      3.3 adiosown.com/ads.txt:

      OWNERDOMAIN = domainmanager.es

      MANAGERDOMAIN = domainmanager.es

      ssp.com, 980, DIRECT, certification_authority_id

      • El SSP debe marcar el dominio en su sistema como "own&operated"

      3.4 adios2notown.com/ads.txt

      OWNERDOMAIN = adios2notown.com

      MANAGERDOMAIN = domainmanager.com

      domainmanager.es, 321, DIRECT

      ssp.com, 980, RESELLER, certification_authority_id

      • El SSP debe marcar el dominio en su sistema como "Managed" .

Detalles por tipo de integración

  1. Open Bidding:

    • Rellena el sellers.json en la pestaña de GAM

    • En una cuenta MCM:

      • Si el dominio es "own&operated" la solicitud se debería realizar a la cuenta padre. Ejemplo:

        Correcto:

        34616582/adiosown.com/home/portada/top

        Incorrecto:

        34616592,21860712938/adiosown.com/home/portada/top

      • Si el dominio es "managed" la petición debe realizarse incluyendo la cuenta “hijo”. Ejemplo

        Correcto:

        34616582,21860712938/adios2notown.com/home/portada/top

        No es correcto:

        34616582/adios2notown.com/home/portada/top

    • En este caso "Google" participa en los pagos, por eso los “sellers.json” de los SSPs deben apuntar a “google.com” y ser considerado como intermediario. Ejemplo:.

      {"seller_id": "815",

      "name": "hola_via_EB",

      “domain": "google.com",

      "seller_type": "INTERMEDIARY"}

    • Las líneas a añadir en el archivo ads.txt del sitio web deberían estar marcadas como "RESELLER" (a menudo se pueden ver como "DIRECT"). Ejemplo:

      ssp.com, 815, RESELLER, certification_authority_id


  2. Prebid:

    • Si el dominio es "Managed" se debe incluir en la librería de prebid el módulo Supply Chain Object. En este módulo se debe definir el "asi" (ID del vendedor del sellers.json alojado en el dominio del gestor) y "sid" (dominio del gestor del dominio).

      Dominio "Managed" "adios2notown.com". Ejemplo:

  • ¿Cómo puedo comprobar si el gestor de dominios está enviando el SCO correctamente?

    Ir al site -> Chrome DevTools -> Red -> compruebe los nodos SCO enviados en las bidrequests de los diferentes pujadores. Ejemplos:

Criteo:

Magnite (antiguo Rubicon):

Teads:

3. Amazon:

  • Si el site es "own&operated" no es necesario enviar el SCO a través de la librería.

  • Si el site es "managed" se debe enviar un nodo con el SCO a través de la librería. Puedes implementarlo con "config.schain".

  • ¿Cómo puedes comprobar si el gestor del dominio está enviando el SCO correctamente?

    Ir a tu site -> Chrome DevTools -> Red -> Filtrar por "bid?" (Amazon). En el payload puedes ver los nodos SCO enviados en la petición de puja.

  • Existen dos relaciones de pago en Amazon: UAM (Aps procesará el pago) y TAM (un tercero procesará el pago).

    • Relación de pagos: UAM

      • Amazon se considera como Intermediario en el sellers.json del SSP. Ejemplo:

        { "seller_id": "2009",

        “seller_type": "INTERMEDIARY",

        “name": "Amazon",

        “domain": "aps.amazon.com"}

      • Las líneas ads.txt proporcionadas por los SSP se marcan como “RESELLER”. Ejemplo:

        ssp.com, 2009, RESELLER, certification_authority_id

    • Relación de pagos: TAM

      • Amazon NO es un Intermediario y el “sellers.json” del SSP debe apuntar al editor o al gestor del dominio.

      • Como se ha comentado antes el seller_type y las líneas ads.txt (DIRECT/RESELLER) dependerán de si el site es "own&operated" o "managed":

        1. Dominio "own&operated"

          • “Sellers.json” de un SSP. Ejemplo:

            { "seller_id": "863",

            "name": "holaown",

            “domain":"holaown.com",

            “seller_type": "PUBLISHER"}

          • Líneas del ads.txt proporcionadas por un SSP:

            ssp.com, 863, DIRECT,c_a_id

        2. Dominio "managed".

          • Sellers.json” de un SSP. Ejemplo:

          {"seller_id": "864",

          "name": "managerdomain",

          “domain": "managerdomain.com",

          “seller_type": "INTERMEDIARY"}

          • Líneas del ads.txt proporcionada por un SSP:

            ssp.com, 864, RESELLER, c_a_id

            ** En la interfaz de Amazon esas líneas están marcadas como "DIRECT" pero según las directrices de IAB deberían ser "RESELLER".

        3. Dominios "managed" y otros "own&operated"

          • “Sellers.json” de un SSP. Ejemplo:

      { "seller_id": "865",

      "name": "managerdomain",

      “domain": "managerdomain.com",

      “seller_type": "BOTH"}

      • Línea Ads.txt proporcionada por un SSP para sitio “managed”:

        ssp.com, 865, RESELLER, c_a_id

        ** En la interfaz de Amazon esas líneas están marcadas como "DIRECT" pero según las directrices de IAB deberían ser "RESELLER"

      • Líneas de ads.txt proporcionada por un SSP para un sitio propio:

        ssp.com, 865, DIRECTO, c_a_id

Bibliografía

https://iabtechlab.com/blog/why-ownerdomain-managerdomain-fields-are-important-additions-to-ads-txt/

https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md

https://iabtechlab.com/sellers-json/

https://docs.prebid.org/dev-docs/modules/schain.html

https://iabtechlab.com/wp-content/uploads/2022/04/Ads.txt-1.1-Implementation-Guide.pdf

Por Álvaro Vasco Hidalgo