Zielgruppe zum Kundenabgleich erstellen

Erstellen Sie eine Zielgruppe zum Kundenabgleich, indem Sie eine CreateUserListRequest senden.

Anfragetext erstellen

Erstellen Sie eine UserList-Ressource. Hier sind die gängigen Felder, die Sie festlegen müssen.

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 nichts anderes 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 (der Anzahl der Sekunden pro Tag) multiplizieren. Legen Sie den Wert dann auf das Ergebnis der Multiplikation fest, gefolgt von s. Wenn Sie beispielsweise eine Mitgliedschaftsdauer von 90 Tagen wünschen, verwenden Sie den Wert 7776000s, da 90 * 86400 = 7776000.

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

Pflichtfelder für den Kundenabgleich

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

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

Liste der 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

Auf eine Liste mit dem Uploadschlüsseltyp CONTACT_ID festgelegt.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

contactIdInfo

Auf eine ContactIdInfo-Nachricht mit dataSourceType, die auf den entsprechenden Wert aus der DataSourceType-Aufzählung festgelegt ist.

Mobilgerät-ID-Liste

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

uploadKeyTypes

Auf eine Liste mit dem Uploadschlüsseltyp MOBILE_ID festgelegt.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

mobileIdInfo

Auf eine MobileIdInfo-Nachricht antworten:

  • Legen Sie dataSourceType auf den entsprechenden Wert aus dem Enum DataSourceType fest.

  • Legen Sie keySpace auf IOS oder ANDROID fest.

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

Liste der Nutzer-IDs

Legen Sie die folgenden Felder fest, wenn Sie Nutzer-IDs verwenden möchten, um die Mitglieder Ihrer Zielgruppe zu definieren:

uploadKeyTypes

Auf eine Liste mit dem Uploadschlüsseltyp USER_ID festgelegt.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

Erstellen Sie die Anfrage

Erstellen Sie zum Erstellen einer Zielgruppe zum Kundenabgleich eine create-Anfrage für die UserList-Ressource.

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

  2. Verwenden Sie den UserList, den Sie für den Text der Anfrage erstellt haben.

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

Hier finden Sie Beispielanfragen in JSON für die verschiedenen Arten von Nutzerinformationen. Bei jeder Anfrage wird membershipDuration auf 2592000s festgelegt, wobei 2592000 die Anzahl der Sekunden in 30 Tagen ist. 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 das erstellte UserList mit den ausgefüllten Feldern id und name. Notieren Sie sich die Werte in diesen Feldern, da Sie sie in Anfragen zum Hinzufügen von Zielgruppenmitgliedern zur Zielgruppe benötigen.

Wenn die Anfrage fehlschlägt, prüfen Sie die Fehler, um die Ursache des Fehlers 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