Registro de lista de remarketing basado en impresiones: masiva

Define una lista de remarketing basada en impresiones que se puede descargar y cargar en un archivo masivo.

Puede descargar todos los registros de lista de remarketing basado en impresiones de la cuenta incluyendo el valor DownloadEntity de ImpressionBasedRemarketingLists 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 remarketing basada en impresiones.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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 lista de remarketing basado en impresiones , 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
• Tipo de entidad
• Id
• Id. de grupo de anuncios de impresión
• Id. de campaña de impresión
• Duración de la pertenencia
• Tiempo de modificación
• Parent Id
• Scope
• Estado
• Tipos de campaña admitidos

Público

Nombre de la lista de remarketing basada en impresiones.

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, la regla o el identificador de etiqueta de la lista de remarketing basada en impresiones.

Esta propiedad estará vacía si la etiqueta de UET asociada a la lista de remarketing basada en impresiones tiene el estado No comprobado o Inactivo, ya que la lista de remarketing basada en impresiones no puede recibir la información del cliente de su sitio web que necesita para crear 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 lista de remarketing basada en impresiones. Use una descripción para recordar a qué audiencia se dirige con esta lista de remarketing basada en impresiones.

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

Tipo de entidad

Este tipo de entidad se basa en cómo los usuarios han visto un anuncio. Debe especificar el tipo de entidad al crear una lista de remarketing basada en impresiones. Los valores posibles son AdGroup o Campaign.

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

Id

Identificador generado por el sistema de la lista de remarketing basada en impresiones.

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

Id. de grupo de anuncios de impresión

AdGroupId usado para crear la lista de remarketing basada en impresiones.

Agregar: Si Entity Type es AdGroup, este es Obligatorio. Si Tipo de entidad es Campaña, está vacío.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Solo lectura

Id. de campaña de impresión

CampaignId usado para crear la lista de remarketing basada en impresiones.

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

Duración de la pertenencia

Al crear una lista de remarketing basada en impresiones, puede especificar hasta qué punto Microsoft Advertising debe buscar acciones que coincidan con la definición de la lista de remarketing basada en impresiones 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 30 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

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 lista de remarketing basada en impresiones 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 lista de remarketing basada en impresiones.

Plantilla de regla PageVisitors

Para la regla PageVisitors , debe incluir uno o varios grupos de elementos de regla.

Importante

Durante el año natural 2021 agregamos compatibilidad con la forma normal conjuntiva (CNF). Anteriormente, Microsoft Advertising solo admitía la forma normal disjuntiva (DNF). El formulario normal predeterminado para una nueva regla de visitantes de página sigue siendo DNF. Sin embargo, debe asegurarse de que la aplicación puede leer y distinguir correctamente entre CNF y DNF. La aplicación ya no debe suponer que la regla es disyuntiva.

Si el formulario normal es conjuntivo (CNF), las condiciones del elemento de regla para la misma página se combinan primero mediante el operador OR lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador AND lógico. En otras palabras, el usuario se agregará a la lista de remarketing basada en impresiones si se cumple alguna de las condiciones de elemento de regla especificadas dentro de todos los grupos de elementos de regla.

• Regla 1 Y regla 2
• (Regla 1 O Regla 2) Regla AND 3
• (Regla 1 O Regla 2) AND (Regla 3 O Regla 4)

Si el formulario normal es disyuntivo (DNF), las condiciones del elemento de regla para la misma página se combinan primero con 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 lista de remarketing basada en impresiones si se cumplen todas las condiciones de elemento de regla especificadas dentro de cualquiera de los grupos de elementos de regla.

• Regla 1 O Regla 2
• (Regla 1 Y Regla 2) Regla OR 3
• (Regla 1 Y Regla 2) OR (Regla 3 Y Regla 4)

Para ver un ejemplo de evaluación de DNF, 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 lista de remarketing basada en impresiones.

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 lista de remarketing basada en impresiones. 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 lista de remarketing basada en impresiones 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 la 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 lista de remarketing basada en impresiones.

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 lista de remarketing basada en impresiones. 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 lista de remarketing basada en impresiones 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 lista de remarketing basada en impresiones.

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

Ámbito

El ámbito define qué cuentas pueden usar esta lista de remarketing basada en impresiones. Si el ámbito está establecido en Cuenta, la lista de remarketing basada en impresiones solo se puede asociar a campañas y grupos de anuncios dentro de una cuenta especificada (Id. de padre). Si el ámbito está establecido en Cliente, la lista de remarketing basada en impresiones 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 lista de remarketing basado en impresiones.

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 lista de remarketing basada en impresiones.

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