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 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 eine ganze Zahl sein. 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 Mitgliedschaftsdauer beispielsweise 90 Tage betragen soll, 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 enthält beispielsweise die fromDays() Convenience-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 Duration-Objekts 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 fest, die den Uploadschlüsseltyp CONTACT_ID enthält.

Die Liste uploadKeyTypes 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 Zielgruppenmitglieder zu definieren:

uploadKeyTypes

Legen Sie eine Liste fest, die den Uploadschlüsseltyp MOBILE_ID enthält.

Die Liste uploadKeyTypes 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.
- Für iOS wird als ID-String der 9-stellige String verwendet, der am Ende einer App Store-URL angegeben ist. Beispiel: 476943146 für die App „Flood-It!“ mit dem App Store-Link https://apps.apple.com/us/app/flood-it/id476943146.
- Für Android wird als ID-String der Paketname der Anwendung verwendet. Beispiel: com.labpixies.flood für die App „Flood-It!“ mit dem Google Play-Link https://play.google.com/store/apps/details?id=com.labpixies.flood.

Anfrage erstellen

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

Legen Sie das Feld parent auf den Ressourcennamen des Kontos fest. Der Ressourcenname muss das Format accountTypes/{accountType}/accounts/{account_id} haben.
Verwenden Sie die erstellte UserList für den Text der Anfrage.
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 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ä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 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