Zielgruppenmitglieder senden

In dieser Kurzanleitung können Sie sich mit der Data Manager API vertraut machen. Wählen Sie die gewünschte Version des Schnellstarts aus:

In dieser Kurzanleitung führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Destination, um Zielgruppendaten zu empfangen.
  2. Zielgruppendaten zum Senden vorbereiten
  3. Erstellen Sie eine IngestionService-Anfrage für Zielgruppenmitglieder.
  4. Senden Sie die Anfrage mit dem Google APIs Explorer.
  5. Antworten auf erfolgreiche und fehlgeschlagene Vorgänge

Ziel vorbereiten

Bevor Sie Daten senden können, müssen Sie das Ziel vorbereiten, an das die Daten gesendet werden sollen. Hier ist ein Beispiel für eine Destination:

    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }

  • Legen Sie für operatingAccount das Produkt und die ID des Kontos fest, an das die Zielgruppendaten gesendet werden sollen.

Zielgruppendaten vorbereiten

Betrachten Sie die folgenden Beispieldaten in einer CSV-Datei. Jede Zeile in der Datei entspricht einem Mitglied der Zielgruppe. Jedes Mitglied hat bis zu drei E-Mail-Adressen.

#,email_1,email_2,email_3
1,dana@example.com,DanaM@example.com,
2,ALEXJ@example.com, AlexJ@cymbalgroup.com,alexj@altostrat.com
3,quinn@CYMBALGROUP.com,baklavainthebalkans@gmail.com  ,
4,rosario@example.org,cloudySanFrancisco@GMAIL.com,

Für E-Mail-Adressen gelten die folgenden Formatierungs- und Hash-Anforderungen:

  1. Entfernt alle voran- und nachgestellten Leerzeichen sowie alle Leerzeichen dazwischen.
  2. Wandeln Sie die E-Mail-Adresse in Kleinbuchstaben um.
  3. Hashen Sie die E-Mail-Adresse mit dem SHA-256-Algorithmus.
  4. Codieren Sie die Hash-Bytes mit Hexadezimalzahlen (Hex) oder Base64-Codierung. In den Beispielen in diesem Leitfaden wird die Hexadezimalschreibweise verwendet.

Hier sind die formatierten Daten:

#,email_1,email_2,email_3
1,dana@example.com,danam@example.com,
2,alexj@example.com,alexj@cymbalgroup.com,alexj@altostrat.com
3,quinn@cymbalgroup.com,baklavainthebalkans@gmail.com,
4,rosario@example.org,cloudysanfrancisco@gmail.com,

Und hier sind die Daten nach dem Hashing und der Codierung:

#,email_1,email_2,email_3
1,07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3,1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7
2,2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3,54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51,e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478
3,05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0,f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5
4,83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f,223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4

Hier ist ein Beispiel für AudienceMember für die formatierten, gehashten und codierten E-Mail-Adressen von dana@example.com und danam@example.com aus der ersten Zeile der Eingabedaten:

{
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
      },
      {
        "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
      }
    ]
  }
}

Anfragetext erstellen

Kombiniere Destination und userData für den Anfragetext:

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
  1. Aktualisieren Sie die Platzhalter im Textkörper, z. B. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID und AUDIENCE_ID, mit den Werten für Ihr Konto und Ziel.
  2. Legen Sie validateOnly auf true fest, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, setzen Sie validateOnly auf false.
  3. Setzen Sie termsOfService, um anzugeben, dass der Nutzer die Nutzungsbedingungen für den Kundenabgleich akzeptiert hat.
  4. Hinweis: Diese Anfrage gibt an, dass consent gewährt wird und keine Verschlüsselung verwendet wird.

Anfrage senden

  1. Kopieren Sie den Anfragetext mit der Schaltfläche „Kopieren“ rechts oben in der Beispielanfrage.
  2. Rufen Sie die Seite audienceMembers.ingest auf.
  3. Klicken Sie rechts auf die Schaltfläche API und dann im maximierten Bereich auf die Schaltfläche Jetzt ausprobieren.
  4. Fügen Sie den kopierten Anfragetext in das Feld Request body (Anfragetext) ein.
  5. Klicken Sie auf die Schaltfläche Ausführen, folgen Sie der Autorisierungsanleitung und prüfen Sie die Antwort.

Erfolgsantworten

Eine erfolgreiche Anfrage gibt eine Antwort mit einem Objekt zurück, das eine requestId enthält.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

Fehlerantworten

Eine fehlgeschlagene Anfrage führt zu einem Statuscode der Fehlerantwort, z. B. 400 Bad Request, und einer Antwort mit Fehlerdetails.

Wenn email_address beispielsweise einen Klartextstring anstelle eines hexadezimal codierten Werts enthält, wird die folgende Antwort zurückgegeben:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

Für eine email_address, die nicht gehasht und nur hexadezimal codiert ist, wird folgende Antwort zurückgegeben:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

Nächste Schritte