Objet de données ResponsiveSearchAd - Gestion des campagnes

Article
12/21/2023

Format d’annonce réactive pour les annonces textuelles dans le réseau de recherche.

Remarque

Les annonces de recherche réactive en double sont autorisées dans le même groupe d’annonces.

Les annonces de recherche réactives vous permettent de définir entre 3 et 15 titres d’annonce uniques (également appelées « titres ») et 2 à 4 descriptions d’annonces au sein d’une même annonce. À partir de là, Bing sélectionne la combinaison de titre et de description la plus pertinente pour chaque requête donnée et l’utilisateur de recherche correspondant. En permettant à Bing AI de sélectionner le titre et la description les plus pertinents pour chaque requête, nous nous assurons que le bon message arrive pour chacun de vos clients potentiels, au bon moment, sur tous les signaux d’intention possibles.

Les annonces réactives affichées aux utilisateurs semblent identiques aux annonces textuelles développées, c’est-à-dire jusqu’à 3 titres (parties de titre via des annonces textuelles développées) et 2 descriptions (parties de texte via des annonces textuelles développées). Pour optimiser les impressions dans tous les formats d’annonce, les descriptions peuvent ne pas toujours être affichées dans votre annonce.

Lorsque vous créez des annonces de recherche réactives, les listes Descriptions et Titres sont stockées sous forme de ressources de texte qui peuvent être partagées par n’importe quelle annonce de recherche réactive au sein du compte. Par exemple, si « Intégration transparente » est une ressource de texte, vous remarquerez qu’elle a le même identificateur de ressource pour toutes les annonces liées à « Intégration transparente » dans le même compte Microsoft Advertising. Les identificateurs de ressources ne sont pas inclus dans la réponse AddAds ou UpdateAds . Avec le service Gestion des campagnes, la seule façon d’obtenir les identificateurs de ressources consiste à récupérer les publicités que vous avez créées. Vous pouvez obtenir les identificateurs de ressources pour les descriptions et les titres en récupérant les annonces dans un appel de service ultérieur, par exemple via GetAdsByAdGroupId. Avec le service en bloc, les identificateurs de ressources sont inclus dans le fichier de résultat du chargement en bloc.

Remarque

Les annonces de recherche réactives 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 de recherche réactives.

Syntaxe

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet ResponsiveSearchAd contient les éléments suivants : Descriptions, Domaine, Titres, Path1, Path2.

Élément	Description	Type de données
Descriptions	Liste des descriptions que Bing peut utiliser pour optimiser la disposition des annonces. Pour optimiser les impressions dans tous les formats d’annonce, les descriptions peuvent ne pas toujours être affichées dans votre annonce. À moins que vous n’épinglez l’une des descriptions à une position spécifique, Bing optimise dynamiquement la disposition des annonces avec les meilleurs titres et descriptions pour la requête de recherche de l’utilisateur. Du point de vue d’un modèle de données, les désriptions et les titres sont stockés en tant que ressources de texte, c’est-à-dire un TextAsset par AssetLink. La même ressource peut être utilisée par plusieurs annonces. Par exemple, si « Intégration transparente » est une ressource de texte, elle aura le même identificateur de ressource pour toutes les annonces du même compte Microsoft Advertising. Vous devez définir entre 2 et 4 descriptions. Le texte de chaque description 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. La longueur d’entrée maximale du texte de chaque description est de 1 000 caractères, y compris les chaînes de texte dynamiques, et sur ces 1 000, pas plus de 90 caractères finaux sont autorisés après la substitution. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur 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, y compris les chaînes de texte dynamiques, et sur ces 500, pas plus de 45 caractères finaux sont autorisés après la substitution. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur 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 texte ne peut pas contenir le caractère de nouvelle ligne (\n). Le texte peut contenir des fonctions IF . Ajouter: Obligatoire Mettre à jour: Optionnel. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez cet élément, toutes les descriptions précédemment liées à cette annonce seront remplacées.	Tableau AssetLink
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
Titres	Liste des titres d’annonces que Bing peut utiliser pour optimiser la disposition des annonces. À moins que vous n’épinglez l’un des titres à une position spécifique, Bing optimise dynamiquement la disposition des annonces avec les meilleurs titres et descriptions pour la requête de recherche de l’utilisateur. Du point de vue d’un modèle de données, les désriptions et les titres sont stockés en tant que ressources de texte, c’est-à-dire un TextAsset par AssetLink. La même ressource peut être utilisée par plusieurs annonces. Par exemple, si « Intégration transparente » est une ressource de texte, elle aura le même identificateur de ressource pour toutes les annonces du même compte Microsoft Advertising. Vous devez définir entre 3 et 15 titres. Le texte de chaque 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. La longueur d’entrée maximale du texte de chaque titre est de 1 000 caractères, y compris les chaînes de texte dynamiques, et sur ces 1 000, pas plus de 30 caractères finaux sont autorisés après la substitution. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 30 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, y compris les chaînes de texte dynamiques, et sur ces 500, pas plus de 15 caractères finaux sont autorisés après substitution. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 15 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). Le texte peut contenir des fonctions IF . Ajouter: Obligatoire Mettre à jour: Optionnel. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez cet élément, tous les titres précédemment liés à cette annonce seront remplacés.	Tableau AssetLink
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 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. Le chemin d’accès peut contenir des fonctions IF . 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 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. Le chemin d’accès peut contenir des fonctions IF . 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 ResponsiveSearchAd contient des éléments hérités.

Éléments hérités

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

L’objet ResponsiveSearchAd 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 à ResponsiveSearchAd 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	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 ResponsiveSearch lorsque vous récupérez une annonce de recherche réactive. 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

Partager via