Objet de données TextAd - Gestion des campagnes

Article
12/21/2023

Définit une annonce de texte.

Importante

À compter d’avril 2020, la distribution d’annonces texte standart (STA) n’est pas prise en charge.

Les annonces de texte standard ont été déconseillées en faveur des annonces de texte développées (EXTAs). La prise en charge de l’ajout et de la mise à jour d’annonces texte standard a pris fin le 31 juillet 2017. Désormais, les annonceurs peuvent obtenir et supprimer, mais ne peuvent plus ajouter de nouveaux contrats STA ou mettre à jour les annonces texte standard existantes. Une exception à la règle est que vous pouvez toujours mettre à jour le status STA, par exemple de Actif à Suspendu. Sinon, les tentatives d’ajout ou de mise à jour des MDA entraînent l’erreur CampaignServiceAdTypeInvalid .

Syntaxe

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet TextAd contient les éléments suivants : DestinationUrl, DisplayUrl, Text, Title.

Élément	Description	Type de données
DestinationUrl	URL de la page web vers laquelle l’utilisateur doit être connecté lorsqu’il clique sur la publicité. L’URL peut contenir des paramètres dynamiques tels que {MatchType}. Pour obtenir la liste des paramètres pris en charge, consultez l’article d’aide microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?. L’URL peut contenir un maximum de 1 024 caractères. Si l’URL ne spécifie pas de protocole, le système utilise le protocole HTTP lorsqu’un utilisateur clique sur la publicité. Si l’URL spécifie le protocole HTTP lorsque vous ajoutez une publicité, le service supprime la chaîne de protocole http:// (la chaîne de protocole HTTP ne compte pas dans la limite de 1 024 caractères) ; Toutefois, le service ne supprime pas de chaîne de protocole HTTPS (https://) de l’URL. Important: Si vous utilisez actuellement des URL de destination, vous devez les remplacer par des URL finales. Pour plus d’informations, consultez Suivi des URL avec des URL mises à niveau. Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL de destination. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne
DisplayUrl	URL à afficher dans l’annonce. Le sous-répertoire de l’URL d’affichage peut contenir des chaînes de texte dynamiques telles que {mot clé} ; toutefois, le nom d’hôte de l’URL ne peut pas contenir de texte dynamique. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique. La longueur d’entrée maximale de l’URL est de 200 caractères et peut contenir des chaînes de texte dynamiques. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 35 caractères après la substitution de texte dynamique. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne
Texte	Copie de l’annonce. La copie doit contenir au moins un mot. La copie et le titre de l’annonce combinés doivent totaler au moins trois mots. Le texte peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique. La longueur d’entrée maximale de la copie est de 300 caractères et peut contenir des chaînes de texte dynamiques. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 71 caractères après la substitution de texte dynamique. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, le texte est limité à 38 caractères après substitution. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n). Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne
Titre	Titre de l’annonce. Le titre doit contenir au moins un mot. La copie et le titre de l’annonce combinés doivent totaler au moins trois mots. Le titre peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique. La longueur d’entrée maximale du titre est de 80 caractères et peut contenir des chaînes de texte dynamiques. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 25 caractères après la substitution de texte dynamique. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, le titre est limité à 15 caractères après substitution. Le titre ne peut pas contenir le caractère de nouvelle ligne (\n). Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne

L’objet TextAd a des éléments hérités.

Éléments hérités

Éléments hérités d’Ad

L’objet TextAd dérive de l’objet Ad et hérite des éléments suivants : AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Les descriptions ci-dessous sont spécifiques à TextAd et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Ad .

É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 texte 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. IMPORTANT: Vous devez définir au moins une annonce de texte par groupe d’annonces qui ne préfère pas les publicités d’audience, sinon la copie de toutes les annonces textuelles sera éligible pour les annonces de recherche et d’audience. 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. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne
DevicePreference	Cet élément détermine si la préférence est que les annonces textuelles soient affichées sur les appareils mobiles ou sur tous les appareils. Pour spécifier une préférence pour les appareils mobiles, définissez cet élément sur 30001. Pour spécifier tous les appareils, définissez cet élément sur 0 (zéro) ou laissez l’élément zéro. Par défaut, cet élément est nul. Vous devez définir au moins une annonce de texte par groupe d’annonces qui n’est pas recommandée pour les appareils mobiles, sinon la publicité sera éligible pour tous les appareils. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	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. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	AdEditorialStatus
FinalAppUrls	Non pris en charge pour les annonces textuelles.	Tableau AppUrl
FinalMobileUrls	URL de la page d’accueil mobile. Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL mobile finale. Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales. - La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères. - Vous pouvez spécifier jusqu’à 10 éléments pour FinalUrls et FinalMobileUrls ; Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle. - L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}. - Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://. - Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls. - Vous ne pouvez pas spécifier FinalMobileUrls si la préférence d’appareil est définie sur mobile. Notez également que pour les objets TextAd , vous ne pouvez pas spécifier FinalMobileUrls si DevicePreference est défini sur 30001 (mobile). Ajouter: Non pris en charge Mettre à jour: Non pris en charge	tableau de chaînes
FinalUrls	URL de la page d’accueil. Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL finale. Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales. - La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères. - Vous pouvez spécifier jusqu’à 10 éléments pour FinalUrls et FinalMobileUrls ; Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle. - L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}. - Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://. - Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls. - Vous ne pouvez pas spécifier FinalMobileUrls si la préférence d’appareil est définie sur mobile. Notez également que si l’élément TrackingUrlTemplate ou UrlCustomParameters de cette publicité est défini, au moins une URL finale est requise. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	tableau de chaînes
FinalUrlSuffix	Non pris en charge pour les annonces textuelles.	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é. Ajouter: Non pris en charge Mettre à jour: Obligatoire et en lecture seule	Long
Statut	Status de l’annonce. Vous pouvez définir la status publicitaire sur Actif ou Suspendu. Ajouter: Non pris en charge Mettre à jour: Optionnel	AdStatus
TrackingUrlTemplate	Modèle de suivi à utiliser par défaut pour toutes les URL de page d’accueil. Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ? - Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent celles définies pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité. - La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères. - Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}. - Microsoft Advertising ne valide pas l’existence de paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est `https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}` et que ni {_season} ni {_promocode} ne sont définis au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	chaîne
Type	Type de la publicité. Cette valeur est Text lorsque vous récupérez une annonce de texte. Pour plus d’informations sur les types d’annonces, consultez remarques sur les objets de données publicitaires. Ajouter: Non pris en charge Mettre à jour: Non pris en charge	AdType
UrlCustomParameters	Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL. Microsoft Advertising accepte les 8 premiers objets CustomParameter que vous incluez dans l’objet CustomParameters , et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque CustomParameter comprend des éléments Key et Value . Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Définissez l’élément UrlCustomParameters sur null ou vide pour conserver tous les paramètres personnalisés existants. Pour supprimer tous les paramètres personnalisés, définissez l’élément Parameters de l’objet CustomParameters sur null ou vide. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver dans l’élément Parameters de l’objet CustomParameters .	CustomParameters

Configuration requise

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

Partager via