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

Artículo
12/21/2023

Las extensiones de vínculo de filtro emparejan un encabezado con entre 3 y 10 valores de texto en los que se puede hacer clic para informar más a los clientes sobre su empresa.

Puedes asociar una extensión de anuncio de vínculo de filtro a la cuenta o a campañas y grupos de anuncios de la cuenta. Cada entidad (cuenta, campaña o grupo de anuncios) se puede asociar a hasta 20 extensiones de anuncios de vínculo de filtro. Un anuncio de texto expandido solo incluirá una extensión de vínculo de filtro (un título con entre 3 y 10 valores en los que se puede hacer clic) por impresión.

Sintaxis

<xs:complexType name="FilterLinkAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdExtensionHeaderType" nillable="true" type="tns:AdExtensionHeaderType" />
        <xs:element xmlns:q58="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q58:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q59="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q59:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element xmlns:q60="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Texts" nillable="true" type="q60:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto FilterLinkAdExtension tiene los siguientes elementos: AdExtensionHeaderType, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, Texts, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descripción	Tipo de datos
AdExtensionHeaderType	El encabezado que se anexa con dos puntos (:) y precede a los valores del vínculo de filtro en el anuncio que se muestra. Los encabezados de vínculo de filtro se mostrarán en el idioma especificado. Por ejemplo, si desea el encabezado Amenities en inglés, debe establecer Language en Inglés y AdExtensionHeaderType en Amenities. Si desea el encabezado Ausstattung (Amenities in German) debe establecer language enalemán y AdExtensionHeaderType en Amenities. Añadir: Obligatorio Actualizar: Obligatorio	AdExtensionHeaderType
FinalMobileUrls	Dirección URL de la página de aterrizaje para dispositivos móviles. Las siguientes reglas de validación se aplican a las direcciones URL finales y las direcciones URL de Final Mobile. - La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres. - Puede especificar hasta 10 elementos de lista para FinalUrls y FinalMobileUrls; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos. - El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo {lpurl}. - Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://. - Si especifica FinalMobileUrls, también debe especificar FinalUrls. Añadir: 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 lista vacía, se eliminará la configuración anterior.	matriz de cadenas
FinalUrls	Dirección URL de la página de aterrizaje. Las siguientes reglas de validación se aplican a las direcciones URL finales y las direcciones URL de Final Mobile. - La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres. - Puede especificar hasta 10 elementos de lista para FinalUrls y FinalMobileUrls; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos. - El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo {lpurl}. - Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://. - Si especifica FinalMobileUrls, también debe especificar FinalUrls. Añadir: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	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. Esta característica solo está disponible para los clientes de la fase 3 del sufijo final url (GetCustomerPilotFeatures devuelve 636). Si no está en el piloto, esta propiedad se omitirá y no se devolverá ningún error. Añadir: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
Idioma	Idioma que desea usar para los encabezados de vínculo de filtro. Los encabezados de vínculo de filtro se mostrarán en el idioma especificado. Por ejemplo, si desea el encabezado Amenities en inglés, debe establecer Language en Inglés y AdExtensionHeaderType en Amenities. Si desea el encabezado Ausstattung (Amenities in German) debe establecer language enalemán y AdExtensionHeaderType en Amenities. Añadir: Obligatorio Actualizar: Obligatorio	string
Textos	Los valores de texto que siguen después del componente AdExtensionHeaderType del anuncio que se muestra. Cada valor de texto que elija puede tener una longitud máxima de 25 caracteres. Tenga en cuenta que para los caracteres chinos tradicionales, cada valor puede tener una longitud máxima de 12 caracteres. Añadir: Obligatorio Actualizar: Obligatorio	matriz de cadenas
TrackingUrlTemplate	Plantilla de seguimiento que se va a usar como valor predeterminado para todos los FinalUrls y FinalMobileUrls. 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 elemento en una cadena vacía (""), se eliminará la configuración anterior.	string
UrlCustomParameters	Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Microsoft Advertising aceptará los tres primeros objetos CustomParameter que incluya en el objeto CustomParameters y se omitirán los parámetros personalizados adicionales. Cada CustomParameter incluye elementos Key y Value . Para los clientes de la fase 3 de aumento de límite de parámetros personalizados piloto (GetCustomerPilotFeatures devuelve 635), Microsoft Advertising aceptará los primeros 8 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. Añadir: 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

El objeto FilterLinkAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto FilterLinkAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de FilterLinkAdExtension y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto AdExtension .

Elemento	Descripción	Tipo de datos
DevicePreference	No se admite para este tipo de extensión de anuncio.	Largo
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 cambios de compatibilidad de reenvío para el objeto AdExtension . Añadir: Solo lectura Actualizar: Solo lectura	Matriz KeyValuePairOfstringstring
Id	Identificador único de Microsoft Advertising de la extensión de anuncio. Añadir: Solo lectura Actualizar: Solo lectura y Obligatorio	Largo
Programar	Determina los intervalos de día y hora del calendario cuando la extensión del anuncio es apta para mostrarse en los anuncios. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, cualquier programación existente establecida para la extensión de anuncio permanecerá sin cambios. Si establece esto en cualquier objeto Schedule que no sea NULL, está reemplazando eficazmente la configuración de programación existente para la extensión de anuncio. Para quitar toda la programación, establezca este elemento en un objeto Schedule vacío.	Schedule
Estado	Estado de la extensión del anuncio. El valor siempre será Activo porque el servicio Administración de campañas no devuelve extensiones de anuncios eliminadas. Añadir: Solo lectura Actualizar: Solo lectura	AdExtensionStatus
Tipo	Tipo de la extensión de anuncio. Este valor es FilterLinkAdExtension cuando se recupera una extensión de anuncio de vínculo de filtro. Añadir: Solo lectura Actualizar: Solo lectura Para obtener más información sobre los tipos de extensión de anuncio, consulte comentarios sobre los objetos de datos de extensión de anuncios.	string
Versión	Realiza un seguimiento del número de veces que se ha actualizado la extensión del anuncio. La versión se establece en 1 cuando se crea la extensión del anuncio y aumenta en uno después de cada actualización. Añadir: No permitido Actualizar: No permitido	int

Requisitos

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