Objeto de datos DynamicSearchAd: Administración de campañas

Artículo
11/13/2024

Define un anuncio de búsqueda dinámica.

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 o regiones: 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), Nueva Caledonia (NC), 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), Turquía (TR), Ciudad del Vaticano (VA), Vietnam (VN), Reino Unido (REINO UNIDO), Estados Unidos (EE. UU.), Uruguay (UY) y Venezuela (VE).

Los anuncios de búsqueda dinámica solo se pueden crear dentro de las campañas de búsqueda que tienen dynamicSearchAdsSetting. No se puede establecer el elemento ExperimentId de la campaña y AdGroupType 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.

XML
JSON

<xs:complexType name="DynamicSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "DynamicSearch",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "Path1": "ValueHere",
  "Path2": "ValueHere",
  "Text": "ValueHere",
  "TextPart2": "ValueHere"
}

Elementos

El objeto DynamicSearchAd tiene los siguientes elementos: Path1, Path2, Text, TextPart2.

Elemento	Descripción	Tipo de datos
Ruta de acceso1	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. Agregar: Opcional Actualizar: Opcional	string
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 Path2 si path1 también está establecido. 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. Agregar: Opcional Actualizar: Opcional	string
Mensaje de 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). Agregar: Obligatorio Actualizar: Opcional	string
TextPart2	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). Agregar: Opcional Actualizar: Opcional	string

El objeto DynamicSearchAd tiene elementos heredados.

Elementos heredados

Elementos heredados de Ad

El objeto DynamicSearchAd deriva del objeto Ad y hereda los siguientes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Las descripciones siguientes son específicas de DynamicSearchAd y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Ad .

Elemento	Descripción	Tipo de datos
AdFormatPreference	No se admite para este tipo de anuncio.	string
DevicePreference	No se admite para este tipo de anuncio.	largo
EditorialStatus	El estado de revisión editorial del anuncio, que indica si el anuncio está pendiente de revisión, se ha aprobado o se ha desaprobado. Agregar: Solo lectura Actualizar: Solo lectura	AdEditorialStatus
FinalAppUrls	No se admite para este tipo de anuncio.	Matriz AppUrl
FinalMobileUrls	No se admite para este tipo de anuncio.	matriz de cadenas
FinalUrls	No se admite para este tipo de anuncio.	matriz de cadenas
FinalUrlSuffix	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. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.	string
ForwardCompatibilityMap	Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API. Actualmente no hay pares de clave y valor de mapa de compatibilidad con reenvío admitidos para los anuncios de búsqueda dinámica.	Matriz KeyValuePairOfstringstring
Identificación	Identificador único de Microsoft Advertising del anuncio. Agregar: Solo lectura Actualizar: Obligatorio y Read-Only	largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa. Agregar: Opcional Actualizar: Opcional	AdStatus
TrackingUrlTemplate	Plantilla de seguimiento que se usará como valor predeterminado para todas las direcciones URL de página de aterrizaje. 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. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.	string
Tipo	Tipo del anuncio. Este valor es DynamicSearch cuando se recupera un anuncio de búsqueda dinámica. Para obtener más información sobre los tipos de anuncios, consulte comentarios sobre los objetos de datos de anuncios. Agregar: Solo lectura Actualizar: Solo lectura	AdType
UrlCustomParameters	Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Microsoft Advertising aceptará los 8 primeros objetos CustomParameter que incluya en el objeto CustomParameters y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada CustomParameter incluye elementos Key y Value . Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca el elemento UrlCustomParameters en null o vacío para conservar los parámetros personalizados existentes. Para quitar todos los parámetros personalizados, establezca el elemento Parameters del objeto CustomParameters en null o vacío. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar en el elemento Parameters del objeto CustomParameters .	CustomParameters

Requisitos

Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Compartir a través de

Objeto de datos DynamicSearchAd: Administración de campañas

Elementos

Elementos heredados

Elementos heredados de Ad

Requisitos

Comentarios

Recursos adicionales