Objeto de datos de anuncios: administración de campañas

Artículo
12/21/2023

Define el objeto base de un anuncio.

No intente crear una instancia de un anuncio. Puede crear uno o varios de los siguientes objetos que se derivan de él.

Sintaxis

<xs:complexType name="Ad" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q1:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q2:ArrayOfstring" />
    <xs:element xmlns:q3="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q3:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto Ad tiene los siguientes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Elemento	Descripción	Tipo de datos
AdFormatPreference	La preferencia de formato de anuncio se usa para indicar si prefieres que la copia del anuncio se muestre a los usuarios como un anuncio de búsqueda o audiencia. Los anuncios de búsqueda tienden a escribirse como una llamada a la acción, mientras que los anuncios de audiencia deben escribirse con un estilo más informativo. Aunque tienes la opción de usar anuncios de búsqueda como anuncios de audiencia, designar un anuncio como formato preferido de anuncios de audiencia te permite optimizar su mensajería para la entrega nativa. Los valores posibles son AudienceAd y All. Si se establece en Todo, el anuncio será apto para los formatos de anuncios de búsqueda y audiencia. Si se establece en AudienceAd, el anuncio solo será apto para el formato de anuncio de audiencia. La preferencia de formato de anuncio solo se admite para los objetos ExpandedTextAd y TextAd .	string
DevicePreference	Determina la preferencia del dispositivo para mostrar el anuncio. La preferencia de dispositivo solo se admite para los objetos AppInstallAd y TextAd .	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.	AdEditorialStatus
FinalAppUrls	Reservado para uso futuro.	Matriz AppUrl
FinalMobileUrls	Dirección URL de la página de aterrizaje móvil. Este elemento solo se admite para los objetos ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd y TextAd . No se admite con los objetos AppInstallAd, DynamicSearchAd y ProductAd .	matriz de cadenas
FinalUrls	La última o última dirección URL en la que se toma un usuario en última instancia, independientemente de si la ruta de acceso de hacer clic en la dirección URL final incluía o no las redirecciones. Este elemento solo se admite para los objetos AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd y TextAd . No se admite con los objetos DynamicSearchAd y ProductAd .	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. Este elemento solo se admite para los objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd y ResponsiveSearchAd . No se admite con los objetos ProductAd y TextAd .	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. 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
Id	Identificador único de Microsoft Advertising para el anuncio.	Largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa.	AdStatus
TrackingUrlTemplate	Plantilla de seguimiento que se usará como valor predeterminado para todas las direcciones URL de página de aterrizaje. Este elemento solo se admite para los objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd y TextAd . No se admite con el objeto ProductAd .	string
Tipo	Tipo del anuncio. Para obtener más información sobre los tipos de anuncios, consulte comentarios.	AdType
UrlCustomParameters	Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Este elemento solo se admite para los objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd y TextAd . No se admite con el objeto ProductAd .	CustomParameters

Observaciones

En el caso de Java y los lenguajes .NET, no establezca el elemento Type porque el valor viene determinado por si crea una instancia de un anuncio de texto expandido u otro tipo de anuncio.

Si genera soap manualmente, use el atributo type del <Ad> nodo (como se muestra en el ejemplo siguiente) para especificar el tipo de anuncio.

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="ExpandedTextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil="true" />
    <FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:string>https://www.contoso.com/womenshoesale</a:string>
    </FinalUrls>
    <Path1>seattle</Path1>
    <Path2>shoe sale</Path2>
    <Text>Find New Customers & Increase Sales!</Text>
    <TextPart2>Start Advertising on Contoso Today.</TextPart2>
    <TitlePart1>Contoso</TitlePart1>
    <TitlePart2>Fast & Easy Setup</TitlePart2>
    <TitlePart3>Top Rated</TitlePart3>
  </Ad>
</Ads>

Requisitos

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

Usado por

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Compartir a través de