Partager via

Enregistrement d’annonces réactives - En bloc

  • Article

Définit une publicité réactive qui peut être téléchargée et chargée dans un fichier en bloc.

Les publicités réactives s’ajustent automatiquement pour s’adapter aux tailles et aux formes des formats d’annonces d’audience. Ces annonces fonctionnent mieux avec du texte informatif plutôt qu’avec des appels à l’action.

Remarque

Cette fonctionnalité est actuellement disponible aux États-Unis, au Canada, au Royaume-Uni et en Australie. Si vous publiez des annonces aux États-Unis, au Canada, au Royaume-Uni ou en Australie et que vous souhaitez participer aux annonces publicitaires, contactez le support technique.

Remarque

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

Vous pouvez télécharger tous les enregistrements d’annonces réactives dans le compte en incluant la valeur DownloadEntity de ResponsiveAds dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute une nouvelle annonce réactive si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

Si vous utilisez les sdk Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger et télécharger l’objet BulkResponsiveAd , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Pour un enregistrement d’annonce réactive , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Groupe d’annonces

Nom du groupe d’annonces qui contient la publicité.

Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Groupe d’annonces .

Nom de l’entreprise

Nom de l’entreprise.

Selon le positionnement de votre publicité d’audience, le nom de votre entreprise peut apparaître dans votre 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é.
Supprimer: En lecture seule

Appel à l’action

Une raison brève et percutant pour que les clients cliquent sur votre annonce dès maintenant.

Voici l’appel aux actions disponibles pour les annonces multimédias de recherche :

Appel à l’action
Agir maintenant
Appliquer maintenant
Parier maintenant
Enchérir maintenant
Réserver une voiture
Réserver hôtel
Réserver maintenant
Générer maintenant
Acheter maintenant
Discuter maintenant
Comparer
Contactez-nous
Concessionnaires
Itinéraire
Donner
Télécharger
Envoyer un e-mail maintenant
S’inscrire maintenant
Fichier maintenant
Rechercher un travail
Rechercher le Magasin
Jeu gratuit
Devis gratuit
Essai gratuit
Obtenir le coupon
Obtenir des offres
Obtenir la démonstration
Obtenir maintenant
Obtenir l’offre
Obtenir un devis
Accéder à la démonstration
Inscrivez-vous
En savoir plus
Écouter maintenant
S'identifier
Commandez maintenant
Jouer au jeu
Lire maintenant
Post-travail
Inscrire
Renouveler maintenant
Louer une voiture
Louer maintenant
Réorganiser
Réserver
Enregistrer maintenant
Planification
Voir la démonstration
Menu Afficher
Voir les modèles
Voir l’offre
Voir les offres
Voir la vente
Vendre maintenant
Acheter maintenant
Showtimes
Connexion
S’inscrire
Commencer maintenant
Subscribe
Version d’évaluation
Essayer maintenant
Afficher les voitures
Afficher la démonstration
Afficher les plans
Visiter le magasin
Votez maintenant
Regarder
Regarder plus
Visionner maintenant

Ajouter: Non applicable aux publicités d’audience.
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Call To Action Langauge

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.

Voici les langages d’appel à l’action disponibles pour les annonces multimédias de recherche :

Appel à l’action
Language.Albanais
Langue.Arabe
Language.Bosnian
Language.Bulgare
Language.Croate
Language.Czech
Language.Danish
Language.Dutch
Language.English
Language.Estonien
Language.Finnish
Language.Français
Language.German
Language.Greek
Language.Hebrew
Language.Hungarian
Language.Islandais
Language.Italian
Language.Japanese
Language.Letton
Language.Lituanien
Language.Macedonian
Language.Maltese
Language.Norwegian
Language.Polish
Language.Portuguese
Language.Romanian
Language.Russian
Language.Serb
Language.Slovaque
Language.Slovène
Language.Spanish
Language.Swedish
Language.TraditionalChinese
Language.Turkish

Ajouter: Non applicable aux publicités d’audience ; Obligatoire 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é.
Supprimer: En lecture seule

Campagne

Nom de la campagne qui contient le groupe d’annonces et l’annonce.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Mettre à jour: Optionnel
Supprimer: En lecture seule

Paramètre personnalisé

Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.

Dans un fichier en bloc, la liste des paramètres personnalisés est mise en forme comme suit.

  • Mettez en forme chaque paire de paramètres personnalisés en tant que Clé=Valeur, par exemple {_promoCode}=PROMO1.

  • Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètres personnalisés que vous incluez, et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque paire clé-valeur est délimitée par un point-virgule et un espace (« ; »), par exemple {_promoCode}=PROMO1 ; {_season}=été.

  • Une clé ne peut pas contenir de point-virgule. Si une valeur contient un point-virgule, elle doit être placée dans une séquence d’échappement en tant que « \ ; ». En outre, si la valeur contient une barre oblique inverse, elle doit également être placée dans une séquence d’échappement en tant que « \ ».

  • La clé ne peut pas dépasser 16 UTF-8 octets, et la valeur ne peut pas dépasser 250 UTF-8 octets. La clé est obligatoire et la valeur est facultative. La taille maximale de la clé n’inclut pas les accolades et le trait de soulignement, c’est-à-dire « { », « _ » et « } ».

    Remarque

    Avec le service en bloc, la clé doit être mise en forme avec des accolades environnantes et un trait de soulignement de début. Par exemple, si la clé est promoCode, elle doit être mise en forme comme {_promoCode}. Avec le service Gestion des campagnes, vous ne pouvez pas spécifier les accolades et le trait de soulignement environnants.

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 tous les paramètres personnalisés, définissez ce champ sur delete_value. Le mot clé delete_value supprime le paramètre précédent. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver et omettez ceux que vous ne souhaitez pas conserver. Le nouvel ensemble de paramètres personnalisés remplace tout jeu de paramètres personnalisé précédent.
Supprimer: En lecture seule

Descriptions

En fonction de l’emplacement de votre annonce d’audience, ce texte s’affiche sous ou à côté du titre long ou court de votre 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 limite supérieure des descriptions est de 5. La longueur de la chaîne est limitée à 90 caractères. Le format de données des titres est inclus dans l’exemple JSON ci-dessous.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Ajouter: Obligatoire pour les publicités d’audience et les annonces multimédias. Non applicable aux 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é. Supprimer: En lecture seule

État de l’appel éditorial

Détermine si vous pouvez faire appel des problèmes détectés par la révision éditoriale.

Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur Description
Appelable La question éditoriale peut faire l’objet d’un appel.
AppelPending La question éditoriale peut faire l’objet d’un appel et un appel a été déposé.
NotAppealable La question éditoriale n’est pas appelable.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Emplacement éditorial

Composant ou propriété de l’annonce qui a échoué à la révision éditoriale.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Code de raison éditorial

Code qui identifie la raison de l’échec. Pour obtenir la liste des codes de raison possibles, consultez Codes de raison éditorial.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

État éditorial

État éditorial de l’annonce.

Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur Description
Actif L’annonce a fait l’objet d’une révision éditoriale.
ActiveLimited L’annonce a fait l’objet d’une révision éditoriale dans un ou plusieurs marchés, et un ou plusieurs éléments de la publicité font l’objet d’une révision éditoriale dans un autre marché. Par exemple, l’annonce a passé une révision éditoriale pour le Canada et est toujours en attente d’examen aux États-Unis.
Désapprouvé L’annonce a échoué à la révision éditoriale.
Inactif Un ou plusieurs éléments de l’annonce font l’objet d’une révision éditoriale.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Terme éditorial

Terme qui a échoué à la révision éditoriale.

Ce champ n’est pas défini si une combinaison de termes a provoqué l’échec ou si l’échec est basé sur une violation de stratégie.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

URL finale

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 les URL finales et les URL mobiles finales . 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.

  • Chaque URL est délimitée par un point-virgule et un espace (« ; »).

  • L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple « {lpurl} ».

  • Chaque URL doit être une URL bien formée commençant par http:// ou https://.

  • Si vous spécifiez les URL Final Mobile, vous devez également spécifier l’URL finale.

Notez également que si les champs Modèle de suivi ou Paramètre personnalisé sont définis, au moins une URL finale est requise.

Remarque

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

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Suffixe d’URL final

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 ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule
k

Titre

Il s’agit de l’un des deux titres possibles qui pourraient apparaître dans vos publicités vidéo.

Étant donné que les publicités vidéo sont réactives, nous avons besoin de plusieurs titres afin qu’ils puissent servir de manière flexible dans 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.
Supprimer: En lecture seule

Gros titres

Étant donné que les publicités d’audience sont réactives, nous avons besoin de plusieurs titres afin qu’ils puissent servir de manière flexible dans une variété d’éditeurs et de placements.

La limite supérieure des titres est 15. Et la longueur de chaque titre est limitée à 30 caractères. Le format de données des titres est inclus dans l’exemple JSON ci-dessous.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Ajouter: Obligatoire pour les publicités multimédias et les publicités d’audience. Non applicable aux 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é.
Supprimer: En lecture seule

ID

Identificateur généré par le système de la publicité.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour la publicité peut ensuite être référencé dans le champ Id parent des types d’enregistrements dépendants tels que l’étiquette d’annonce réactive. Cette option est recommandée si vous ajoutez de nouvelles annonces et de nouveaux enregistrements dépendants dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Des images

Étant donné que les publicités d’audience sont réactives, vous pouvez créer plusieurs ressources d’image de tailles et de proportions différentes afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements.

Remarque

À partir de maintenant, subType OriginalImage remplace le rôle de LandscapeImageMedia en tant qu’image par défaut pour ResponsiveAd of Audience Campaign.

Vous devez uniquement fournir une ressource OriginalImage, c’est-à-dire que ce champ doit contenir une ressource d’image 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.

Remarque

Si ce champ est défini (non vide), l’ID de média de l’image paysage et l’ID de média d’image carrée sont tous deux ignorés.

Les ressources d’image sont représentées dans le fichier en bloc sous la forme d’une chaîne JSON. Neuf images sont incluses dans l’exemple JSON ci-dessous, et seule l’image d’origine subType n’est pas rognée. est id une propriété de l’élément multimédia, tandis que , cropHeightcropWidth, cropYcropX, et subType sont des propriétés du lien de ressource, c’est-à-dire la relation entre la ressource et l’annonce. Pour plus d’informations, consultez cropHeight, cropWidth, cropX, cropY, id et subType ci-dessous.

[{
	"id": 1234567890000,
	"subType": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Remarque

Dans le fichier en bloc séparé par des virgules, vous devez entourer la liste des liens de ressources, chaque clé d’attribut et chaque valeur de chaîne d’attribut avec un ensemble supplémentaire de guillemets doubles, par exemple, la chaîne JSON ci-dessus serait écrite en tant que « [{""id" » :1234567890000,"subType" » :"OriginalImage""},{"id" » :1234567890000,"subType » :"LandscapeLogoMedia" » ,"cropX » :0,"cropY" » :0,"cropWidth » :512,""cropHeight" » :128},{"id" » :1234567890000, « "subType" » :""SquareLogoMedia »,"cropX » :0,"cropY" » :0,"cropWidth" » :128,""cropHeight" » :128},{"id » :1234567890000,""subType" » :""SquareImageMedia »,""cropX » :286,"cropY" » :0,"cropWidth" » :628,""cropHeight" » :628},{"id" » :1234567890000,,"""subType" » :""ImageMedia169X100" »,"cropX » :70,""cropY » :0,""cropWidth" » :1061,""cropHeight" » :628},{"id" » :1234567890000,""subType » :""ImageMedia93X100" »,"cropX" » :308,""cropY" » :0,""cropWidth" » :584,""cropHeight" » :628},{"id" » :1234567890000,"subType" » :""ImageMedia15X10" »,"cropX » :129,""cropY » :0,""cropWidth » :942,""cropHeight" » :942 » :"cropHeight" » ::628},{"id » :1234567890000,"subType » :""ImageMedia155X100" »,"cropX » :114,""cropY" » :0,"cropWidth" » :973,""cropWidth" » :973,"""cropHeight" » :628},{"id » :1234567890000,"subType » :""ImageMedia133X100" »,""cropX » :183,""cropY » :0,""cropWidth" » :835,"cropHeight » :628},{"id » :1234567890000,"subType » :""ImageMedia178X100" »,"cropX » :41,"cropY » :0," » cropWidth » :1118,""cropHeight" » :628},{""id" » :1234567890000,"subType » :""ImageMedia172X100" »,"cropX » :60,"cropY » :0,"cropWidth" » :1080,""cropHeight" » :628}] ».

Étant donné l’exemple JSON de réponse de chargement ci-dessus, 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.
  • Que l’OriginalImage ait ou non ses propres paramètres de rognage, Microsoft Advertising utilise la vraie hauteur de l’image associée 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. Même si le lien de ressource OriginalImage avait été créé avec des paramètres de rognage, par exemple, 703 x 368, les paramètres de rognage des ressources d’image générées automatiquement sont basés sur les dimensions complètes de l’OriginalImage (là encore, ce serait 1200 x 628 dans cet exemple).
  • Bien que dans Bing Ads API version 12, vous puissiez utiliser l’ID multimédia d’image paysage et l’ID de média d’image carrée, ces champs sont déconseillés et seront supprimés dans une version ultérieure. Vous disposez de plus de flexibilité et de contrôle des images rognées via le champ Images .

cropHeight

Nombre de pixels à utiliser à partir de la source de la ressource d’image, à partir de la position cropY et à la hausse.

cropWidth

Nombre de pixels à utiliser à partir de la source de la ressource d’image, en commençant à la position cropX et en se déplaçant vers la droite.

cropX

À partir du coin inférieur gauche de la source de ressource d’image, il s’agit du nombre de pixels à ignorer à droite sur l’axe X avant d’appliquer le cropWidth.

cropY

À partir du coin inférieur gauche de la source de ressource d’image, il s’agit du nombre de pixels à ignorer vers le haut sur l’axe des y avant d’appliquer le cropHeight.

id

L’attribut id est un identificateur Microsoft Advertising unique pour la ressource dans un compte Microsoft Advertising.

Le même identificateur de ressource d’image peut être utilisé plusieurs fois dans la même annonce pour différents proportions, et peut également être utilisé par plusieurs annonces dans le même compte Microsoft Advertising. L’identificateur de la ressource d’image avec SubType défini sur LandscapeImageMedia est utilisé pour tous les sous-types de ressources d’image générés automatiquement dans la même annonce. 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.

Vous pouvez créer des images pour les publicités réactives via l’enregistrement en bloc d’images . Vous pouvez ensuite utiliser l’identificateur de média retourné comme ID de ressource d’image. Les proportions de l’image que vous avez ajoutée doivent être prises en charge pour le sous-type de ressource d’image.

Sous-type

L’attribut subType représente les proportions de cette ressource d’image.

Les proportions réelles de l’image stockée dans la bibliothèque multimédia au niveau du compte peuvent varier, tant que les dimensions résultantes entraînent les proportions attendues par sous-type. Si vous ne spécifiez pas de paramètres de rognage, le service rogne automatiquement à la zone maximale possible à partir du centre de l’image. Par exemple, avec une image de 1000 x 1 000 pixels, pour les proportions de 1,91:1, le paramètre de rognage automatique sera cropWidth=1000, cropHeight=524, cropX=0 et cropY=238.

Le sous-type doit être défini sur « Logo » si l’image est associée à une annonce en tant que « LandscapeLogoMedia » ou « SquareLogoMedia ».

Les valeurs de sous-type possibles sont OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 et ImageMedia153X100. De nouveaux sous-types peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.

Sous-type Proportions Dimensions minimales en pixels
OriginalImage S/O 703 largeur x 368 hauteur
LandscapeLogoMedia 4:1 512 largeur x 128 hauteur
SquareLogoMedia 1:1 128 largeur x 128 hauteur
LandscapeImageMedia 1.91:1 300 largeur x 157 hauteur
SquareImageMedia 1:1 114 largeur x 114 hauteur
ImageMedia4x1 4:1 608 largeur x 152 hauteur
ImageMedia1x2 1:2 470 largeur x 940 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

Ajouter: Obligatoire si l’ID de média de l’image paysage est vide. Seuls les id et subType sont requis pour chaque lien de ressource.
Mettre à jour: Optionnel. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez ce champ vide. Si vous définissez ce champ, toutes les images précédemment liées à cette annonce seront remplacées. Si vous définissez ce champ, seuls l’id et le sous-type sont requis pour chaque lien de ressource.
Supprimer: En lecture seule

URL de suivi des impressions

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 est délimitée par un point-virgule et un espace (« ; »).

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.

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 ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Id de média de l’image paysage

Identificateur de la ressource d’image utilisée pour les images de paysage avec des proportions de 1,91:1 qui peuvent apparaître dans vos publicités d’audience.

Les proportions des supports d’image stockés peuvent varier, tant que les paramètres de rognage de la ressource d’image entraînent les proportions prises en charge pour ce champ. Pour confirmer les proportions effectives avec les paramètres de rognage, utilisez le champ Images .

Remarque

Bien que dans Bing Ads API version 12, vous puissiez utiliser l’ID multimédia de l’image paysage et SquareImageMediaId, ces champs sont déconseillés et seront supprimés dans une version ultérieure. Vous disposez de plus de flexibilité et de contrôle des images rognées via le champ Images .

Ajouter: Obligatoire si Images n’est pas défini. Si Images est défini, ce champ est ignoré.
Mettre à jour: Optionnel. Si Images est défini, ce champ est ignoré. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Id de média du logo paysage

Ce champ est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API Bing Ads.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Titre long

Il s’agit de l’un des deux titres possibles qui pourraient apparaître dans vos annonces d’audience.

Étant donné que les publicités d’audience sont réactives, nous avons besoin de plusieurs titres afin qu’ils puissent servir de manière flexible dans une variété d’éditeurs et de placements.

La longueur de la chaîne est limitée à 90 caractères.

Ajouter: Obligatoire
Mettre à jour: Obsolescent. Utilisez les titres longs à la place.
Supprimer: En lecture seule

Titres longs

Étant donné que les publicités d’audience sont réactives, nous avons besoin de plusieurs titres afin qu’ils puissent servir de manière flexible dans une variété d’éditeurs et de placements.

La limite supérieure des titres longs est 5. Et la longueur de chaque titre est limitée à 90 caractères. Le format de données des titres longs est inclus dans l’exemple JSON ci-dessous.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Ajouter: Obligatoire pour les publicités multimédias et les publicités d’audience. Non applicable aux 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é.
Supprimer: En lecture seule

Chaîne de titre long

Les titres étant le texte le plus important qui apparaît dans votre annonce, vous devez tirer le meilleur parti des caractères disponibles. Étant donné que les publicités d’audience sont réactives, nous avons besoin de plusieurs titres afin qu’ils puissent servir de manière flexible dans une variété d’éditeurs et de placements.

La longueur de chaque titre est limitée à 90 caractères. Le format de données des titres longs est inclus dans l’exemple JSON ci-dessous.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Ajouter: Obligatoire pour les publicités d’audience et les publicités vidéo. 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é.
Supprimer: En lecture seule

URL finale mobile

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 les URL finales et les URL mobiles finales . 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.

  • Chaque URL est délimitée par un point-virgule et un espace (« ; »).

  • L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple « {lpurl} ».

  • Chaque URL doit être une URL bien formée commençant par http:// ou https://.

  • Si vous spécifiez les URL Final Mobile, vous devez également spécifier l’URL finale.

Remarque

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

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 ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système du groupe d’annonces qui contient la publicité.

Ce champ en bloc est mappé au champ Id de l’enregistrement groupe d’annonces .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de groupe d’annonces existant ou un identificateur négatif égal au champ Id de l’enregistrement de groupe d’annonces parent. Cette option est recommandée si vous ajoutez de nouvelles annonces à un nouveau groupe d’annonces dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Groupe d’annonces .

Pays d’éditeur

Liste des pays ou régions de l’éditeur dont les directives éditoriales n’autorisent pas le terme spécifié.

Dans un fichier en bloc, la liste des pays ou régions de l’éditeur est délimitée par un point-virgule (;).

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

État

État de l’annonce.

Les valeurs possibles sont Active, Paused ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

ID de média d’image carrée

Identificateur de la ressource d’image utilisée pour les images carrées avec des proportions de 1:1 qui peuvent apparaître dans vos publicités d’audience.

Les proportions des supports d’image stockés peuvent varier, tant que les paramètres de rognage de la ressource d’image entraînent les proportions prises en charge pour ce champ. Pour confirmer les proportions effectives avec les paramètres de rognage, utilisez le champ Images .

Remarque

Bien que dans Bing Ads API version 12, vous puissiez utiliser l’ID multimédia de l’image paysage et SquareImageMediaId, ces champs sont déconseillés et seront supprimés dans une version ultérieure. Vous disposez de plus de flexibilité et de contrôle des images rognées via le champ Images .

Ajouter: Optionnel. Si Images est défini, ce champ est ignoré et Microsoft Advertising crée automatiquement une ressource d’image carrée en rognant la ressource d’image LandscapeImageMedia. Si Images n’est pas défini et si vous ne définissez pas ce champ, Microsoft Advertising crée automatiquement une ressource d’image carrée en rognant l’ID multimédia de l’image paysage.
Mettre à jour: Optionnel. Si Images est défini, ce champ est ignoré et Microsoft Advertising crée automatiquement une ressource d’image carrée en rognant la ressource d’image LandscapeImageMedia. Si Images n’est pas défini et si vous ne définissez pas ce champ, Microsoft Advertising crée automatiquement une ressource d’image carrée en rognant l’ID multimédia de l’image paysage. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

ID de média du logo carré

Ce champ est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API Bing Ads.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Texte

Selon l’emplacement de votre annonce vidéo, ce texte s’affiche sous ou à côté du titre long ou court de votre 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 d’audience ou aux publicités multimédias. 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).
Supprimer: En lecture seule

Modèle de suivi

Modèle de suivi à utiliser comme valeur par défaut pour l’URL spécifiée avec FinalUrls.

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 ceux définis 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 vérifie pas s’il existe des 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} n’est défini au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de l’annonce, 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 ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule