Objet de données ExpandedTextAd - Gestion des campagnes

Définit une annonce de texte développée.

Ce format d’annonce fonctionne en toute transparence sur les appareils mobiles, tablettes et ordinateurs de bureau afin que vous puissiez vous concentrer davantage sur la création de votre copie d’annonce plus longue et l’optimisation du texte de votre annonce afin de mieux impliquer vos clients avant qu’ils ne cliquent sur votre annonce.

Remarque

  • Mettez à niveau vos annonces textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
  • Les annonces textuelles développées existantes continueront à être diffusées et vous serez en mesure d’afficher des rapports sur leurs performances.
  • Vous pourrez toujours suspendre, activer ou supprimer vos annonces textuelles développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces textuelles développées entraînent une CampaignServiceAdTypeInvalid erreur.
  • En savoir plus sur cette modification.

Remarque

Les annonces textuelles développées ne peuvent être créées que dans les campagnes de recherche où AdGroupType est défini sur « SearchStandard ». Si adGroupType est défini sur « SearchDynamic », le groupe d’annonces ne prend pas en charge les annonces textuelles développées.

La combinaison des éléments FinalUrls, Path1, Path2, Text, Text, TextPart2, TitlePart1, TitlePart2 et TitlePart3 rend l’annonce de texte développé unique.

Syntaxe

<xs:complexType name="ExpandedTextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart3" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet ExpandedTextAd contient les éléments suivants : Domain, Path1, Path2, Text, TextPart2, TitlePart1, TitlePart2, TitlePart3.

Élément Description Type de données
Domaine URL qui sera affichée au lieu de l’URL finale. L’URL finale sera toujours utilisée pour l’URL de la page d’accueil.

Réservé à une utilisation pilote limitée, par exemple les clients pharmaceutiques.

La partie domaine de l’URL associée aux chaînes du chemin d’accès 1 et du chemin d’accès 2 ne peut pas dépasser 67 caractères.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne
Chemin d’accès1 Première partie du chemin d’accès facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. La partie domaine de votre URL d’affichage, par exemple https://www.contoso.com , sera générée à partir du domaine de votre URL finale (élément FinalUrls ). Ensuite, si vous avez spécifié une valeur pour Path1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour Path2, elle sera également ajoutée à l’URL d’affichage après Path1. Par exemple, si votre FinalUrls contient https://www.contoso.com, Path1 est défini sur sous-répertoire1 et Path2 est défini sur sous-répertoire2, l’URL affichée est https://www.contoso.com/subdirectory1/subdirectory2.

Le chemin d’accès peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le chemin d’accès 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 ?.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 15 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur du domaine d’URL final et des chemins combinés dépasse 67 caractères.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Vous ne pouvez pas entrer plus de 7 caractères finaux (texte non dynamique). L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur du domaine d’URL final et des chemins combinés dépasse 33 caractères. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le chemin d’accès ne peut pas contenir la barre oblique (/) ou les caractères de nouvelle ligne (\n).

Si le chemin d’accès comprend un espace, il est remplacé par un trait de soulignement (_) lorsque l’annonce est affichée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne
Chemin d’accès 2 Deuxième partie du chemin facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. La partie domaine de votre URL d’affichage, par exemple https://www.contoso.com , sera générée à partir du domaine de votre URL finale (élément FinalUrls ). Ensuite, si vous avez spécifié une valeur pour Path1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour Path2, elle sera également ajoutée à l’URL d’affichage après Path1. Par exemple, si votre FinalUrls contient https://www.contoso.com, Path1 est défini sur sous-répertoire1 et Path2 est défini sur sous-répertoire2, l’URL affichée est https://www.contoso.com/subdirectory1/subdirectory2.

Vous ne pouvez spécifier Path2 que si Path1 est également défini.

Le chemin d’accès peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le chemin d’accès 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 ?.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 15 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur du domaine d’URL final et des chemins combinés dépasse 67 caractères.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Vous ne pouvez pas entrer plus de 7 caractères finaux (texte non dynamique). L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur du domaine d’URL final et des chemins combinés dépasse 33 caractères. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le chemin d’accès ne peut pas contenir la barre oblique (/) ou les caractères de nouvelle ligne (\n).

Si le chemin d’accès comprend un espace, il est remplacé par un trait de soulignement (_) lorsque l’annonce est affichée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne
Texte Première partie de la description de l’annonce qui peut s’afficher dans votre annonce.

Pour optimiser les impressions dans tous les formats d’annonce, la description peut ne pas toujours s’afficher dans votre annonce.

Le texte doit contenir au moins un mot. Pour une utilisation efficace des ressources, nous vous recommandons d’utiliser des chaînes de texte dynamiques telles que {mot clé} au lieu de créer une copie d’annonce pour chaque mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Le texte peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 90 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des deux parties de texte dépasse 180 caractères après la substitution de texte dynamique.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 500 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 45 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des deux parties de texte dépasse 90 caractères après la substitution de texte dynamique. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Obligatoire
Mettre à jour: Optionnel
chaîne
TextPart2 Deuxième partie de la description de l’annonce qui peut s’afficher dans votre annonce.

Pour optimiser les impressions dans tous les formats d’annonce, la description peut ne pas toujours s’afficher dans votre annonce.

Le texte doit contenir au moins un mot. Pour une utilisation efficace des ressources, nous vous recommandons d’utiliser des chaînes de texte dynamiques telles que {mot clé} au lieu de créer une copie d’annonce pour chaque mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Le texte peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 90 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des deux parties de texte dépasse 180 caractères après la substitution de texte dynamique.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 500 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 45 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des deux parties de texte dépasse 90 caractères après la substitution de texte dynamique. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne
TitlePart1 Première partie du titre de l’annonce. Les trois parties de titre sont automatiquement séparées par un espace, une barre verticale et un espace (« | ») lorsque l’annonce est affichée. Chaque partie du titre doit contenir au moins un mot. Pour une utilisation efficace des ressources, nous vous recommandons d’utiliser des chaînes de texte dynamiques telles que {mot clé} au lieu de créer une copie d’annonce pour chaque mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Le titre peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 30 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 90 caractères après la substitution de texte dynamique.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 500 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 15 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 45 caractères après la substitution de texte dynamique. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le titre ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Obligatoire
Mettre à jour: Optionnel
chaîne
TitlePart2 Deuxième partie du titre de l’annonce. Les trois parties de titre sont automatiquement séparées par un espace, une barre verticale et un espace (« | ») lorsque l’annonce est affichée. Chaque partie du titre doit contenir au moins un mot. Pour une utilisation efficace des ressources, nous vous recommandons d’utiliser des chaînes de texte dynamiques telles que {mot clé} au lieu de créer une copie d’annonce pour chaque mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Le titre peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 30 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 90 caractères après la substitution de texte dynamique.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 500 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 15 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 45 caractères après la substitution de texte dynamique. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le titre ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Obligatoire
Mettre à jour: Optionnel
chaîne
TitlePart3 Troisième partie du titre de l’annonce. Les trois parties de titre sont automatiquement séparées par un espace, une barre verticale et un espace (« | ») lorsque l’annonce est affichée. Chaque partie du titre doit contenir au moins un mot. Pour une utilisation efficace des ressources, nous vous recommandons d’utiliser des chaînes de texte dynamiques telles que {mot clé} au lieu de créer une copie d’annonce pour chaque mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Le titre peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

La longueur d’entrée maximale est de 1 000 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 30 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 90 caractères après la substitution de texte dynamique.

Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 500 caractères si vous incluez des chaînes de texte dynamiques. Pas plus de 15 caractères finaux (texte non dynamique) peuvent être entrés. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur des trois parties de titre dépasse 45 caractères après la substitution de texte dynamique. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de la campagne ou du groupe d’annonces. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

Le titre ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne

L’objet ExpandedTextAd contient des éléments hérités.

Éléments hérités

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

L’objet ExpandedTextAd dérive de l’objet Ad et hérite des éléments suivants : AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Les descriptions ci-dessous sont spécifiques à ExpandedTextAd 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 textuelles développées 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 développée par groupe d’annonces qui ne préfère pas les publicités d’audience. Sinon, la copie de toutes les annonces textuelles développées 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: Optionnel. Si vous ne définissez pas cet élément, par défaut, la préférence de format d’annonce est définie sur Tout.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
chaîne
DevicePreference Non pris en charge pour ce type d’annonce. 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: En lecture seule
Mettre à jour: En lecture seule
AdEditorialStatus
FinalAppUrls Non pris en charge pour ce type d’annonce. Tableau AppUrl
FinalMobileUrls URL de la page d’accueil mobile.

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.

Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL mobile finale.

Ajouter: Optionnel
Mettre à jour: Optionnel
tableau de chaînes
FinalUrls URL de la page d’accueil.

La partie domaine de l’URL associée aux chaînes du chemin d’accès 1 et du chemin d’accès 2 ne peut pas dépasser 67 caractères.

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.

Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL finale.

Ajouter: Obligatoire
Mettre à jour: Optionnel
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.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
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 de la publicité.

Ajouter: En lecture seule
Mettre à jour: Obligatoire et Read-Only
Long
Statut Status de l’annonce.

Vous pouvez définir la status publicitaire sur Actif ou Suspendu.

Ajouter: Optionnel
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: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.
chaîne
Type Type de la publicité. Cette valeur est ExpandedText lorsque vous récupérez une annonce de texte développé. Pour plus d’informations sur les types d’annonces, consultez remarques sur les objets de données publicitaires.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
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