Registro de lista de remarketing: masivo

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

Nota:

Microsoft Advertising generará automáticamente audiencias similares para las listas de remarketing si es un participante piloto. No puede crear ni editar la audiencia similar para una lista de remarketing. Dicho esto, puede agregar y eliminar asociaciones y exclusiones de listas de remarketing similares. Si elimina la lista de remarketing de origen, también se eliminará la audiencia similar. Si una audiencia similar está asociada a una campaña o grupo de anuncios, no puede eliminar la lista de remarketing de origen. Consulta Lista de remarketing similar para obtener más detalles.

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 remarketing de la cuenta incluyendo el valor DownloadEntity de RemarketingLists 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.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkRemarketingList , 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 BulkRemarketingList
var bulkRemarketingList = new BulkRemarketingList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // '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(bulkRemarketingList);

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 , 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
• Regla de remarketing
• Scope
• Estado
• Tipos de campaña admitidos
• Identificador de etiqueta de UET

Público

Nombre de la lista de remarketing.

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 marketing.

Esta propiedad estará vacía si la etiqueta de UET asociada a la lista de remarketing tiene el estado No comprobado o Inactivo, ya que la lista de remarketing 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. Use una descripción para recordar a qué audiencia se dirige con esta lista de remarketing.

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

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

Duración de la pertenencia

Al crear una lista de remarketing, puede especificar la distancia en el tiempo que Microsoft Advertising debe buscar acciones que coincidan con la definición de la lista de remarketing 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

Regla de remarketing

Una plantilla de regla incluye las condiciones que se usan para determinar a quién agregar a la lista de remarketing.

Puede elegir uno de los cuatro tipos de reglas para dirigirse a audiencias diferentes: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule y PageVisitorsWhoVisitedAnotherPageRule. Para obtener más información sobre el formato de cada regla en el archivo masivo, vea las secciones de plantilla de regla CustomEvents, PageVisitors, PageVisitorsWhoDidNotVisitAnotherPage y PageVisitorsWhoVisitedAnotherPage a continuación.

Agregar: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si desea conservar cualquiera de los elementos de regla anteriores, debe volver a establecerlos explícitamente durante la actualización. Puede elegir cambiar el tipo de regla durante la actualización.
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 su lista de remarketing 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.

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 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 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.

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. 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 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.

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. 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 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.

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. Si el ámbito está establecido en Cuenta, la lista de remarketing 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 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.

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.

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

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