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 nichts festgelegt ist, wird der Maximalwert 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, gefolgt von s. Wenn Sie beispielsweise eine Mitgliedschaftsdauer von 90 Tagen festlegen möchten, verwenden Sie den Wert 7776000s, da 90 * 86400 = 7776000.

Wenn Sie das Protocol Buffer-Format 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-utilBibliothek für Java hat beispielsweise eine fromDays() Methode. Andernfalls berechnen Sie die Anzahl der Sekunden, indem Sie die Anzahl der Tage mit 86400 multiplizieren (die Anzahl der Sekunden pro Tag), und verwenden Sie das Ergebnis, um das Feld seconds des Objekts Duration festzulegen.

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 Uploadschlüsseltyp CONTACT_ID fest.

Die uploadKeyTypes Liste darf nur einen Eintrag enthalten.

contactIdInfo

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

Liste mit Mobilgeräte-IDs

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

uploadKeyTypes

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

Die uploadKeyTypes Liste darf nur einen Eintrag enthalten.

mobileIdInfo

Legen Sie eine MobileIdInfo Nachricht fest:

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

  • Legen Sie keySpace auf IOS oder ANDROID fest.

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

Anfrage erstellen

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

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

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

  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 sind Beispielanfragen in JSON 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äte-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"
}

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