Creare un segmento di pubblico Customer Match

Crea un segmento di pubblico Customer Match inviando un CreateUserListRequest.

Costruisci 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

Il periodo di tempo in cui un membro del pubblico rimane nell'elenco dopo essere stato aggiunto. 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 dell'abbonamento di 90 giorni, utilizza il valore 7776000s poiché 90 * 86400 = 7776000.

Se utilizzi il formato del buffer del protocollo, utilizza il metodo pratico per costruire un oggetto Duration in base al numero di giorni, se esiste un metodo pratico di questo tipo. Ad esempio, la libreria protobuf-java-util per Java ha un metodo pratico 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.

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

Elenco dei dati di contatto

Imposta i seguenti campi se vuoi utilizzare i dati di contatto (indirizzi email sottoposti ad hashing, numeri di telefono o indirizzi) 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 messaggio ContactIdInfo con dataSourceType impostato sul valore appropriato dell'enumerazione DataSourceType.

Elenco degli ID dispositivo mobile

Imposta i seguenti campi se vuoi utilizzare gli ID 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'enumerazione 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.

Crea la richiesta

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

  1. Imposta il campo parent sul nome risorsa dell'account. Il nome della 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 le destinazioni e le intestazioni.

Di seguito sono riportate richieste di esempio in formato 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"
}

Invia la richiesta

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

Se la richiesta ha esito positivo, la risposta contiene l'UserList creato con i campi id e name compilati. Prendi nota dei valori in questi campi, perché ti serviranno nelle richieste per aggiungere membri del segmento di 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.

Indietro
Panoramica
Avanti
Caricare membri in un segmento di pubblico