Cree un público de Segmentación por clientes

Crea un público de Segmentación por clientes enviando un objeto CreateUserListRequest.

Crea el cuerpo de la solicitud

Crea un recurso UserList. Estos son los campos comunes que se deben configurar.

displayName
Obligatorio Es el nombre visible de la lista. El nombre debe ser único entre todas las listas que posee la cuenta.
description
Una breve descripción de la lista.
integrationCode
Es un ID de tu sistema.
membershipDuration

Es la duración durante la que un miembro del público permanece en la lista después de que se lo agrega. El valor debe corresponder a días completos. Si no se establece, el valor predeterminado es el máximo.

Si usas JSON, calcula la cantidad de segundos multiplicando los días de duración por 86400 (la cantidad de segundos por día). Luego, establece el valor en el resultado de la multiplicación, seguido de s. Por ejemplo, si quieres una duración de membresía de 90 días, usa el valor 7776000s, ya que 90 * 86400 = 7776000.

Si usas el formato de búfer de protocolo, utiliza el método útil para construir un objeto Duration según la cantidad de días, si existe tal método útil. Por ejemplo, la biblioteca protobuf-java-util para Java tiene un método de conveniencia fromDays(). De lo contrario, calcula la cantidad de segundos multiplicando los días de duración por 86400 (la cantidad de segundos por día) y usa el resultado para establecer el campo seconds del objeto Duration.

Campos obligatorios para la Segmentación por clientes

El campo ingestedUserListInfo es obligatorio para un público de Segmentación por clientes.

A continuación, se indican los campos que se deben configurar en IngestedUserListInfo según el tipo de datos que desees usar para agregar miembros del público a la lista.

Lista de información de contacto

Configura los siguientes campos si deseas usar información de contacto (direcciones de correo electrónico, números de teléfono o direcciones con codificación hash) para definir los miembros de tu público:

uploadKeyTypes

Se establece en una lista que contiene el tipo de clave de carga CONTACT_ID.

La lista uploadKeyTypes debe contener solo una entrada.

contactIdInfo

Se establece en un mensaje ContactIdInfo con dataSourceType establecido en el valor apropiado del enum DataSourceType.

Lista de IDs de dispositivos móviles

Configura los siguientes campos si deseas usar IDs de dispositivos móviles para definir los miembros de tu público:

uploadKeyTypes

Se establece en una lista que contiene el tipo de clave de carga MOBILE_ID.

La lista uploadKeyTypes debe contener solo una entrada.

mobileIdInfo

Se establece en un mensaje MobileIdInfo:

  • Establece dataSourceType en el valor adecuado del enum DataSourceType.

  • Configura keySpace como IOS o ANDROID.

  • Establece appId en la cadena que identifica de forma única la aplicación para dispositivos móviles desde la que se recopilaron los datos.

Lista de IDs de usuarios

Configura los siguientes campos si deseas usar IDs de usuario para definir los miembros de tu público:

uploadKeyTypes

Se establece en una lista que contiene el tipo de clave de carga USER_ID.

La lista uploadKeyTypes debe contener solo una entrada.

Crea la solicitud

Para crear un público de Segmentación por clientes, crea una solicitud create para el recurso UserList.

  1. Establece el campo parent en el nombre del recurso de la cuenta. El nombre del recurso debe seguir el formato accountTypes/{accountType}/accounts/{account_id}.

  2. Usa el objeto UserList que creaste para el cuerpo de la solicitud.

  3. Si tus credenciales no corresponden a una Cuenta de Google que sea un usuario en parent, establece los encabezados como se describe en Configura destinos y encabezados.

A continuación, se muestran solicitudes de ejemplo en JSON para los diferentes tipos de información del usuario. Cada solicitud establece membershipDuration en 2592000s, donde 2592000 es la cantidad de segundos en 30 días. Haz clic en el botón Abrir en el Explorador de APIs para probar una solicitud.

Información de contacto

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

IDs de dispositivos móviles

Abrir en el Explorador de APIs 
{
    "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"
}

IDs de usuario

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

Envía la solicitud

Envía la solicitud y, si es necesario, incluye encabezados de solicitud.

Si la solicitud se realiza correctamente, la respuesta contendrá el UserList creado con los campos id y name completados. Toma nota de los valores de estos campos, ya que los necesitarás en las solicitudes para agregar miembros al público.

Si la solicitud falla, inspecciona los errores para determinar la causa de la falla, actualiza la solicitud y los encabezados para corregir cualquier problema y, luego, envía la solicitud y los encabezados actualizados.

Anterior
Descripción general
Siguiente
Cómo subir miembros a un público