Zielgruppe zum Kundenabgleich erstellen

Senden Sie eine CreateUserListRequest, um eine Zielgruppe zum Kundenabgleich zu erstellen.

Anfragetext erstellen

Erstellen Sie eine UserList Ressource. Hier sind die gängigen Felder, die Sie festlegen können.

displayName
Erforderlich : Der Anzeigename der Liste. Der Name muss unter allen Listen, die dem Konto gehören, eindeutig sein.
description
Eine kurze Beschreibung der Liste.
integrationCode
Eine ID aus Ihrem System.
membershipDuration

Die Dauer, die ein Zielgruppenmitglied nach dem Hinzufügen in der Liste verbleibt. Der Wert muss ganzen Tagen entsprechen. Wenn er nicht festgelegt ist, wird standardmäßig der maximale Wert verwendet.

Wenn Sie JSON verwenden, berechnen Sie die Anzahl der Sekunden, indem Sie die Anzahl der Tage mit 86400 multiplizieren (die Anzahl der Sekunden pro Tag). Legen Sie dann den Wert auf das Ergebnis der Multiplikation fest und fügen Sie s hinzu. Wenn die Mitgliedschaft beispielsweise 90 Tage dauern soll, verwenden Sie den Wert 7776000s, da 90 * 86400 = 7776000.

Wenn Sie das Protocol Buffer-Format verwenden, nutzen Sie die Hilfsmethode zum Erstellen eines Duration-Objekts basierend auf der Anzahl der Tage, sofern eine solche Hilfsmethode vorhanden ist. Die protobuf-java-util Bibliothek für Java hat beispielsweise die fromDays() Hilfsmethode. Andernfalls berechnen Sie die Anzahl der Sekunden, indem Sie die Anzahl der Tage mit 86400 multiplizieren (die Anzahl der Sekunden pro Tag), und legen Sie mit dem Ergebnis das Feld seconds des Duration-Objekts fest.

Erforderliche Felder für den Kundenabgleich

Das Feld ingestedUserListInfo ist für eine Zielgruppe zum Kundenabgleich erforderlich.

Hier sind die Felder, die Sie für IngestedUserListInfo festlegen müssen, je nachdem, welche Daten Sie verwenden möchten, um Zielgruppenmitglieder der Liste hinzuzufügen.

Liste mit Kontaktdaten

Legen Sie die folgenden Felder fest, wenn Sie Kontaktdaten (gehashte E-Mail-Adressen, Telefonnummern oder Adressen) verwenden möchten, um Ihre Zielgruppenmitglieder zu definieren:

uploadKeyTypes

Legen Sie eine Liste mit dem Upload-Schlüsseltyp CONTACT_ID fest.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

contactIdInfo

Legen Sie eine ContactIdInfo Nachricht fest, wobei dataSourceType auf den entsprechenden Wert aus der DataSourceType Enum festgelegt ist.

Liste mit Mobilgerät-IDs

Legen Sie die folgenden Felder fest, wenn Sie Mobilgerät-IDs verwenden möchten, um Ihre Zielgruppenmitglieder zu definieren:

uploadKeyTypes

Legen Sie eine Liste mit dem Upload-Schlüsseltyp MOBILE_ID fest.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

mobileIdInfo

Legen Sie eine MobileIdInfo Nachricht fest:

  • Legen Sie für dataSourceType den entsprechenden Wert aus der DataSourceType Enum fest.

  • Legen Sie für keySpace den Wert IOS oder ANDROID fest.

  • Legen Sie für appId den String fest, der die mobile App, aus der die Daten erhoben wurden, eindeutig identifiziert.

Liste mit Nutzer-IDs

Legen Sie die folgenden Felder fest, wenn Sie Nutzer-IDs verwenden möchten, um Ihre Zielgruppenmitglieder zu definieren:

uploadKeyTypes

Legen Sie eine Liste mit dem Upload-Schlüsseltyp USER_ID fest.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

Anfrage erstellen

Erstellen Sie eine create Anfrage für die UserList Ressource, um eine Zielgruppe zum Kundenabgleich zu erstellen.

  1. Legen Sie für das Feld parent den Ressourcennamen des Kontos fest. Der Ressourcenname muss das Format accountTypes/{accountType}/accounts/{account_id} haben.

  2. Verwenden Sie die erstellte UserList für den Text der Anfrage.

  3. Wenn Ihre Anmeldedaten nicht für ein Google-Konto gelten, das ein Nutzer des parent-Kontos ist, legen Sie die Header wie unter Ziele und Header konfigurieren beschrieben fest.

Hier sind Beispielanfragen im JSON-Format für die verschiedenen Arten von Nutzerinformationen. In jeder Anfrage wird membershipDuration auf 2592000s festgelegt. 2592000 ist die Anzahl der Sekunden in 30 Tagen. Klicken Sie auf die Schaltfläche Im API Explorer öffnen , um eine Anfrage zu testen.

Kontaktdaten

Im API Explorer öffnen 
{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Mobilgerät-IDs

Im API Explorer öffnen 
{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Nutzer-IDs

Im API Explorer öffnen 
{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Anfrage senden

Senden Sie die Anfrage und fügen Sie bei Bedarf Anfrageheader hinzu.

Wenn die Anfrage erfolgreich ist, enthält die Antwort die erstellte UserList mit den Werten für id und name. Notieren Sie sich die Werte in diesen Feldern, da Sie sie in Anfragen benötigen, um Zielgruppenmitglieder der Zielgruppe hinzuzufügen.

Wenn die Anfrage fehlschlägt, prüfen Sie die Fehler, um die Ursache zu ermitteln. Aktualisieren Sie dann die Anfrage und die Header, um alle Probleme zu beheben, und senden Sie die aktualisierte Anfrage und die Header.

Zurück
Übersicht
Weiter
Mitglieder in eine Zielgruppe hochladen