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 für die Verarbeitung von SegmentRequest behandelt.

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 Kontext- oder Zielgruppensignale

Wenn Sie einen Echtzeit-Curation-Endpunkt erstellen, müssen Sie auswählen, ob Sie kontextbezogene Signale oder Zielgruppensignale erhalten 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 Logik für die Kuration 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 die 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 Metro-Ebene.

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

Zielgruppensignale verwenden

Zu Zielgruppensignalen gehören Nutzer- oder Geräte-IDs sowie sichere Signale. Sichere Signale sind Daten, die vom Publisher erstellt wurden und die er mit einem oder mehreren Partnern teilen möchte. Sie werden verschleiert, bevor sie in der Anzeigenanfrage an Google gesendet werden. In der Echtzeit-Kuration werden sie in verschleierter Form in SegmentRequest.user.eids.uids.id angezeigt.

Wenn Ihr Endpunkt für die Verwendung von Zielgruppensignalen konfiguriert ist, werden nur Segmentanfragen für das Inventar von Publishern an Ihren Endpunkt gesendet, die sich dafür entschieden haben, sichere Signale mit Ihrem Curation-Konto zu teilen. Daher gibt es weniger Impressionen insgesamt, die an Endpunkte für Zielgruppensignale gesendet werden können, als an Endpunkte für kontextbezogene Signale.

Die Curation-Logik Ihres Endpunkts muss die Zielgruppensignale interpretieren und die entsprechenden Datensegmente ermitteln, die im SegmentResponse zurückgegeben werden sollen.

Beispiele für SegmentRequest

Kontextsignal-Endpunkt für die Echtzeit-Kuration

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

Endpunkt für die Echtzeit-Kuratierung von Zielgruppensignalen

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

Nächste Schritte