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 festgelegt werden können.

displayName
Erforderlich Der Anzeigename der Liste. Der Name muss unter allen Listen des Kontos 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 bleibt. Der Wert muss ganzen Tagen entsprechen. Wenn nichts anderes festgelegt ist, wird standardmäßig der Höchstwert verwendet.

Wenn Sie JSON verwenden, berechnen Sie die Anzahl der Sekunden, indem Sie die Dauer in Tagen mit 86400 (Anzahl der Sekunden pro Tag) multiplizieren. Legen Sie dann den Wert auf das Multiplikationsergebnis fest, gefolgt von s. Wenn Sie beispielsweise eine Gültigkeitsdauer von 90 Tagen wünschen, verwenden Sie den Wert 7776000s, da 90 * 86400 = 7776000.

Wenn Sie das Protokollzwischenspeicher-Format verwenden, nutzen Sie die praktische 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 Dauer in Tagen mit 86400 (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 sind die Felder, die Sie im IngestedUserListInfo festlegen müssen, je nachdem, welchen Datentyp Sie verwenden möchten, um der Liste Zielgruppenmitglieder 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 die Mitglieder Ihrer Zielgruppe zu definieren:

uploadKeyTypes

Legen Sie eine Liste mit dem Uploadschlü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 Aufzählung DataSourceType gesetzt ist.

Liste der Mobilgeräte-IDs

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

uploadKeyTypes

Legen Sie eine Liste mit dem Uploadschlü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 Aufzählung DataSourceType fest.

  • Legen Sie den Wert keySpace auf IOS oder ANDROID fest.

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

Liste der Nutzer-IDs

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

uploadKeyTypes

Legen Sie eine Liste mit dem Uploadschlüsseltyp USER_ID fest.

Die Liste uploadKeyTypes darf nur einen Eintrag enthalten.

Erstellen Sie die Anfrage

Wenn Sie eine Zielgruppe zum Kundenabgleich erstellen möchten, senden Sie eine create-Anfrage für die Ressource UserList.

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

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

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

Hier finden Sie Beispielanfragen im JSON-Format für die verschiedenen Arten von Nutzerinformationen. Bei jeder Anfrage wird membershipDuration auf 2592000s gesetzt, wobei 2592000 die Anzahl der Sekunden in 30 Tagen ist. Klicken Sie auf den Button Im API Explorer öffnen, um eine Anfrage auszuprobieren.

Kontaktdaten

Im APIs 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"
}

Digitale Ausweise

Im APIs 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 APIs 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 wie login-account oder linked-account hinzu.

Wenn die Anfrage erfolgreich ist, enthält die Antwort die erstellte UserList, wobei die schreibgeschützten Felder id und name ausgefüllt sind.

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

Zurück
Übersicht
Weiter
Mitglieder in eine Zielgruppe hochladen