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.
- 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'app. Ad esempio, com.labpixies.flood per l'app "Flood-It!" con il link di Google Play https://play.google.com/store/apps/details?id=com.labpixies.flood.

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

Crea la richiesta

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

Imposta il campo parent sul nome risorsa dell'account. Il nome della risorsa deve seguire il formato accountTypes/{accountType}/accounts/{account_id}.
Utilizza UserList che hai creato per il corpo della richiesta.
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"
}

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