Registro de elemento de lista de clientes: masivo
Define un elemento de lista de clientes que se puede cargar en un archivo masivo.
Nota:
No se admite la descarga masiva de elementos de lista de clientes.
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.
- Incluya el registro De lista de clientes en el archivo de carga masiva y establezca su campo Tipo de acción en "Agregar", "Quitar" o "Reemplazar".
- Incluya uno o varios registros de elementos de lista de clientes en el mismo archivo de carga masiva y establezca los campos Id. primario, Subtipo y Texto .
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 elementos 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 un nuevo elemento de lista de clientes.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue
Para un registro de elemento de lista de clientes , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Público
Nombre de la audiencia de la lista de clientes primaria.
El nombre puede contener un máximo de 128 caracteres.
Agregar: Obligatorio. Debe especificar el campo Id. primario o Audiencia .
Borrar: Obligatorio. Debe especificar el campo Id. primario o Audiencia .
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.
Agregar: Opcional
Borrar: Opcional
Parent Id
Identificador de la audiencia de la lista de clientes primaria.
Debe especificar el campo Id. primario o Audiencia .
Agregar: Solo lectura y Obligatorio. Debe especificar un identificador de lista de clientes existente o especificar un identificador negativo que sea igual al campo Id del registro de lista de clientes primario. Esto es necesario si va a agregar nuevos elementos de lista de clientes a una nueva lista de clientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Borrar: Obligatorio.
Subtipo
Determina si el campo Texto representa un valor de Email con hash.
Actualmente, el único valor admitido es "Email".
Agregar: Obligatorio
Borrar: Obligatorio
Texto
El Email con hash como texto.
Si el subtipo es "Email", este campo no puede contener texto sin formato. La cadena se debe aplicar hash mediante el algoritmo SHA-256. El Email con hash debe ser una cadena hexadecimal de longitud 64. Por ejemplo, debe cargar una cadena hash como "f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101" en lugar de "test@contoso.com".
Agregar: Obligatorio
Borrar: Obligatorio