Compartir a través de

Registro de destino de anuncios de búsqueda dinámica de grupo de anuncios: masivo

  • Artículo

Define un destino de anuncio de búsqueda dinámica de grupo de anuncios que se puede cargar y descargar en un archivo masivo.

El registro de destino de anuncios de búsqueda dinámica de grupo de anuncios solo se puede crear dentro de campañas de búsqueda que tengan una configuración de anuncios de búsqueda dinámica válida (compuesta por los campos Lenguaje de dominio, Descripción dinámica habilitada, Id. de fuente de página, Origen y Sitio web ). El identificador de experimento de la campaña debe establecerse y el tipo de grupo de anuncios debe establecerse en "SearchDynamic".

Puede descargar todos los registros de ad target de ad de búsqueda dinámica de grupo de anuncios en la cuenta incluyendo el valor DownloadEntity de AdGroupDynamicSearchAdTargets 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 destino de anuncio de búsqueda dinámica de grupo de anuncios si se proporciona un valor de id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAdGroupDynamicSearchAdTarget , en lugar de llamar a las operaciones de servicio directamente 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 BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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 destino de anuncios de búsqueda dinámica de grupos de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Grupo de anuncios

Nombre del grupo de anuncios que contiene el destino de anuncio dinámico (criterio de página web).

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

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Oferta

Cantidad que se va a pujar en la subasta.

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

Campaña

Nombre de la campaña que contiene el grupo de anuncios y el destino del anuncio dinámico (criterio de página web).

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

Parámetro personalizado

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

En un archivo masivo, la lista de parámetros personalizados tiene el formato siguiente.

  • Dé formato a cada par de parámetros personalizado como Key=Value, por ejemplo{_promoCode}=PROMO1.

  • Microsoft Advertising aceptará los 8 primeros pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error.

  • Cada par de clave y valor se delimita por un punto y coma y un espacio ("; "), por ejemplo {_promoCode}=PROMO1; {_season}=verano.

  • Una clave no puede contener un punto y coma. Si un valor contiene un punto y coma, debe tener escape como '\;'. Además, si el valor contiene una barra diagonal inversa, también debe tener el carácter de escape '\'.

  • La clave no puede superar los 16 bytes UTF-8 y el valor no puede superar los 250 bytes UTF-8. La clave es necesaria y el valor es opcional. El tamaño máximo de la clave no incluye las llaves y el carácter de subrayado, es decir, '{', '_' y '}'.

    Nota:

    Con el servicio bulk, la clave debe tener formato con llaves circundantes y un carácter de subrayado inicial, por ejemplo, si la clave es promoCode, debe tener el formato {_promoCode}. Con el servicio Administración de campañas no puede especificar las llaves y el carácter de subrayado circundantes.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar todos los parámetros personalizados, establezca este campo en delete_value. La palabra clave delete_value quita la configuración anterior. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar y omita los que no desee conservar. El nuevo conjunto de parámetros personalizados reemplazará a cualquier conjunto de parámetros personalizados anterior.
Eliminar: Solo lectura

Nota:

Si no establece ninguno de los campos de condición, operador o valor de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web.

Condición de destino de anuncio dinámico 1

El primero de hasta 3 operandos de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 1 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Category, CustomLabel, PageContent, PageTitle y Url.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Condición de destino de anuncio dinámico 2

El segundo de hasta 3 operandos de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 2 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Category, CustomLabel, PageContent, PageTitle y Url.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Condición de destino de anuncios dinámicos 3

El tercero de hasta 3 operandos de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 1 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Category, CustomLabel, PageContent, PageTitle y Url.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Operador de destino de anuncios dinámicos 1

El primero de hasta 3 operadores de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 1 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Contains y Equals.

Añadir: Opcional. Si no establece ninguno de los campos de condición, operador o valor de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Si establece la condición de destino de anuncio dinámico 1 y no establece el operador de destino de anuncio dinámico 1, usaremos el operador predeterminado para el operando seleccionado. Si desea crear la dirección URL Equals, se debe pasar el operador . Actualizar: No permitido. No se pueden actualizar los campos de valor o operador de destino de anuncios dinámicos. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Operador de destino de anuncios dinámicos 2

El segundo de hasta 3 operadores de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 2 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Contains y Equals.

Añadir: Opcional. Si no establece ninguno de los campos de condición, operador o valor de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Si establece la condición de destino de anuncios dinámicos21 y no establece el operador de destino de anuncios dinámicos 2, usaremos el operador predeterminado para el operando seleccionado. Si desea crear la dirección URL Equals, se debe pasar el operador . Actualizar: No permitido. No se pueden actualizar los campos de valor o operador de destino de anuncios dinámicos. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Operador de destino de anuncios dinámicos 3

El tercero de hasta 3 operadores de condición de página web. La condición se cumple si la propiedad de página web a la que hace referencia este campo contiene o es igual al valor 3 de Valor de destino de anuncio dinámico .

Entre los valores posibles se incluyen Contains y Equals.

Añadir: Opcional. Si no establece ninguno de los campos de condición, operador o valor de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Si establece la condición de destino de anuncio dinámico 3 y no establece el operador de destino de anuncio dinámico 3, usaremos el operador predeterminado para el operando seleccionado. Si desea crear la dirección URL Equals, se debe pasar el operador . Actualizar: No permitido. No se pueden actualizar los campos de valor o operador de destino de anuncios dinámicos. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Valor de destino de anuncio dinámico 1

El primero de hasta 3 argumentos de condición o criterio de página web.

Puede establecer esta cadena en la dirección URL, la categoría, el título de la página o el contenido de la página del sitio. Por ejemplo, si el campo Condición de destino de anuncio dinámico 1 está establecido en Url, puede establecer este campo en contoso.com/flowers.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Valor de destino de anuncio dinámico 2

El segundo de hasta 3 argumentos de condición de página web o criterio.

Puede establecer esta cadena en la dirección URL, la categoría, el título de la página o el contenido de la página del sitio. Por ejemplo, si el campo Condición 2 de destino de anuncio dinámico está establecido en Url, puede establecer este campo en contoso.com/flowers.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Valor de destino de anuncio dinámico 3

El tercero de hasta 3 argumentos de condición o criterio de página web.

Puede establecer esta cadena en la dirección URL, la categoría, el título de la página o el contenido de la página del sitio. Por ejemplo, si el campo Condición de destino de anuncio dinámico 3 está establecido en Url, puede establecer este campo en contoso.com/flowers.

Añadir: Opcional. Si no establece ninguno de los campos de valor o condición de destino de anuncios dinámicos, se dirigirá de forma eficaz a todas las páginas web. Solo puedes tener un destino de anuncio dinámico por grupo de anuncios para todas las páginas web.
Actualizar: No permitido. No se pueden actualizar los campos de condición o valor de destino del anuncio dinámico. Para actualizar las condiciones de la página web, debe eliminar el destino del anuncio dinámico y agregar uno nuevo.
Eliminar: Solo lectura

Id

Identificador generado por el sistema del destino de anuncio dinámico (criterio de página web).

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

Sufijo de dirección URL final

El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

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

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

Nombre

Nombre del criterio que puede usar para identificar los criterios, por ejemplo, puede filtrar u ordenar alfabéticamente.

La longitud del nombre del criterio debe estar entre 1 y 2048, ambos inclusive.

Añadir: Opcional. Si no especifica ningún nombre, el nombre se establecerá de forma predeterminada en una lista concatenada de condiciones. Cada condición se delimitará mediante la palabra clave y . Por ejemplo, si las condiciones son a) Url contiene flower , b) Url contains book y c) PageContent contains seattle, entonces el nombre predeterminado del criterio será Url contains flower y Url contains book y PageContent contains seattle. Si todos los campos de condición y valor están vacíos, tendrá como destino todas las páginas web y el nombre se establecerá en Todas las páginas web.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si especifica la palabra clave delete_value , el nombre del criterio se actualizará al valor predeterminado, es decir, todas las páginas web o una lista concatenada de criterios.
Eliminar: Solo lectura

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene el destino de anuncio dinámico (criterio de página web).

Este campo masivo se asigna al campo Id del registro del grupo de anuncios .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a agregar nuevos destinos de anuncios dinámicos a un nuevo grupo de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Eliminar: Solo lectura

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Estado

Estado del destino del anuncio dinámico (criterio de página web).

Los valores posibles son Active, Paused o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Plantilla de seguimiento

Las plantillas de seguimiento se pueden usar junto con la dirección URL de la página de aterrizaje que se genera dinámicamente a partir del dominio que especificó para la campaña anuncios de búsqueda dinámica. Al combinar el dominio con la plantilla de seguimiento, se ensambla la dirección URL de la página de aterrizaje donde se dirige a un usuario después de hacer clic en el anuncio.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?

  • Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.

  • La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.

  • La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.

  • Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

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