Compartir a través de

Registro de lista de clientes: masivo

  • Artículo

Define una lista de clientes que se puede descargar y cargar en un archivo masivo.

Importante

Para poder cargar datos de lista de clientes a través de Bulk API, primero debe crear una audiencia de lista de clientes y aceptar los términos y condiciones en la interfaz de usuario de Microsoft Advertising. La lista inicial de clientes no necesita contener datos de clientes, pero debe seleccionar Acepto. Al seleccionar "Acepto" usted (1) acepta que puede revelar legalmente los detalles de audiencia, que son datos personales, a Microsoft y (2) aceptar los Términos de coincidencia del cliente, el Contrato de Microsoft Advertising y las directivas de Microsoft Advertising. Microsoft usará los datos que cargue de acuerdo con los Términos de coincidencia del cliente.

Una lista de clientes es un conjunto de información de contacto de cliente que ha compilado para habilitar la coincidencia de clientes. Cada lista puede incluir varios elementos Email.

Puede agregar o actualizar un registro de lista de clientes sin ningún registro de elemento de lista de clientes en el mismo archivo de carga masiva; sin embargo, no puede cargar ningún registro de elemento de lista de clientes sin el registro de lista de clientes primario que lo acompaña.

Después de 48 horas, compruebe los campos Tamaño de audiencia, por ejemplo, Tamaño de búsqueda de audiencia para ver cuántos de estos clientes coincidimos en Bing Network. En ese momento, los anuncios pueden empezar a mostrarse para esta nueva audiencia.

Sugerencia

Para obtener información general y más información sobre las audiencias, consulte la Guía técnica de las API de audiencia .

Puede descargar todos los registros de lista de clientes de la cuenta incluyendo el valor DownloadEntity de CustomerLists en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

En el siguiente ejemplo de CSV masivo se agregaría una nueva lista de clientes.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add

Para un registro de lista de clientes , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Acción

Determina si se agregan, quitan o reemplazan los registros de elementos de lista de clientes que se incluyen en el mismo archivo de carga masiva.

Si el tipo de acción es "Agregar", el servicio intentará agregar los registros de elementos de lista de clientes que incluya en el mismo archivo de carga masiva.

Si el tipo de acción se establece en "Quitar", el servicio intentará quitar los registros de elementos de lista de clientes que incluya en el mismo archivo de carga masiva.

Si el tipo de acción se establece en "Reemplazar", se quitarán todos los datos de coincidencia de clientes anteriores de esta lista y el servicio intentará agregar los registros de elementos de lista de clientes que incluya en el mismo archivo de carga masiva.

Añadir: Opcional. De forma predeterminada, el tipo de acción "Agregar" se usa para las nuevas listas de clientes. Tanto si establece un valor como si no, este campo se omite para las nuevas listas de clientes.
Actualizar: Obligatorio si también incluye registros de elementos de lista de clientes para una audiencia existente en el mismo archivo de carga masiva y, en caso contrario, este campo es opcional.
Eliminar: Solo lectura

Público

Nombre de la lista de clientes.

El nombre puede contener un máximo de 128 caracteres.

Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Tamaño de red de audiencia

El número total de personas que son miembros activos de esta audiencia en la red audience. Esto le da una idea del número de usuarios de red de audiencia a los que puede dirigirse.

La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Tamaño de búsqueda de audiencia

El número total de personas que son miembros activos de esta audiencia en la red de búsqueda. Esto le da una idea del número de usuarios de búsqueda a los que puede dirigirse.

La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones.

Esta propiedad estará vacía durante un máximo de 24 horas mientras se compila la audiencia, por ejemplo, si agrega o actualiza la duración de pertenencia a la lista de clientes, la regla o el identificador de etiqueta.

Esta propiedad estará vacía si la etiqueta de UET asociada a la lista de clientes tiene el estado No comprobado o Inactivo, ya que la lista de clientes no puede recibir la información del cliente de su sitio web que necesita para compilar la lista.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Identificador de cliente

Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.

Añadir: Opcional
Actualizar: Opcional
Eliminar: Solo lectura

Descripción

Descripción de la lista de clientes. Use una descripción para recordar a qué audiencia se dirige con esta lista de clientes.

La descripción puede contener un máximo de 1024 caracteres.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Id

Identificador generado por el sistema de la lista de clientes.

Añadir: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para la lista de clientes en el campo Id. primario de tipos de registro dependientes, como el elemento de lista de clientes. Esto es necesario si va a agregar una nueva lista de clientes y nuevos elementos de lista de clientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Tiempo de modificación

Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).

Nota:

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Duración de la pertenencia

Al crear una lista de clientes, puede especificar cuánto tiempo permanecen los usuarios en ese segmento.

La duración mínima es de 1 día. Nota: Si un usuario no tiene ninguna actividad durante 180 días, se quita de todos los segmentos.

Si la duración de la pertenencia es "-1", no hay expiración.

Si la duración de la pertenencia es nula, se usa la duración predeterminada (30 días).

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Parent Id

Identificador de Microsoft Advertising del cliente que contiene la lista de clientes.

Añadir: Opcional
Actualizar: Solo lectura. No se puede cambiar el identificador primario.
Eliminar: Solo lectura

Ámbito

El ámbito define qué cuentas pueden usar esta lista de clientes. Para una lista de clientes, el único ámbito admitido es Cliente, y la lista de clientes se puede asociar a cualquier campaña y grupo de anuncios en todas las cuentas del cliente.

Añadir: Obligatorio
Actualizar: Solo lectura. No se puede cambiar el ámbito.
Eliminar: Solo lectura

Estado

Estado de la lista de clientes.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: Solo lectura
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Tipos de campaña admitidos

Lista delimitada por punto y coma de los tipos de campaña que admiten esta lista de clientes.

Los valores admitidos son Audience, DynamicSearchAds, Search y Shopping. Es posible que en el futuro se agreguen nuevos tipos de campaña, por lo que no debe depender de un conjunto fijo de valores.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura