Objet de données DynamicSearchAd - Gestion des campagnes

Article
12/21/2023

Définit une annonce de recherche dynamique.

Avec les annonces de recherche dynamique, le titre et l’URL d’affichage sont générés automatiquement en fonction du domaine et de la langue du site web que vous souhaitez cibler. La combinaison des éléments Path1, Path2 et Text rend la publicité de recherche dynamique unique. Si vous le souhaitez, vous pouvez fournir un titre statique à l’aide de flux de page.

Remarque

Cette fonctionnalité est actuellement disponible dans les pays ou régions suivants : Albanie (AL), Andorre (AD), Argentine (AR), Aruba, Australie (AU), Autriche (AT), Bahamas (BS), Bangladesh(BD), Belgique (BE), Bolivie (BO), Bosnie-Herzégovine (BA), Brésil (BR), Brunéi(BN), Bulgarie (BG), Canada (CA), Îles Caïmans (KY), Chili(CL), Colombie(CO), Costa Rica(CR), Croatie (HR), Chypre (CY), République tchèque (CZ), Danemark (DK), Dominique(DM), République dominicaine(DO), Équateur(CE), El Salvador(SV), Estonie (EE), Fidji (FJ), Finlande (FI), France (FR), Français Guiana (GF), Français Polynésie (PF), Allemagne (DE), Grèce (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haïti (HT), Honduras (HN), Hongrie (HU), Islande (IS), Inde (IN), Indonésie (ID), Irlande (IE), Italie (IT), Lettonie (LV), Liechtenstein (LI), Lituanie (LT), Luxembourg (LU), Malaisie (MY), Maldives (MV), Malte (MT), Martinique (MQ), Mexique (MX), Monaco (MC), Mongolie (MN), Monténégro (ME), Montserrat (MS), Népal (NP), Pays-Bas (NL), Nouvelle-Calédonie (NC), Nouvelle-Zélande (NZ), République de Macédoine du Nord (MK), Norvège (NO), Panama (PA), Paraguay (PY), Papouasie-Nouvelle-Guinée (PG), Pérou (PE), Philippines (PH), Pologne (PO), Portugal (PT), Porto Rico, Roumanie (RO), Saint-Marin (SM), Serbie (RS), Singapour (SG), Slovaquie (SK), Slovénie (SI), Afrique du Sud (ZA), Espagne (ES), Espagne (ES), Espagne (ES), Sri Lanka(LK), Suède (SE), Suisse (CH), Thaïlande (TH), Trinité-et-Tobago(TT), Turquie (TR), Vatican City (VA), Vietnam(VN), Royaume-Uni (Royaume-Uni), États-Unis (ÉTATS-UNIS), Uruguay (UY) et Venezuela (VE).

Les annonces de recherche dynamique ne peuvent être créées que dans les campagnes de recherche qui ont un DynamicSearchAdsSetting. L’élément ExperimentId de la campagne ne peut pas être défini et adGroupType doit être défini sur « SearchDynamic ».

Remarque

Vous ne pouvez plus ajouter, mettre à jour ou récupérer des campagnes qui prennent uniquement en charge les annonces de recherche dynamique. Le type de campagne de vos campagnes existantes a été mis à jour de « DynamicSearchAds » à « Search ». Les groupes d’annonces sont désormais considérés comme des groupes d’annonces « dynamiques », mais il n’y a aucun changement structurel, c’est-à-dire qu’ils contiennent les mêmes cibles automatiques et les mêmes annonces de recherche dynamique qu’auparavant.

Syntaxe

<xs:complexType name="DynamicSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <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:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet DynamicSearchAd contient les éléments suivants : Path1, Path2, Text, TextPart2.

Élément	Description	Type de données
Chemin d’accès1	Première partie du chemin d’accès facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. L’URL d’affichage, par exemple , www.contoso.com sera générée à partir du domaine de votre URL d’affichage. Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre domaine est contoso.com, que le chemin d’accès 1 est défini sur sous-répertoire1 et que le chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée est www.contoso.com/subdirectory1/subdirectory2. La longueur d’entrée maximale du chemin d’accès est de 15 caractères. Notez que pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale du chemin d’accès est de 7 caractères. 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 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	chaîne
Chemin d’accès 2	Deuxième partie du chemin facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. L’URL d’affichage, par exemple , www.contoso.com sera générée à partir du domaine de vos paramètres de niveau de campagne d’annonces de recherche dynamique. Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre domaine est contoso.com, que le chemin d’accès 1 est défini sur sous-répertoire1 et que le chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée est www.contoso.com/subdirectory1/subdirectory2. Vous ne pouvez spécifier Path2 que si Path1 est également défini. La longueur d’entrée maximale du chemin d’accès est de 15 caractères. Notez que pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale du chemin d’accès est de 7 caractères. 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 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	chaîne
Texte	Première partie de la description de l’annonce. Le texte doit contenir au moins un mot. La longueur d’entrée maximale de la copie est de 90 caractères. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, la longueur d’entrée maximale de la copie est de 45 caractères. 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. 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. Le texte doit contenir au moins un mot. La longueur d’entrée maximale de la copie est de 90 caractères. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, la longueur d’entrée maximale de la copie est de 45 caractères. 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. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n). Ajouter: Optionnel Mettre à jour: Optionnel	chaîne

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

Éléments hérités

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

L’objet DynamicSearchAd 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 à DynamicSearchAd 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	Non pris en charge pour ce type d’annonce.	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	Non pris en charge pour ce type d’annonce.	tableau de chaînes
FinalUrls	Non pris en charge pour ce type d’annonce.	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. Actuellement, il n’existe aucune paire clé/valeur de carte de compatibilité ascendante prise en charge pour les annonces de recherche dynamique.	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 DynamicSearch lorsque vous récupérez une annonce de recherche dynamique. 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