Creare un segmento di pubblico Customer Match

Crea un segmento di pubblico Customer Match inviando un CreateUserListRequest.

Costruire il corpo della richiesta

Crea una UserList risorsa. Di seguito sono riportati i campi comuni da impostare.

displayName

Obbligatorio Il nome visualizzato dell'elenco. Il nome deve essere univoco tra tutti gli elenchi di proprietà dell'account.

description

Una breve descrizione dell'elenco.

integrationCode

Un ID del tuo sistema.

membershipDuration

La durata per cui un membro del pubblico rimane nell'elenco dopo essere stato aggiunto. Il valore deve corrispondere a giorni interi. Se non è impostato, il valore predefinito è il massimo.

Se utilizzi JSON, calcola il numero di secondi moltiplicando i giorni di durata per 86400 (il numero di secondi al giorno). Poi imposta il valore sul risultato della moltiplicazione, seguito da s. Ad esempio, se vuoi una durata inclusione di 90 giorni, utilizza il valore 7776000s perché 90 * 86400 = 7776000.

Se utilizzi il formato del buffer di protocollo, utilizza il metodo di convenienza per costruire un oggetto Duration in base al numero di giorni, se esiste un metodo di convenienza di questo tipo. Ad esempio, la protobuf-java-util libreria per Java ha un fromDays() metodo di convenienza. In caso contrario, calcola il numero di secondi moltiplicando i giorni di durata per 86400 (il numero di secondi al giorno) e utilizza il risultato per impostare il campo seconds dell'oggetto Duration.

Campi obbligatori per Customer Match

Il campo ingestedUserListInfo è obbligatorio per un segmento di pubblico Customer Match.

Di seguito sono riportati i campi da impostare in IngestedUserListInfo in base al tipo di dati che vuoi utilizzare per aggiungere membri del pubblico all'elenco.

Elenco di dati di contatto

Imposta i seguenti campi se vuoi utilizzare i dati di contatto (indirizzi email, numeri di telefono o indirizzi sottoposti ad hashing) per definire i membri del pubblico:

uploadKeyTypes

Imposta un elenco contenente il tipo di chiave di caricamento CONTACT_ID.

L'elenco uploadKeyTypes deve contenere una sola voce.

contactIdInfo

Imposta un ContactIdInfo messaggio con dataSourceType impostato sul valore appropriato dell' DataSourceType enumerazione.

Elenco di identità digitali

Imposta i seguenti campi se vuoi utilizzare gli ID dispositivo mobile per definire i membri del pubblico:

uploadKeyTypes

Imposta un elenco contenente il tipo di chiave di caricamento MOBILE_ID.

L'elenco uploadKeyTypes deve contenere una sola voce.

mobileIdInfo

Imposta un MobileIdInfo messaggio:

• Imposta dataSourceType sul valore appropriato dell' DataSourceType enumerazione.

• Imposta keySpace su IOS o ANDROID.

• Imposta appId sulla stringa che identifica in modo univoco l'applicazione mobile da cui sono stati raccolti i dati.

  • Per iOS, la stringa ID è la stringa a 9 cifre visualizzata alla fine dell'URL dell'App Store. Ad esempio, 476943146 per l"app "Flood-It!" con il link all"App Store https://apps.apple.com/us/app/flood-it/id476943146.

  • Per Android, la stringa ID è il nome del pacchetto dell'applicazione. Ad esempio, com.labpixies.flood per l'app "Flood-It!" con il link a Google Play https://play.google.com/store/apps/details?id=com.labpixies.flood.

Elenco di ID utente

Imposta i seguenti campi se vuoi utilizzare gli ID utente per definire i membri del pubblico:

uploadKeyTypes

Imposta un elenco contenente il tipo di chiave di caricamento USER_ID.

L'elenco uploadKeyTypes deve contenere una sola voce.

Costruire la richiesta

Per creare un segmento di pubblico Customer Match, costruisci una create richiesta per la risorsa UserList.

1. Imposta il campo parent sul nome risorsa dell'account. Il nome risorsa deve seguire il formato accountTypes/{accountType}/accounts/{account_id}.

2. Utilizza UserList che hai creato per il corpo della richiesta.

3. Se le tue credenziali non sono per un Account Google che è un utente di parent, imposta le intestazioni come descritto in Configurare destinazioni e intestazioni.

Di seguito sono riportate richieste di esempio in JSON per i diversi tipi di informazioni utente. Ogni richiesta imposta il membershipDuration su 2592000s, dove 2592000 è il numero di secondi in 30 giorni. Fai clic sul pulsante Apri in Explorer API per provare una richiesta.

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

{
    "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"
}

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

Inviare la richiesta

Invia la richiesta e, se necessario, includi le intestazioni della richiesta.

Se la richiesta ha esito positivo, la risposta contiene creato UserList con id e name compilati. Prendi nota dei valori in questi campi perché ti serviranno nelle richieste per aggiungere membri del pubblico al segmento di pubblico.

Se la richiesta non va a buon fine, esamina gli errori per determinare la causa del problema, aggiorna la richiesta e le intestazioni per risolvere eventuali problemi, quindi invia la richiesta e le intestazioni aggiornate.