Registro de audiencia de productos: masivo

Define una audiencia de producto que se puede descargar y cargar en un archivo masivo.

Nota:

Las listas dinámicas de remarketing se conocían anteriormente como audiencias de productos en Microsoft Advertising. Verá la "lista de remarketing dinámico" en la interfaz de usuario de Microsoft Advertising, pero para evitar cambios importantes, los objetos de API se siguen denominando "audiencia de productos".

Las listas dinámicas de remarketing emparejan a los clientes con productos específicos en función de lo que hayan visto, considerado o ya comprado en su sitio web. Puede usar listas dinámicas de remarketing tanto en campañas de búsqueda como en campañas de audiencia (aún no todos tienen campañas de audiencia).

Las listas dinámicas de remarketing funcionan mejor con las campañas de Shopping y las campañas de audiencia basadas en fuentes, es decir, aquellas campañas que aprovechan un identificador de tienda de Microsoft Merchant Center.

Importante

Asegúrese de editar el script correspondiente al identificador de etiqueta de UET en el sitio web para incluir los ecomm_prodid parámetros y ecomm_pagetype . El parámetro ecomm_prodid es el identificador de producto del producto en la página. Es único para cada elemento y debe coincidir con el identificador o el atributo item_group_id de la fuente de productos. Solo caracteres numéricos y alfanuméricos (incluidos guiones), con un máximo de 50 caracteres. El parámetro ecomm_pagetype identifica el tipo de página que ha visitado el usuario. Opciones válidas: home, searchresults, category, product, cart, purchase, other.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

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 audiencia de productos de la cuenta incluyendo el valor DownloadEntity de ProductAudiences 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 audiencia de productos.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,Search;DynamicSearchAds;Shopping;Audience

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkProductAudience , en lugar de llamar directamente a las operaciones de servicio y escribir código personalizado para analizar cada campo en el archivo masivo.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkProductAudience);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

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

• Público
• Tamaño de red de audiencia
• Tamaño de búsqueda de audiencia
• Id. de cliente
• Descripción
• Id
• Duración de la pertenencia
• Tiempo de modificación
• Parent Id
• Tipo de público de producto
• Scope
• Estado
• Tipos de campaña admitidos
• Identificador de etiqueta de UET

Público

Nombre de la audiencia del producto.

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

Agregar: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: 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.

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: 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 la pertenencia a la audiencia del producto, la regla o el identificador de etiqueta.

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

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: 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.

Agregar: Opcional
Actualizar: Opcional
Borrar: Solo lectura

Descripción

Descripción de la audiencia del producto. Use una descripción que le ayude a recordar a qué audiencia se dirige con esta audiencia de producto.

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

Agregar: 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.
Borrar: Solo lectura

Id

Identificador generado por el sistema de la audiencia del producto.

Agregar: Solo lectura
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Duración de la pertenencia

Al crear una audiencia de producto, puede especificar hasta qué punto Microsoft Advertising debe buscar acciones que coincidan con la definición de la audiencia del producto para agregar personas a la lista.

La duración mínima es de 1 día y la duración máxima permitida es de 180 días.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura

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.

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura

Parent Id

Identificador generado por el sistema de la cuenta o cliente. Si el ámbito se establece en Cuenta, este es el identificador de cuenta y, de lo contrario, es el identificador de cliente.

Agregar: Opcional
Actualizar: Solo lectura. No se puede cambiar el identificador primario.
Borrar: Solo lectura

Tipo de público de producto

Determina a quién agregar a la audiencia del producto.

Los valores posibles son GeneralVisitors, ProductSearchers, ProductViewers, ShoppingCartAbandoners y PastBuyers.

Agregar: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura

Ámbito

El ámbito define qué cuentas pueden usar este público de productos. Si el ámbito está establecido en Cuenta, la audiencia del producto solo se puede asociar a campañas y grupos de anuncios dentro de una cuenta especificada (Id. principal). Si el ámbito está establecido en Cliente, la audiencia del producto se puede asociar a cualquier campaña y grupo de anuncios en todas las cuentas del cliente.

Agregar: Obligatorio
Actualizar: Solo lectura. No se puede cambiar el ámbito.
Borrar: Solo lectura

Estado

Estado de la audiencia del producto.

Los valores posibles son Active o Deleted.

Agregar: Opcional. El valor predeterminado es Active.
Actualizar: Solo lectura
Borrar: 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 audiencia de productos.

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.

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura

Identificador de etiqueta de UET

Identificador de Microsoft Advertising de la etiqueta De seguimiento universal de eventos (UET) que se usa con la audiencia del producto.

Importante

Asegúrese de editar el script de UET en el sitio web para incluir los prodid parámetros y pagetype .

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

Agregar: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura

Plantilla de regla CustomEvents

Para la regla CustomEvents , debe incluir uno o varios de los siguientes pares de operadores de eventos condicionales: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label), (ValueOperator y Value). Si se especifica más de una condición, las condiciones se combinan mediante el operador AND lógico. En otras palabras, el visitante solo se agregará a la audiencia del producto si se cumplen todas las condiciones de regla especificadas.

Por ejemplo, supongamos que los siguientes eventos personalizados se establecen como una expresión lógica en el archivo masivo:

CustomEvents(Category Equals video) y (Action Equals play) y (Label Equals trailer) y (Value Equals 5)

La evaluación de la expresión lógica determina quién se agregará a la audiencia del producto.

Plantilla de regla PageVisitors

Para la regla PageVisitors , debe incluir uno o varios grupos de elementos de regla. Con cada grupo de elementos de regla, las condiciones del elemento de regla para la misma página se combinan mediante el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR . En otras palabras, el usuario se agregará a la audiencia del producto si se cumplen todas las condiciones de elemento de regla especificadas dentro de cualquiera de los grupos de elementos de regla.

Por ejemplo, supongamos que los siguientes grupos de elementos de regla se establecen como una expresión lógica en el archivo masivo:

PageVisitors((Url Contains X) and (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))

La evaluación de la expresión lógica determina cuál de los siguientes usuarios de ejemplo se agregará a la audiencia del producto.

Usuario	Url visitada	Dirección URL del referenciador	Se ha agregado a la lista
Usuario 1	A	X	Sí. Evaluación de los resultados de la expresión lógica como True. ((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False y True) o (True) o (False) False, True o False True
Usuario 2	N	Y	No. Evaluación de los resultados de la expresión lógica como False. ((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False y True) o (False) o (False) False, False o False False
Usuario 3	C	Z	Sí. Evaluación de los resultados de la expresión lógica como True. ((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False y False) o (True) o (True) False, True o True True

Plantilla de regla PageVisitorsWhoDidNotVisitAnotherPage

Las reglas de remarketing son condiciones que se usan para determinar a quién agregar a la audiencia del producto. Para la regla PageVisitorsWhoDidNotVisitAnotherPage , debe incluir uno o varios grupos de elementos de regla para la página visitada (IncludeRuleItemGroups) y también debe incluir uno o varios grupos de elementos de regla para la página que no se deben haber visitado (ExcludeRuleItemGroups).

Para cada grupo de elementos de regla dentro de IncludeRuleItemGroups, las condiciones del elemento de regla para la misma página se combinan mediante el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR .

Del mismo modo para cada grupo de elementos de regla dentro de ExcludeRuleItemGroups, las condiciones del elemento de regla para la misma página se combinan mediante el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR . Por último, el operador NOT lógico se aplicará al resultado agregado de excluir grupos de elementos de regla.

En otras palabras, el visitante se agregará a la audiencia del producto si se cumple alguna de las condiciones del grupo de elementos de regla de inclusión y no se cumple ninguna de las condiciones del grupo de elementos de regla de exclusión.

Por ejemplo, supongamos que los siguientes grupos de elementos de regla se establecen como una expresión lógica en el archivo masivo:

(((Url Contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y no (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C))))

La evaluación de la expresión lógica determina cuál de los siguientes usuarios de ejemplo se agregará a la audiencia del producto.

Usuario	Url visitada	Dirección URL del referenciador	Se ha agregado a la lista
Usuario 1	A	X	Sí. Evaluación de los resultados de la expresión lógica como True. (((Url Contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y no (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y True) o (True) o (False)) y no ((True y False) o (False)) (False, True o False) y no (False o False) True y no False True
Usuario 2	N	Y	Sí. Evaluación de los resultados de la expresión lógica como True. (((Url Contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y no (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y True) o (True) o (False)) y no ((False y False) o (False)) (False, True o False) y no (False o False) True y no False True
Usuario 3	C	Z	No. Evaluación de los resultados de la expresión lógica como False. (((Url Contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y no (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y False) o (True) o (True)) y no ((False y False) o (True)) (False, True o True) y no (False o True) True y no True False

Plantilla de regla PageVisitorsWhoVisitedAnotherPage

Las reglas de remarketing son condiciones que se usan para determinar a quién agregar a la audiencia del producto. Para la regla PageVisitorsWhoVisitedAnotherPage , debe incluir uno o varios grupos de elementos de regla para la página visitada (RuleItemGroups) y también debe incluir uno o varios grupos de elementos de regla para otra página que se deben haber visitado (AnotherRuleItemGroups).

Para cada grupo de elementos de regla dentro de RuleItemGroups, las condiciones del elemento de regla para la misma página se combinan mediante el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR .

Del mismo modo para cada grupo de elementos de regla dentro de AnotherRuleItemGroups, las condiciones del elemento de regla para la misma página se combinan mediante el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR .

En otras palabras, el visitante se agregará a la audiencia del producto si se cumple alguna de las condiciones del grupo de elementos de regla y se cumple cualquiera de las condiciones del grupo de elementos de regla.

Por ejemplo, supongamos que los siguientes grupos de elementos de regla se establecen como una expresión lógica en el archivo masivo:

(((Url Contiene X) y (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C))))

La evaluación de la expresión lógica determina cuál de los siguientes usuarios de ejemplo se agregará a la audiencia del producto.

Usuario	Url visitada	Dirección URL del referenciador	Se ha agregado a la lista
Usuario 1	A	X	No. Evaluación de los resultados de la expresión lógica como False. (((Url Contiene X) y (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y True) o (True) o (False)) y ((True y False) o (False)) (False o True o False) y (False o False) True y False False
Usuario 2	N	Y	No. Evaluación de los resultados de la expresión lógica como False. (((Url Contiene X) y (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y True) o (True) o (False)) y ((False y False) o (False)) (False o True o False) y (False o False) True y False False
Usuario 3	C	Z	Sí. Evaluación de los resultados de la expresión lógica como True. (((Url Contiene X) y (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) y (((Url BeginsWith A) y (ReferrerUrl BeginsWith B)) o ((Url Contains C)))) ((False y True) o (True) o (True)) y ((False y False) o (True)) (False, True o True) y (False o True) True y True True