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

  • Artículo

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

Con los anuncios de búsqueda dinámica, el título y la dirección URL de visualización se generan automáticamente en función del dominio y el idioma del sitio web al que quiera dirigirse. La combinación de los elementos Path1, Path2 y Text hace que el anuncio de búsqueda dinámico sea único. Opcionalmente, puede proporcionar un título estático mediante fuentes de página.

Nota:

Esta característica está disponible actualmente en los siguientes países: Albania (AL), Andorra (AD), Argentina (AR), Aruba, Australia (AU), Austria (AT), Bahamas (BS), Bangladesh (BD), Bélgica (BE), Bolivia (BO), Bosnia y Herzegovina (BA), Brasil (BR), Brunei (BN), Bulgaria (BG), Canadá (CA), Islas Caimán (KY), Chile(CL), Colombia(CO), Costa Rica(CR), Croacia (HR), Chipre (CY), República Checa (CZ), Dinamarca (DK), Dominica(DM), República Dominicana(DO), Ecuador(EC), El Salvador(SV), Estonia (EE), Fiji (FJ), Finlandia (FI), Francia (FR), Guayana Francesa (GF), Polinesia Francesa (PF), Alemania (DE), Grecia (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haití (HT), Honduras (HN), Hungría (HU), Islandia (IS), India (IN), Indonesia (ID), Irlanda (IE), Italia (IT), Letonia (LV), Liechtenstein (LI), Lituania (LT), Luxemburgo (LU), Malasia (MY), Maldivas (MV), Malta (MT), Martinica (MQ), México (MX), Mónaco (MC), Mongolia (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Países Bajos (NL), New Cal Nueva Zelanda (NZ), República de Macedonia del Norte (MK), Noruega (NO), Panamá (PA), Paraguay (PY), Papúa Nueva Guinea (PG), Perú (PE), Filipinas (PH), Polonia (PO), Portugal (PT), Puerto Rico, Rumania (RO), San Marino (SM), Serbia (RS), Singapur(SG), Eslovaquia (SK), Eslovenia (SI), Sudáfrica (ZA), España (ES), España(ES), Sri Lanka(LK), Suecia (SE), Suiza (CH), Tailandia(TH), Trinidad y Tobago(TT), Türkiye (TR), Ciudad del Vaticano (VA), Vietnam (VN), Reino Unido (Reino Unido), Estados Unidos (EE. UU.), Uruguay(UY) y Venezuela (VE).

El registro de anuncios de búsqueda dinámica solo se puede crear en 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".

Nota:

Ya no puedes agregar, actualizar ni recuperar campañas que solo admitan anuncios de búsqueda dinámicos. El tipo de campaña de las campañas existentes se ha actualizado de "DynamicSearchAds" a "Search". Los grupos de anuncios ahora se consideran grupos de anuncios "dinámicos", pero no hay cambios estructurales, es decir, contienen los mismos destinos automáticos y anuncios de búsqueda dinámicos que antes.

Puede descargar todos los registros de Anuncios de búsqueda dinámica de la cuenta incluyendo el valor DownloadEntity de DynamicSearchAds 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 anuncio de búsqueda dinámica si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkDynamicSearchAd , en lugar de llamar a las operaciones del 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 BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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"
                },
            }
        },
    },
};

uploadEntities.Add(bulkDynamicSearchAd);

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 anuncio de búsqueda dinámica , los siguientes campos de atributo están disponibles en el esquema de archivos masivos. La combinación de los campos Ruta de acceso 1, Ruta de acceso 2 y Texto hace que el anuncio de búsqueda dinámica sea único.

Grupo de anuncios

Nombre del grupo de anuncios que contiene el anuncio.

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 .

Campaña

Nombre de la campaña que contiene el grupo de anuncios y el anuncio.

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

Estado de la apelación editorial

Determina si puede apelar los problemas encontrados por la revisión editorial.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Atractivo El tema editorial es atractivo.
AppealPending El tema editorial es apelable y se ha presentado una apelación.
NotAppealable El tema editorial no es atractivo.

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

Ubicación editorial

Componente o propiedad del anuncio que no pudo revisar editorialmente.

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

Código de motivo editorial

Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.

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

Estado editorial

Estado editorial del anuncio.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Activo El anuncio superó la revisión editorial.
ActiveLimited El anuncio superó la revisión editorial en uno o varios mercados, y uno o varios elementos del anuncio están siendo revisados editorialmente en otro mercado. Por ejemplo, el anuncio pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó El anuncio falló en la revisión editorial.
Inactivo Uno o varios elementos del anuncio se están revisando editorialmente.

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

Término editorial

El término que falló en la revisión editorial.

Este campo no se establecerá si una combinación de términos produjo el error o si el error se basó en una infracción de directiva.

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

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

Id

Identificador generado por el sistema del anuncio.

Añadir: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para el anuncio en el campo Id. primario de tipos de registro dependientes, como Dynamic Search Ad Label. Esto se recomienda si va a agregar nuevos anuncios y nuevos registros dependientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

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

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene el anuncio.

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

Ruta de acceso 1

La primera parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL para mostrar. La dirección URL de visualización, por ejemplo , www.contoso.com se generará a partir del dominio de la dirección URL de visualización. A continuación, si ha especificado un valor para Path 1 , se anexará a la dirección URL de presentación. Si también ha especificado un valor para Path 2, también se anexará a la dirección URL de presentación después de Path 1. Por ejemplo, si el dominio está contoso.com, Path 1 se establece en subdirectory1 y Path 2 está establecido en subdirectory2, la dirección URL mostrada se www.contoso.com/subdirectory1/subdirectory2.

La longitud máxima de entrada de la ruta de acceso es de 15 caracteres. Tenga en cuenta que para los idiomas con caracteres de ancho doble, por ejemplo, chino tradicional, la longitud máxima de entrada de la ruta de acceso es de 7 caracteres.

La ruta de acceso puede contener funciones if y countdown . Independientemente de la longitud total de todos los parámetros de cuenta atrás no sustitución, la cuenta atrás final mostrada siempre usará 8 caracteres del total de caracteres disponibles. Para obtener más información, consulte Personalizar la cuenta atrás.

La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n).

Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio.

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

Ruta de acceso 2

La segunda parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL de presentación. La dirección URL para mostrar, por ejemplo , www.contoso.com se generará a partir del dominio de la configuración de nivel de campaña de anuncios de búsqueda dinámica. A continuación, si ha especificado un valor para Path 1 , se anexará a la dirección URL de presentación. Si también ha especificado un valor para Path 2, también se anexará a la dirección URL de presentación después de Path 1. Por ejemplo, si el dominio está contoso.com, Path 1 se establece en subdirectory1 y Path 2 está establecido en subdirectory2, la dirección URL mostrada se www.contoso.com/subdirectory1/subdirectory2.

Solo puede especificar ruta de acceso 2 si también está establecida la ruta de acceso 1 .

La longitud máxima de entrada de la ruta de acceso es de 15 caracteres. Tenga en cuenta que para los idiomas con caracteres de ancho doble, por ejemplo, chino tradicional, la longitud máxima de entrada de la ruta de acceso es de 7 caracteres.

La ruta de acceso puede contener funciones if y countdown . Independientemente de la longitud total de todos los parámetros de cuenta atrás no sustitución, la cuenta atrás final mostrada siempre usará 8 caracteres del total de caracteres disponibles. Para obtener más información, consulte Personalizar la cuenta atrás.

La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n). Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio.

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

Países editores

Lista de países o regiones del publicador cuyas directrices editoriales no permiten el término especificado.

En un archivo masivo, la lista de países o regiones del publicador se delimita con un punto y coma (;).

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

Estado

Estado del anuncio.

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.

Texto

Primera parte de la descripción del anuncio.

El texto debe contener al menos una palabra.

La longitud máxima de entrada de la copia es de 90 caracteres. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, la longitud máxima de entrada de la copia es de 45 caracteres.

El texto puede contener funciones IF y countdown . Independientemente de la longitud total de todos los parámetros de cuenta atrás no sustitución, la cuenta atrás final mostrada siempre usará 8 caracteres del total de caracteres disponibles. Para obtener más información, consulte Personalizar la cuenta atrás.

El texto no puede contener el carácter de nueva línea (\n).

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

Parte 2 de texto

Segunda parte de la descripción del anuncio.

El texto debe contener al menos una palabra.

La longitud máxima de entrada de la copia es de 90 caracteres. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, la longitud máxima de entrada de la copia es de 45 caracteres.

El texto puede contener funciones IF y countdown . Independientemente de la longitud total de todos los parámetros de cuenta atrás no sustitución, la cuenta atrás final mostrada siempre usará 8 caracteres del total de caracteres disponibles. Para obtener más información, consulte Personalizar la cuenta atrás.

El texto no puede contener el carácter de nueva línea (\n).

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

Plantilla de seguimiento

Plantilla de seguimiento que se va a usar como valor predeterminado para la dirección URL especificada con FinalUrls.

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