Mettre à jour les données d'audience et actualiser les annonces

Lorsque vous créez une audience personnalisée, vous pouvez spécifier une partie ou la totalité des métadonnées de l'audience personnalisée. Ces informations peuvent être transmises directement lors de la création d'un objet CustomAudience. CustomAudience.Builder est également compatible avec un champ dailyUpdateUri qui peut fournir et mettre à jour les métadonnées. La plate-forme exécute une tâche en arrière-plan toutes les 24 heures pour récupérer les métadonnées mises à jour à partir de dailyUpdateUri, ou toutes les quatre heures si l'audience personnalisée ne dispose pas encore des AdData nécessaires pour participer à une mise aux enchères. La plate-forme peut mettre à jour les métadonnées d'audience personnalisées suivantes:

  • Signaux d'enchères de l'utilisateur
  • Données d'enchères de confiance
  • AdData liste

Pour mettre à jour ces métadonnées, un processus de mise à jour quotidienne en arrière-plan interroge l'dailyUpdateUri défini dans l'audience personnalisée, qui peut renvoyer une réponse JSON.

  • La réponse JSON peut contenir l'un des champs de métadonnées compatibles devant être mis à jour.
  • Chaque champ JSON est validé indépendamment. Le client ignore les champs non valides, ce qui ne génère aucune mise à jour de ces champs dans la réponse.
  • Une réponse HTTP vide ou un objet JSON "{}" vide n'entraîne aucune mise à jour des métadonnées.
  • La taille du message de réponse doit être limitée à 10 Ko.
  • Tous les URI doivent utiliser HTTPS.
  • trusted_bidding_uri doit partager les mêmes valeurs ETLD+1 que l'acheteur.

Exemple : réponse JSON pour une mise à jour quotidienne en arrière-plan

{
    "user_bidding_signals" : { ... },  // Valid JSON object
    "trusted_bidding_data" : {
        "trusted_bidding_uri" : "example-dsp1-key-value-service.com",
        "trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
    },
    "ads" : [
        {
            "render_uri" : "www.example-dsp1.com/.../campaign123.html",
            "metadata" : { ... }  // Valid JSON object
        },
        {
            "render_uri" : "www.example-dsp1.com/.../campaign456.html",
            "metadata" : { ... }  // Valid JSON object
        },
        ...
    ]
}

Consultez cette définition de serveur fictif pour obtenir un exemple du type de données pouvant être inclus dans la réponse.