Objet de données publicitaires - Gestion des campagnes

Article
12/21/2023

Définit l’objet de base d’une publicité.

N’essayez pas d’instancier une annonce. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

Syntaxe

<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>

Éléments

L’objet Ad contient les éléments suivants : AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Élément	Description	Type de données
AdFormatPreference	La préférence de format d’annonce est utilisée pour indiquer si vous préférez ou non que la copie de l’annonce soit présentée aux utilisateurs sous la forme d’une annonce de recherche ou d’audience. Les annonces de recherche ont tendance à être écrites comme un appel à l’action, tandis que les publicités d’audience doivent être écrites dans un style plus informationnel. Bien que vous ayez la possibilité d’utiliser des annonces de recherche comme publicités d’audience, la conception d’une annonce comme format préféré des publicités d’audience vous permet d’optimiser sa messagerie pour la distribution native. Les valeurs possibles sont AudienceAd et All. Si elle est définie sur Tous, l’annonce est éligible aux formats d’annonces de recherche et d’audience. Si elle est définie sur AudienceAd, l’annonce est uniquement éligible au format d’annonce d’audience. La préférence de format d’annonce est prise en charge uniquement pour les objets ExpandedTextAd et TextAd .	chaîne
DevicePreference	Détermine la préférence d’appareil pour l’affichage de la publicité. La préférence d’appareil est prise en charge uniquement pour les objets AppInstallAd et TextAd .	Long
EditorialStatus	La révision éditoriale status de l’annonce, qui indique si la publicité est en attente d’examen, a été approuvée ou a été désapprouvée.	AdEditorialStatus
FinalAppUrls	Réservé à une utilisation future.	Tableau AppUrl
FinalMobileUrls	URL de la page d’accueil mobile. Cet élément est pris en charge uniquement pour les objets ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd et TextAd . Il n’est pas pris en charge avec les objets AppInstallAd, DynamicSearchAd et ProductAd .	tableau de chaînes
FinalUrls	Dernière URL ou dernière URL où un utilisateur est finalement pris, que le chemin d’accès clic vers l’URL finale inclue ou non des redirections. Cet élément est pris en charge uniquement pour les objets AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd et TextAd . Il n’est pas pris en charge avec les objets DynamicSearchAd et ProductAd .	tableau de chaînes
FinalUrlSuffix	Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques. Cet élément est pris en charge uniquement pour les objets AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd et ResponsiveSearchAd . Il n’est pas pris en charge avec les objets ProductAd et TextAd .	chaîne
ForwardCompatibilityMap	Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API. Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.	Tableau KeyValuePairOfstringstring
ID	Identificateur Microsoft Advertising unique pour la publicité.	Long
Statut	Status de l’annonce. Vous pouvez définir la status publicitaire sur Actif ou Suspendu.	AdStatus
TrackingUrlTemplate	Modèle de suivi à utiliser par défaut pour toutes les URL de page d’accueil. Cet élément est pris en charge uniquement pour les objets AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd et TextAd . Il n’est pas pris en charge avec l’objet ProductAd .	chaîne
Type	Type de la publicité. Pour plus d’informations sur les types d’annonces, consultez les remarques.	AdType
UrlCustomParameters	Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL. Cet élément est pris en charge uniquement pour les objets AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd et TextAd . Il n’est pas pris en charge avec l’objet ProductAd .	CustomParameters

Remarques

Pour Java et les langages .NET, ne définissez pas l’élément Type , car la valeur est déterminée par l’instanciation d’une annonce de texte développée ou d’un autre type d’annonce.

Si vous générez manuellement le soap, utilisez l’attribut type du <Ad> nœud (comme indiqué dans l’exemple suivant) pour spécifier le type d’annonce.

<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>

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Partager via