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

Artículo
12/21/2023

Define una extensión de anuncio de aplicación que se puede incluir en un anuncio.

Puedes asociar una extensión de anuncio de aplicación 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 con tantas extensiones de anuncios de aplicación como decidas, hasta el número total de extensiones de anuncios de aplicación en tu cuenta.

Sintaxis

<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DestinationUrl" 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:q47="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q47:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q48: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 AppAdExtension tiene los siguientes elementos: AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descripción	Tipo de datos
AppPlatform	Plataforma de la aplicación. Entre los valores posibles se incluyen iOS, Android y Windows. Añadir: Obligatorio Actualizar: Obligatorio	string
AppStoreId	Identificador de aplicación proporcionado por el almacén de aplicaciones. Si la aplicación es nueva, espere entre 4 y 7 días antes de que el anuncio sea apto para entregarse. Añadir: Obligatorio Actualizar: Obligatorio	string
DestinationUrl	Dirección URL de la página web de descarga de la tienda de aplicaciones a la que se accede a los usuarios al hacer clic en el vínculo de extensión de la aplicación. La dirección URL puede contener cadenas de texto dinámicas como {keyword}. Para obtener una lista de los parámetros admitidos, consulte la sección Parámetros disponibles en el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?. La dirección URL puede contener un máximo de 1024 caracteres. Si la dirección URL no especifica un protocolo, el sistema usa el protocolo HTTP cuando un usuario hace clic en el anuncio. Si la dirección URL especifica el protocolo HTTP al agregar un anuncio, el servicio quitará la cadena de protocolo http:// (la cadena de protocolo HTTP no cuenta con el límite de 1024 caracteres); sin embargo, el servicio no quitará una cadena de protocolo HTTPS (https://) de la dirección URL. Añadir: Obligatorio Actualizar: Opcional	string
DisplayText	Texto que se muestra en la extensión de anuncio de la aplicación. El texto puede contener un máximo de 35 caracteres. Añadir: Obligatorio Actualizar: Opcional	string
FinalAppUrls	Reservado para uso futuro.	Matriz AppUrl
FinalMobileUrls	Reservado para uso futuro.	matriz de cadenas
FinalUrls	Reservado para uso futuro.	matriz de cadenas
FinalUrlSuffix	Reservado para uso futuro.	string
TrackingUrlTemplate	Reservado para uso futuro.	string
UrlCustomParameters	Reservado para uso futuro.	CustomParameters

El objeto AppAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto AppAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de AppAdExtension 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. Añadir: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	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 AppAdExtension cuando se recupera una extensión de anuncio de aplicación. 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