Service vidéo long

Les clients SSP peuvent intégrer leur application ou leur inventaire vidéo de pod publicitaire web long avec Prebid Server Premium (PSP) à l’aide du point de /prebid/lfv terminaison. Les durées de vidéo de longue durée sont d’au moins 30 minutes avec des positions potentielles avant, milieu et post-rouleau.

Les clients Microsoft Monetize Ad Server n’ont pas besoin de modifier leur intégration actuelle à Xandr, peuvent ignorer le service vidéo long et peuvent suivre les étapes de configuration psp.

Processus de demande et de réponse

Les étapes suivantes décrivent le processus de demande et de réponse vidéo long :

1. Les éditeurs envoient une demande de vidéo longue à Xandr’s Impression Bus (ImpBus) via le point de /prebid/lfv terminaison. Cette demande contient des POST valeurs pour le pod publicitaire, telles que la durée de l’annonce, la largeur et la hauteur de la vidéo, et des propriétés facultatives telles que la catégorie de marque pour la séparation concurrentielle.
2. ImpBus décompresse la demande et détermine le nombre d’emplacements publicitaires à remplir dans le pod publicitaire.
3. Les configurations de Monetize sont récupérées et une requête OpenRTB avec le nombre d’emplacements publicitaires demandé est créée par ImpBus.
4. ImpBus soumet la demande OpenRTB à tous les soumissionnaires Xandr, y compris les partenaires à la demande PSP et Microsoft Invest
   1. Les partenaires prebid demandent des offres, chacun avec une sous-catégorie IAB unique.
   2. Microsoft Invest et les soumissionnaires externes ont une catégorie de marque Xandr unique associée à chaque offre qui est convertie en sous-catégorie IAB. Pour plus d’informations, consultez Adserver Category Mapping Service.
5. ImpBus organise la vente aux enchères pour la Place de marché Xandr afin de déterminer l’offre Xandr gagnante.
6. En fonction de la configuration du serveur de publication et du serveur publicitaire récupérée à l’étape 3, ImpBus traduit les sous-catégories IAB en catégories de serveurs publicitaires principales (Freewheel ou Google Ad Manager). Pour plus d’informations, consultez Adserver Category Mapping Service.
   1. Pour les enchères Xandr, ImpBus se traduit de la catégorie Xandr à la sous-catégorie IAB et enfin à la catégorie de serveur publicitaire principal.
7. Les enchères sont dédupliquées en fonction des valeurs de tuple pour le compartiment de prix, la catégorie de serveur publicitaire principal et la durée.
8. Pour chaque enchère unique, ImpBus met en cache le XML VAST unique.
9. Des paires de ciblage clé-valeur sont générées pour chaque enchère pour hb_pb, hb_pb_cat_dur, et hb_cache_id.
10. ImpBus retourne une réponse JSON avec Prebid ciblant les paires clé-valeur et l’ID de cache.

API REST

Le tableau suivant répertorie les paramètres obligatoires et facultatifs pour l’envoi d’une demande d’offre vidéo longue.

xdyn_params Exemple

{
  "xdyn_params": {
    "appnexus": {
      "keywords": "key1=val1,key2=val2"
    }
  }
}

Application

L’objet app prend en charge les paramètres de requête suivants.

Configuration du cache

L’objet cache config prend en charge les paramètres de requête suivants.

Contenu

L’objet content prend en charge les paramètres de requête suivants.

Appareil

L’objet device prend en charge les paramètres de requête suivants.

Aïds

L’objet eid prend en charge les paramètres de requête suivants.

Inclure la catégorie de marque

L’objet includebrandcategory prend en charge les paramètres de requête suivants.

Site

L’objet site prend en charge les paramètres de requête suivants.

Utilisateur

L’objet user prend en charge les paramètres de requête suivants.

Vidéo

L’objet video prend en charge les paramètres de requête suivants.

Gousses

L’objet pod prend en charge les paramètres de requête suivants.

Configuration du pod

L’objet pod config prend en charge les paramètres de requête suivants.

Plage de durée

est podconfig.durationrangesec un tableau d’entiers représentant les durées d’emplacement publicitaire dans le pod d’annonce :

podconfig.durationrangesec = [15, 30];

Règlement général sur la protection des données (RGPD)

Le RGPD est une loi sur la confidentialité des données promulguée par l’Union européenne. L’objectif du RGPD est de fournir des mesures de confidentialité et de sécurité des données plus strictes, ainsi que des divulgations et des rapports plus conviviaux sur les pratiques de protection des données.

Granularité des prix

Plages de granularité des prix

Réponse

Les partenaires de demande retournent une réponse à la demande d’offre de pod publicitaire au format JSON.

Pod d’annonces

Ciblage des pods publicitaires

Exemple

Exemple de code

curl -X "POST" -H "Content-Type: application/json" -d 

{
   "podconfig":{
      "durationrangesec":[
         30
      ],
      "requireexactduration":false,
      "pods":[
         {
            "podid":1,
            "adpoddurationsec":60,
            "placementid":14997137
         }
      ]
   },
   "site":{
      "page":"https://www.foobar.com/1234.md"
   },
   "user":{
      "yob":1982,
      "gender":"M"
   },
   "device":{
      "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13 (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2",
      "ip":"123.145.167.10",
      "devicetype":1,
      "ifa":"AA000DFE74168477C70D291f574D344790E0BB11"
   },
   "includebrandcategory":{
      "primaryadserver":1
   },
   "video":{
      "w":640,
      "h":480,
      "mimes":[
         "video/mp4"
      ],
      "protocols":[
         2,
         3
      ]
   },
   "content":{
      "episode":6,
      "title":"episodeName",
      "series":"TvName",
      "season":"season3",
      "len":900,
      "livestream":false,
      "genre":"comedy",
      "program_type":"series",
      "contentrating":"GA",
      "id":"ABCDEF12345678",
      "language":"EN",
      "network":"XTV",
      "channel":"XandrTV",
      "airtime":1657827359,
      "album":"showads",
      "cat":[
         "IAB1-7",
         "IAB19-18"
      ],
      "context":1,
      "embeddable":false,
      "isrc":"USXND2100112",
      "keywords":"prizeworth=5000,gameshow,edu=true",
      "prodq":"prosumer",
      "qagmediarating":1,
      "sourcerelationship":true,
      "url":"https://tvname.xandrtv.com/overview",
      "userrating":"4/5 recommended",
      "producer":{
         "id":"xndtv5401",
         "name":"XandrTV",
         "cat":[
            "IAB1-7",
            "IAB19-18"
         ],
         "domain":"xandrtv.com"
      },
      "data":[
         {
            "id":"xandr",
            "name":"xndtv",
            "segment":[
               {
                  "id":"11854",
                  "name":"repeat viewers",
                  "value":"973"
               }
            ]
         }
      ]
   },
   "pricegranularity":{
      "precision":2,
      "ranges":[
         {
            "max":30.00,
            "increment":1.00
         }
      ]
   }
}

Rubrique connexe

Formats et chemins d’intégration pris en charge par PSP