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:
- Erstellen Sie eine
Destination
, um Zielgruppendaten zu empfangen. - Zielgruppendaten zum Senden vorbereiten
- Erstellen Sie eine
IngestionService
-Anfrage für Zielgruppenmitglieder. - Senden Sie die Anfrage mit dem Google APIs Explorer.
- 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:
- Entfernt alle voran- und nachgestellten Leerzeichen sowie alle Leerzeichen dazwischen.
- Wandeln Sie die E-Mail-Adresse in Kleinbuchstaben um.
- Hashen Sie die E-Mail-Adresse mit dem SHA-256-Algorithmus.
- 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
}
- Aktualisieren Sie die Platzhalter im Textkörper, z. B.
OPERATING_ACCOUNT_PRODUCT
,OPERATING_ACCOUNT_ID
undAUDIENCE_ID
, mit den Werten für Ihr Konto und Ziel. - Legen Sie
validateOnly
auftrue
fest, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, setzen SievalidateOnly
auffalse
. - Setzen Sie
termsOfService
, um anzugeben, dass der Nutzer die Nutzungsbedingungen für den Kundenabgleich akzeptiert hat. - Hinweis: Diese Anfrage gibt an, dass
consent
gewährt wird und keine Verschlüsselung verwendet wird.
Anfrage senden
- Kopieren Sie den Anfragetext mit der Schaltfläche „Kopieren“ rechts oben in der Beispielanfrage.
- Rufen Sie die Seite
audienceMembers.ingest
auf. - Klicken Sie rechts auf die Schaltfläche API und dann im maximierten Bereich auf die Schaltfläche Jetzt ausprobieren.
- Fügen Sie den kopierten Anfragetext in das Feld Request body (Anfragetext) ein.
- 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
- Konfigurieren Sie die Authentifizierung und richten Sie Ihre Umgebung mit einer Clientbibliothek ein.
- Weitere Informationen zu den Formatierungs-, Hash- und Codierungsanforderungen für die einzelnen Datentypen
- Weitere Informationen zum Verschlüsseln von Nutzerdaten
- Best Practices
- Weitere Informationen zu Limits und Kontingenten