Analyser le SegmentRequest

Dans la curation en temps réel, Google envoie un JSON SegmentRequest à votre point de terminaison de curation pour fournir des signaux décrivant une ou plusieurs impressions, ce qui vous permet de déterminer les segments de données applicables à chacune d'elles. Ce guide explique comment développer une logique de curation qui gère SegmentRequest.

Utiliser l'encodage gzip

Google utilise l'encodage gzip lorsqu'il envoie un SegmentRequest à votre point de terminaison. Votre point de terminaison doit être capable de recevoir et de répondre avec l'encodage gzip.

Curation avec des points de terminaison de signaux contextuels ou sécurisés

Lorsque vous créez un point de terminaison de curation en temps réel, vous devez choisir de recevoir des signaux contextuels ou sécurisés. Les signaux que vous sélectionnez ont une incidence sur la façon dont les demandes de segments envoyées à votre point de terminaison sont renseignées, sur la quantité d'inventaire qui génère des demandes de segments envoyées à votre point de terminaison et sur la logique de curation utilisée dans votre intégration.

Utiliser des signaux contextuels

Les signaux contextuels incluent des informations sur l'éditeur, l'appareil et l'utilisateur qui décrivent l'origine de l'impression. La liste suivante décrit les signaux disponibles :

  • SegmentRequest.site : Décrit le site Web qui affiche l'impression, comme l'URL du site. Seuls SegmentRequest.site ou SegmentRequest.app peuvent être renseignés dans un SegmentRequest.
  • SegmentRequest.app : décrit l'application qui affiche l'impression, comme l'identifiant d'application spécifique à la plate-forme. Vous ne pouvez renseigner qu'un seul SegmentRequest.site ou SegmentRequest.app dans un SegmentRequest.
  • SegmentRequest.pub : Décrit l'éditeur du contenu multimédia qui génère l'impression, par exemple l'ID de l'éditeur.
  • SegmentRequest.user : décrit les choix des utilisateurs concernant le traitement de leurs données à caractère personnel, par exemple avec la chaîne de consentement TCF.
  • SegmentRequest.device : décrit les informations sur l'appareil, telles que sa position géographique avec une précision au niveau du métro.

Vous pouvez utiliser des signaux contextuels pour implémenter une logique de curation capable de déterminer les segments de données applicables à renvoyer dans SegmentResponse.

Utiliser des signaux sécurisés

Les signaux sécurisés sont des données créées par l'éditeur et qu'il a choisi de partager avec un ou plusieurs partenaires. Elles sont masquées avant d'être partagées avec Google dans la demande d'annonce. Dans la curation en temps réel, elles apparaissent sous leur forme masquée dans SegmentRequest.user.eids.uids.id.

Si votre point de terminaison est configuré pour utiliser des signaux sécurisés, il ne recevra que les demandes de segments pour l'inventaire des éditeurs qui ont choisi de partager des signaux sécurisés avec votre compte de curation. Par conséquent, le nombre total d'impressions pouvant être envoyées aux points de terminaison de signaux sécurisés est inférieur à celui des points de terminaison de signaux contextuels.

La logique de curation de votre point de terminaison doit interpréter le signal sécurisé et l'utiliser pour déterminer les segments de données applicables à renvoyer dans SegmentResponse.

Exemples de SegmentRequest

Point de terminaison de curation en temps réel des signaux contextuels

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Point de terminaison de curation en temps réel des signaux sécurisés

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Étapes suivantes