Compartir a través de

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

  • Artículo

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.

<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:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q48:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q49: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.

Agregar: 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.

Agregar: 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.

Agregar: 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.

Agregar: Obligatorio
Actualizar: Opcional		 string
FinalAppUrls 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.

Agregar: 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 .

Agregar: Solo lectura
Actualizar: Solo lectura		 Matriz KeyValuePairOfstringstring
Identificación Identificador único de Microsoft Advertising de la extensión de anuncio.

Agregar: 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.

Agregar: 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.

Agregar: 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.

Agregar: 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.

Agregar: No permitido
Actualizar: No permitido		 int

Requisitos

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