Creare un segmento di pubblico Customer Match

Crea un segmento di pubblico Customer Match inviando una richiesta CreateUserListRequest.

Crea il corpo della richiesta

Crea una risorsa UserList. Ecco 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 della permanenza di un membro del segmento di pubblico nell'elenco dopo l'aggiunta. Il valore deve corrispondere a giorni interi. Se non viene 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, poiché 90 * 86400 = 7776000.

Se utilizzi il formato buffer di protocollo, utilizza il metodo di convenienza per creare un oggetto Duration in base al numero di giorni, se esiste un metodo di convenienza di questo tipo. Ad esempio, la libreria protobuf-java-util per Java ha un metodo di utilità fromDays(). 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 segmento di pubblico all'elenco.

Elenco dei 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 segmento di pubblico:

uploadKeyTypes

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

L'elenco uploadKeyTypes deve contenere una sola voce.

contactIdInfo

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

Elenco di identità digitali

Imposta i seguenti campi se vuoi utilizzare le identità digitali per definire i membri del segmento di pubblico:

uploadKeyTypes

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

L'elenco uploadKeyTypes deve contenere una sola voce.

mobileIdInfo

Imposta su un messaggio MobileIdInfo:

  • Imposta dataSourceType sul valore appropriato dell'enum DataSourceType.

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

Elenco di ID utente

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

uploadKeyTypes

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

L'elenco uploadKeyTypes deve contenere una sola voce.

Crea la richiesta

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

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

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

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

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

Dati di contatto

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

ID mobile

Apri in Explorer API 
{
    "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"
}

ID utente

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

Invia la richiesta

Invia la richiesta e, se necessario, includi intestazioni della richiesta come login-account o linked-account.

Se la richiesta ha esito positivo, la risposta contiene l'oggetto UserList creato con i campi di solo output id e name compilati.

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

Indietro
Panoramica
Avanti
Caricare membri in un segmento di pubblico