SegmentRequest parsen

Bei der Echtzeit-Kuratierung sendet Google ein JSON-Objekt SegmentRequest an Ihren Kuratierungs-Endpunkt, um Signale für einen oder mehrere Aufrufe bereitzustellen. So können Sie die entsprechenden Datensegmente für jeden Aufruf ermitteln. In diesem Leitfaden wird die Entwicklung einer Kuratierungslogik behandelt, die SegmentRequest verarbeitet.

Gzip-Codierung verwenden

Google verwendet die GZIP-Codierung, wenn eine SegmentRequest an Ihren Endpunkt gesendet wird. Ihr Endpunkt muss in der Lage sein, gzip-codierte Daten zu empfangen und darauf zu reagieren.

Kuratierung mit Endpunkten für Kontextsignale oder sichere Signale

Wenn Sie einen Echtzeit-Curation-Endpunkt erstellen, müssen Sie auswählen, ob Sie kontextbezogene oder sichere Signale empfangen möchten. Die von Ihnen ausgewählten Signale wirken sich darauf aus, wie Segmentanfragen, die an Ihren Endpunkt gesendet werden, ausgefüllt werden, wie viel Inventar Segmentanfragen erzeugt, die an Ihren Endpunkt gesendet werden, und welche Curation-Logik in Ihrer Integration verwendet wird.

Kontextsignale verwenden

Kontextbezogene Signale enthalten Informationen zum Publisher, Gerät und Nutzer, die den Ursprung des Impressions beschreiben. In der folgenden Liste werden die verfügbaren Signale beschrieben:

  • SegmentRequest.site: Beschreibt die Website, auf der die Impression gerendert wird, z. B. die URL der Website. In einem SegmentRequest kann nur entweder SegmentRequest.site oder SegmentRequest.app ausgefüllt werden.
  • SegmentRequest.app: Beschreibt die App, in der der Impression gerendert wird, z. B. die plattformspezifische Anwendungs-ID der App. In einem SegmentRequest kann nur entweder SegmentRequest.site oder SegmentRequest.app ausgefüllt werden.
  • SegmentRequest.pub: Beschreibt den Publisher der Media, die den Impression rendern, z. B. die ID des Publishers.
  • SegmentRequest.user: Beschreibt die Entscheidungen der Nutzer zur Verarbeitung ihrer personenbezogenen Daten, z. B. mit dem TCF-Einwilligungsstring.
  • SegmentRequest.device: Beschreibt Informationen zum Gerät, z. B. den geografischen Standort des Geräts mit einer Genauigkeit auf der Ebene von Ballungsräumen.

Sie können Kontextsignale verwenden, um eine Kuratierungslogik zu implementieren, mit der die anwendbaren Datensegmente bestimmt werden können, die in der SegmentResponse zurückgegeben werden sollen.

Sichere Signale verwenden

Sichere Signale sind Daten, die vom Publisher erstellt wurden und die er für einen oder mehrere Partner freigegeben hat. Sie werden verschleiert, bevor sie in der Anzeigenanfrage an Google weitergegeben werden. In der Echtzeit-Kuration werden sie in verschleierter Form in SegmentRequest.user.eids.uids.id angezeigt.

Wenn Ihr Endpunkt für die Verwendung sicherer Signale konfiguriert ist, werden nur Segmentanfragen für das Inventar von Publishern an Ihren Endpunkt gesendet, die sichere Signale für Ihr Curation-Konto freigegeben haben. Daher gibt es weniger Impressionen, die an Endpunkte für sichere Signale gesendet werden können, als an Endpunkte für kontextbezogene Signale.

Die Curation-Logik Ihres Endpunkts muss das sichere Signal interpretieren und damit die anwendbaren Datensegmente ermitteln, die in der SegmentResponse zurückgegeben werden sollen.

Beispiele für SegmentRequest

Kontextsignal – Echtzeit-Curation-Endpunkt

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

Echtzeit-Curation-Endpunkt für sichere Signale

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

Nächste Schritte