Objet de données ResponsiveAd - Gestion des campagnes

Article
02/17/2024

Format d’annonce réactif pour les annonces d’audience et les annonces multimédias.

L’objet ResponsiveAd est utilisé pour les annonces multimédias dans le réseau de recherche et les publicités d’audience dans le réseau d’audience Microsoft. Pour plus d’informations sur les principaux différateurs, consultez la section remarques ci-dessous.

Remarque

Les publicités réactives en double sont autorisées dans le même groupe d’annonces.

Syntaxe

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet ResponsiveAd contient les éléments suivants : BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.

Élément	Description	Type de données
BusinessName	Nom de l’entreprise. Le nom de votre entreprise peut apparaître dans votre annonce, en fonction du placement de l’annonce. La longueur de la chaîne est limitée à 25 caractères. Ajouter: Obligatoire Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	chaîne
CallToAction	Une raison brève et percutant pour que les clients cliquent sur votre annonce dès maintenant. Cela s’affiche sur le bouton d’appel à l’action. Ajouter: Non applicable aux publicités d’audience ; Requis pour les publicités multimédias Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	CallToAction
CallToActionLanguage	Langue dans laquelle l’appel à l’action sera servi. L’appel à l’action sera toujours servi dans cette langue, quels que soient les paramètres linguistiques de la campagne. Ajouter: Non applicable aux publicités d’audience ; Requis pour les publicités multimédias Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	LanguageName
Descriptions	Descriptions affichées sous le chemin d’accès dans votre annonce. Pour optimiser les impressions dans tous les formats d’annonce, les descriptions peuvent ne pas toujours s’afficher dans votre annonce. 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 1 et 5 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). Ajouter: Obligatoire pour les publicités multimédias et les publicités d’audience. Non applicable aux publicités vidéo. 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
Titre	Les titres étant le texte le plus important qui apparaît dans votre annonce, vous devez tirer le meilleur parti des caractères disponibles. Nous avons besoin de plusieurs titres afin que l’annonce puisse s’afficher de manière flexible sur une variété d’éditeurs et de placements. La longueur de la chaîne est limitée à 30 caractères. Ajouter: Obligatoire pour les publicités vidéo. Non applicable aux publicités multimédias et aux publicités d’audience. Mettre à jour: Optionnel. Déconseillé pour les publicités multimédia et d’audience. Utilisez les titres à la place.	chaîne
Titres	Les titres étant le texte le plus important qui apparaît dans votre annonce, vous devez tirer le meilleur parti des caractères disponibles. Nous avons besoin de plusieurs titres afin que l’annonce puisse s’afficher de manière flexible sur une variété d’éditeurs et de placements. À 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 1 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). Ajouter: Obligatoire pour les publicités multimédias et les publicités d’audience. Non applicable aux publicités vidéo. 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
Images	Ressources d’image avec des tailles et des proportions différentes afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements. Incluez un ou plusieurs objets AssetLink qui contiennent chacun un Objet ImageAsset avec des paramètres SubType et rognage qui correspondent aux proportions souhaitées. Pour plus d’informations, consultez les remarques ci-dessous. Ajouter: Obligatoire Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous incluez des images pendant la mise à jour, toutes les images précédemment définies seront remplacées.	Tableau AssetLink
ImpressionTrackingUrls	URL pour les pixels de suivi d’impression 1x1. Chaque pixel signale les impressions de Microsoft Audience Network à votre outil de création de rapports publicitaires tiers. Vous pouvez inclure jusqu’à 2 URL de suivi des impressions pour chaque annonce réactive. Chaque URL doit être accessible. 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. Pour chaque impression du réseau d’audience Microsoft, Microsoft effectue un test ping sur l’URL pour activer le suivi des impressions dans votre outil de création de rapports publicitaires tiers. Le suivi des utilisateurs de niveau avancé tel que le suivi des conversions ou le suivi basé sur les cookies ou les adresses IP n’est pas pris en charge. Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur ImpressionTrackingUrls dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetAdsByAdGroupId, GetAdsByEditorialStatus et GetAdsByIds . Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer les URL de suivi d’impression, définissez cet élément sur un tableau de chaînes vide.	tableau de chaînes
Ligne d’en-tête longue	Pour les campagnes d’audience, LongHeadline est le plus long des deux titres d’annonces réactives possibles.	AssetLink
Lignes d’en-têtes longues	Vous devez définir entre 1 et 5 titres longs. Le texte de chaque titre doit contenir au moins un mot. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n). Si la campagne parente est associée à un magasin et que vous spécifiez LongHeadlines, vous devez également spécifier Titres, Descriptions et Images. Ajouter : facultatif si la campagne parente s’associe à un magasin, obligatoire si sa campagne parente n’est pas associée à un magasin. Utilise LongHeadlineString si vide. Mise à jour : facultatif. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez une valeur pour cet élément, tous les titres précédemment liés à ce groupe de ressources seront remplacés. Si la campagne parente est associée à un magasin et que vous définissez cet élément sur une liste vide, le paramètre précédent est supprimé.	Tableau AssetLink
LongHeadlineString	Les titres étant le texte le plus important qui apparaît dans votre annonce, vous devez tirer le meilleur parti des caractères disponibles. Nous avons besoin de plusieurs titres afin que l’annonce puisse s’afficher de manière flexible sur une variété d’éditeurs et de placements. La longueur de la chaîne est limitée à 90 caractères. Ajouter: Optionnel. Ignoré lorsque LongHeadlines est fourni. Nous remplirons LongHeadlines avec LongHeadlineString si LongHeadlines est vide. Non applicable aux publicités multimédias. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	chaîne
Texte	Ce texte s’affiche en dessous ou en regard du titre long ou court de votre annonce, en fonction du placement de l’annonce. Vous avez plus d’espace de caractères à utiliser dans le texte de l’annonce que dans le titre. Ainsi, une fois que l’image et le titre ont l’attention d’un client potentiel, le texte de l’annonce doit les convaincre de cliquer dessus. Qu’est-ce qui distingue votre produit ou service ? Le texte doit contenir au moins un mot. La longueur de la chaîne est limitée à 90 caractères. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n). Ajouter: Obligatoire pour les publicités vidéo. Non applicable aux publicités multimédias et aux publicités d’audience. Mettre à jour: Facultatif pour les publicités vidéo. Utilisez plutôt descriptions pour les annonces d’audience ou les annonces multimédias (déconseillées).	chaîne
VerifiedTrackingSettings	VerifiedTrackingSetting concerne les paramètres de mesure tiers. Cela vous permet de suivre la visibilité, la sécurité de la marque et les métriques de trafic non valides via un fournisseur de vérification tiers, tel qu’Integral Ad Science. Cette fonctionnalité est disponible pour les publicités vidéo natives, d’affichage et en ligne à l’aide de la stratégie d’enchère CPM. Remarque : Actuellement, IAS est le seul fournisseur pris en charge (vendorName), mais d’autres fournisseurs de vérification seront bientôt disponibles. L’exemple ci-dessous concerne IAS. Il existe 3 paires clé-valeur pour IAS : « vendorName » « advertiserEntityID » (ID client de votre fournisseur de vérification) « publisherEntityID » (ID de création de rapports pour votre fournisseur de vérification) Exemple (requis pour IAS) : vendorName : « IAS » advertiserEntityID : « 12345678 » publisherEntityID : « 12345678 »	VerifiedTrackingSetting
Vidéos	Ressources vidéo avec différentes tailles et proportions afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements. Incluez un ou plusieurs objets AssetLink qui contiennent chacun un VideoAsset avec un SubType. Ajouter: Requis pour les publicités vidéo Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous incluez des vidéos lors d’une mise à jour, toutes les vidéos précédemment définies seront remplacées.	Tableau AssetLink

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

Éléments hérités

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

L’objet ResponsiveAd 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 à ResponsiveAd 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. 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 liste vide, le paramètre précédent est supprimé.	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
État	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 ResponsiveAd lorsque vous récupérez une annonce 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

Remarques

L’objet ResponsiveAd est utilisé pour les annonces multimédias dans le réseau de recherche et les publicités d’audience dans le réseau d’audience Microsoft.

La plupart des propriétés prises en charge sont les mêmes, mais voici quelques-uns des principaux différérateurs.

Pour les publicités d’audience, vous devez définir BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines et Descriptions.
Pour les publicités multimédias, vous devez définir BusinessName, CallToAction, CallToActionLanguage, Descriptions, Titres, Images et LongHeadlines.

Remarque

Les données des images sont approvisionnées via l’opération AddMedia . Vous pouvez utiliser les types MIME GIF, JPEG ou PNG. Les images avec animation ne sont pas prises en charge. Bien que vous puissiez uniquement ajouter des médias avec quelques proportions via l’opération AddMedia , vous pouvez utiliser les paramètres de rognage ImageAsset pour déterminer les proportions effectives dans le contexte de chaque assetlink publicitaire réactif. Les proportions de l’image stockée sont inchangées dans la bibliothèque multimédia au niveau du compte.

La taille de fichier maximale est de 5 Mo. La largeur et la hauteur maximales en pixels sont de 2592 et 2048 indépendamment, et vous devez toujours conserver l’un des proportions prises en charge. Par exemple, si la ressource d’image avec le sous-type LandscapeImageMedia a une largeur de 2592, la hauteur doit être 1357.

Images publicitaires multimédias

Pour les publicités multimédias, vous allez créer plusieurs ressources d’image avec différentes tailles et proportions. Vous devez ajouter au moins 1 image avec des proportions de 1,91 :1 et 1 image avec des proportions de 1 :1.

Dans l’élément Images , incluez un ou plusieurs objets AssetLink . Chaque lien de ressource contient un objet ImageAsset avec SubType défini sur l’une des valeurs de chaîne du tableau ci-dessous.

Sous-type	Proportions	Dimensions minimales en pixels
LandscapeImageMedia	1.91:1	703 largeur x 368 hauteur
ImageMedia4x1	4:1	608 largeur x 152 hauteur
SquareImageMedia	1:1	470 largeur x 470 hauteur
ImageMedia1x2	1:2	470 largeur x 940 hauteur

Logos d’annonces multimédias

Pour les publicités multimédias, vous allez créer plusieurs ressources de logo avec des tailles, des proportions et des paramètres de rognage différents afin qu’elles puissent s’afficher de manière flexible dans la liste des miniatures.

Sous-type	Proportions	Dimensions minimales en pixels
SquareImageMedia	1:1	128 largeur x 128 hauteur
ImageMedia4x1	4:1	512 largeur x 128 hauteur

Images publicitaires d’audience

Pour les publicités d’audience, vous allez créer plusieurs ressources d’image avec des tailles, des proportions et des paramètres de rognage différents afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements.

Remarque

Les sous-types d’image et dans le tableau ci-dessous pour les publicités d’audience version 2 et sont actuellement en version pilote.

Sous-type	Proportions	Dimensions minimales en pixels
OriginalImage	S/O	703 largeur x 368 hauteur
LandscapeImageMedia	1.91:1	300 largeur x 157 hauteur
SquareImageMedia	1:1	114 largeur x 114 hauteur
ImageMedia201X100	2.01:1	612 largeur x 304 hauteur
ImageMedia120X100	1.2:1	300 largeur x 250 hauteur
ImageMedia200X100	2:1	200 largeur x 100 hauteur
ImageMedia169X100	1.69:1	628 largeur x 372 hauteur
ImageMedia124X100	1.24:1	104 largeur x 84 hauteur
ImageMedia153X100	1.53:1	306 largeur x 200 hauteur

Remarque

Les sous-types d’image dans le tableau ci-dessous concernent les publicités d’audience version 1.

Sous-type	Dimensions minimales en pixels
LandscapeImageMedia	703 largeur x 368 hauteur Aspect radio 1.91 :1
SquareImageMedia	300 largeur x 300 hauteur Aspect radio 1 :1
ImageMedia169X100	622 largeur x 368 hauteur Aspect radio 1.69 :1
ImageMedia93X100	311 largeur x 333 hauteur Aspect radio 0.93 :1
ImageMedia15X10	300 largeur x 200 hauteur Aspect radio 1.5 :1
ImageMedia155X100	300 largeur x 194 hauteur Aspect radio 1.55 :1
ImageMedia133X100	100 largeur x 75 hauteur Aspect radio 1.33 :1
ImageMedia178X100	624 largeur x 350 hauteur Aspect radio 1.78 :1
ImageMedia172X100	300 largeur x 174 hauteur Aspect radio 1.72 :1

Vous devez uniquement fournir une ressource d’image OriginalImage par défaut (l’image par défaut était précédemment LandscapeImageMedia). Dans l’élément Images , incluez un AssetLink qui contient un ImageAsset avec SubType défini sur OriginalImage. Les dimensions recommandées pour l’OriginalImage sont 1200 largeur x 628 hauteur. Si vous le souhaitez, vous pouvez inclure des liens de ressources supplémentaires, c’est-à-dire une ressource d’image pour chaque sous-type pris en charge. Pour tous les sous-types de ressources d’image que vous ne définissez pas explicitement, Microsoft Advertising crée automatiquement des liens de ressources d’image en rognant l’originalImage.

Étant donné l’exemple de réponse GetAdsByAdGroupId ci-dessous, notez ce qui suit :

Le même identificateur de ressource d’image (par exemple, 1234567890000) est utilisé pour tous les sous-types de ressources d’image générés automatiquement. Que vous laissons ou non Microsoft Advertising générer automatiquement les images rognées, l’ID n’a pas besoin d’être unique parmi les ressources d’image liées à la même annonce.
Étant donné que la publicité de cet exemple a été créée sans paramètres de rognage pour le sous-type de ressource image OriginalImage, toutes les ressources d’image sont rognées, à l’exception de l’image associée OriginalImage.
Microsoft Advertising utilise les paramètres de rognage de l’OriginalImage pour tous les paramètres de rognage par défaut. Dans cet exemple, la hauteur de rognage de toutes les ressources d’image générées par le système est de 628, et nous pouvons déduire que le format OriginalImage (sous-type OriginalImage) avec des proportions de 1,91 :1 a une largeur et une hauteur de 1200 x 628. Les paramètres de rognage des ressources d’image générées automatiquement sont basés sur les paramètres de rognage du lien de ressource OriginalImage.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

Configuration requise

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

Partager via

Objet de données ResponsiveAd - Gestion des campagnes

Syntaxe

Éléments

Éléments hérités

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

Remarques

Images publicitaires multimédias

Logos d’annonces multimédias

Images publicitaires d’audience

Configuration requise

Ressources supplémentaires