Compartir a través de

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

  • Artículo

Define una extensión de anuncio con un vídeo y un botón de llamada a la acción.

Sintaxis

<xs:complexType name="VideoAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AlternativeText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q66="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q66:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q67="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q67:ArrayOfstring" />
        <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ThumbnailId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="ThumbnailUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <xs:element minOccurs="0" name="VideoId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto VideoAdExtension tiene los siguientes elementos: ActionText, AlternativeText, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Name, ThumbnailId, ThumbnailUrl, TrackingUrlTemplate, UrlCustomParameters, VideoId.

Elemento Descripción Tipo de datos
ActionText Texto de acción del recurso de vídeo. string
AlternativeText Texto alternativo del recurso de vídeo. string
DisplayText Texto para mostrar del recurso de vídeo. string
FinalAppUrls Para uso futuro. Matriz AppUrl
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.
- No puede especificar FinalMobileUrls si DevicePreference está establecido en 30001 (móvil).

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, se quita 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.
- No puede especificar FinalMobileUrls si DevicePreference está establecido en 30001 (móvil).

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, se quita la configuración anterior.		 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.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, se quita la configuración anterior.		 string
Nombre Nombre del recurso de vídeo. string
ThumbnailId Identificador del recurso en miniatura. largo
ThumbnailUrl Dirección URL de miniatura del recurso de vídeo.

Agregar: no compatible
Actualización: no compatible		 string
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.

Agregar: Opcional
Actualizar: Opcional. Si establece este elemento null, 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 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 . 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.

Agregar: Opcional
Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior.		 CustomParameters
VideoId Identificador del vídeo. largo

El objeto VideoAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto VideoAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de VideoAdExtension 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 Este elemento determina si la preferencia es que la extensión de anuncio se muestre en dispositivos móviles o en todos los dispositivos.

Para especificar una preferencia para dispositivos móviles, establezca este elemento en 30001.

Para especificar todos los dispositivos, establezca este elemento en 0 (cero) o deje el elemento nil. De forma predeterminada, este elemento será nulo.

Este elemento solo es aplicable a los tipos AppAdExtension y SitelinkAdExtension .		 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.

Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para este objeto.		 Matriz KeyValuePairOfstringstring
Identificación Identificador único de Microsoft Advertising de la extensión de anuncio. 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. 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. AdExtensionStatus
Tipo Tipo de extensión de anuncio.

Para obtener más información, vea Comentarios.		 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.		 int

Requisitos

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