Partager via


Envoyer des créations dynamiques auditables

Pour optimiser votre portée sur la plateforme de Xandr, vous devez soumettre toutes vos créations à l’aide du service d’API Creative.

Toutefois, l’envoi de toutes les variantes à des fins d’audit peut être fastidieux et coûteux. À l’aide de macros personnalisées, vous pouvez réduire le nombre d’audits effectués en consolidant tous les éléments créatifs de la même taille et de la même marque.

Un objet créatif est défini comme un objet dans le système de Xandr qui définit la façon dont une publicité doit être rendue en fonction du code HTML/JavaScript (ou d’une URL qui pointe vers le code HTML/JavaScript), ainsi que la taille de la création et d’autres valeurs. Selon la politique de création de Xandr, cet objet créatif doit toujours afficher une publicité qui a une marque, un langage et une taille cohérents.

Consultez ci-dessous un exemple de code JSON qui serait soumis au système Xandr à l’aide du service d’API Creative.

{
    "creative": {
        "content": "<script type="text/javascript" language="javascript">
                        if (${IS_PREVIEW}) 
                                                {
                                                var creative = http://creative.com/static.js
                                                }
                                        else
                                                {
                                                var creative = http://creative.com/${dynamic_ad_markup}
                                                }
                                        </script>
                                        <script type="text/javascript" src="http://creative.com/loadjs.js">
                                        </script>"
        "width": "320",
        "height": "50",
        "template": {
            "id": 7
        }
    }
}
  • Reportez-vous à ce lien pour identifier l’ID de modèle à utiliser.
  • Reportez-vous à l’exemple de squelette de script dans le champ de contenu du code JSON créatif ci-dessus.

La if condition existe pour notre processus d’audit créatif, ce qui permet à votre code de déterminer si le créatif est en cours d’audit et d’afficher une version statique pouvant être auditée du créatif.

La else condition existe pour les impressions en direct lorsqu’une enchère est déclenchée et que votre enchérisseur a eu la possibilité de répondre à une demande d’offre Xandr.

Dans votre réponse d’enchère, vous aurez la possibilité de transmettre la valeur de la macro ${dynamic_ad_markup}personnalisée .

Selon le protocole que vous utilisez, votre réponse d’enchère ressemblera à celle ci-dessous.

Xandr protocol
 
{
    "bid_response": {
        "responses": [
            {   "creative_id": 1,
                "auction_id_64": 486730670703283200,
                "price": 1,
                "custom_macros": [
                    {
                        "name": "dynamic_ad_markup",
                        "value": "dynamic.js"
                    }
                ],
                "member_id": 1
            }
        ]
    }
}
OpenRTB protocol
 
{
    "id": "5461124730276536244",
    "seatbid": [
        {
            "seat": "1",
            "bid": [
                {
                    "adid": "1",
                    "price": 1,
                    "ext": {
                        "appnexus": {
                            "custom_macros": [
                                {
                                    "name": "dynamic_ad_markup",
                                    "value": "dynamic.js"
                                }
                            ]
                        }
                    }
                }
            ]
        }
    ]
}

Dans les enchères réelles, ces valeurs de macros personnalisées remplacent les espaces réservés de macro.

Le contenu créatif obtenu ressemble à ce qui suit.

<script type="text/javascript" language="javascript">
if (${IS_PREVIEW}) 
{
var creative = http://creative.com/static.js
}
else
{
var creative = http://creative.com/dynamic.js
}
</script>
<script type="text/javascript" src="http://creative.com/loadjs.js">
</script>

Étant donné que la dynamic.js valeur est entièrement contrôlée par votre soumissionnaire, vous pouvez choisir de nous transmettre une valeur différente telle que « more_dynamic.js ».

N’oubliez pas que même si vous utilisez les macros personnalisées pour afficher dynamiquement des éléments créatifs, tous les rendus d’un ID créatif donné doivent avoir la même marque, la même langue et la même taille.