Enregistrement du groupe de ressources - En bloc

Article
02/08/2024

Définit un groupe de ressources qui peut être téléchargé et chargé dans un fichier en bloc.

Vous pouvez télécharger tous les enregistrements du groupe de ressources dans le compte en incluant la valeur DownloadEntity de AssetGroups 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.

Si vous utilisez les Kits de développement logiciel (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 BulkAssetGroup , 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.

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

Groupe de ressources
Nom de l’entreprise
Appel à l’action
Campagne
Client Id
Descriptions
État de l’appel éditorial
Emplacement éditorial
Code de raison éditorial
État éditorial
Terme éditorial
Date de fin
URL finale
Titres
Id
Images
Titres longs
URL finale mobile
Heure de modification
Parent Id
Chemin d’accès 1
Chemin d’accès 2
État
Date de début

Groupe de ressources

Nom du groupe de ressources.

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

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.

Les valeurs possibles sont ActNow, AddToCart, ApplyNow, Automated, BetNow, BidNow, BookACar, BookHotel, BookNow, BookTravel, Browse, BuildNow, Buy, BuyNow, ChatNow, Compare, ContactUs, Coupon, Dealers, Default, Directions, Donate, Download, EmailNow, EnrollNow, Explorer, FileNow, FindJob, FindStore, FreePlay, FreeQuote, FreeTrial, GetDeals, GetDemo, GetNow, GetOffer, GetQuote, GoToDemo, Install, JoinNow, LearnMore, ListenNow, LogIn, Message, NewCars, NoButton, OpenLink, OrderNow, PlayGame, PlayNow, PostJob, Register, RegisterNow, RenewNow, RentACar, RentNow, Reorder, Reserve, Sale, SaveNow, Schedule, SeeDemo, SeeMenu, SeeModels, SeeMore, SeeOffer, SeeOffers, SellNow, ShopNow, Showtimes, SignIn, SignUp, StartFree, StartNow, Subscribe, SwitchNow, TestDrive, TryNow, Unknown, UsedCars, ViewCars, ViewDemo, ViewNow, ViewPlans, VisitSite, VisitStore, VoteNow, Watch, WatchMore, WatchNow.

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

Campagne

Nom de la campagne qui contient le groupe de ressources.

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 Campagne .

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. 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 delete_value mot clé 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

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.

Du point de vue du modèle de données, les descriptions sont stockées sous forme de ressources de texte. 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 5 descriptions. Les descriptions sont représentées dans le fichier en bloc sous la forme d’une chaîne JSON. Deux descriptions sont incluses dans l’exemple JSON ci-dessous, et la première est épinglée à une position spécifique. Les id propriétés et text sont des propriétés de la ressource, tandis que les editorialStatus et assetPerformanceLabel sont des propriétés du lien de ressource, c’est-à-dire la relation entre l’élément multimédia et l’annonce. Pour plus d’informations, consultez assetPerformanceLabel, editorialStatus, id et texte ci-dessous.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Remarque

Voici un exemple de téléchargement en bloc dans lequel vous obtiendrez également des attributs en lecture seule, par exemple et ideditorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ajouter: Obligatoire si sa campagne parente ne s’associe pas à un magasin, facultatif si la campagne parente s’associe à un magasin. Si la campagne parente est associée à un magasin et que vous spécifiez Descriptions, vous devez également spécifier Titres, Lignes à têtes longues et Images. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
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 descriptions précédemment liées à cette annonce seront remplacées. Si vous spécifiez ce champ, une liste de 2 à 5 descriptions est requise. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
Supprimer: En lecture seule

assetPerformanceLabel

Cela vous permet de connaître les performances de la ressource.

L’attribut assetPerformanceLabel est en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Faible	Les performances de cette ressource sont faibles et nous vous recommandons de la remplacer pour améliorer les performances de votre publicité.
Good	Cette ressource fonctionne bien. Nous vous recommandons de conserver cette ressource et d’en ajouter d’autres pour améliorer les performances de votre publicité.
Idéale	Les performances de cette ressource sont parmi les meilleures et nous vous recommandons d’ajouter d’autres ressources similaires.
Unrated	Nous n’avons pas d’évaluation des performances pour cette ressource. Cela peut être dû au fait que la ressource est inactive, qu’elle ne contient pas suffisamment d’informations pour déterminer ses performances, ou qu’il n’y a pas assez de ressources similaires à comparer à celle-ci.
Formation	Les performances de la ressource font l’objet d’une évaluation active. Une fois l’évaluation terminée, l’évaluation des ressources sera Faible, Bonne, Meilleure ou Non notée.

editorialStatus

L’attribut editorialStatus est en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Actif	L’élément multimédia a fait l’objet d’une révision éditoriale.
ActiveLimited	L’actif a fait l’objet d’une révision éditoriale sur un ou plusieurs marchés, et un ou plusieurs éléments de l’actif font l’objet d’une révision éditoriale dans un autre marché. Par exemple, l’actif a passé un examen éditorial pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé	La ressource a échoué à la révision éditoriale.
Inactif	Un ou plusieurs éléments de la ressource font l’objet d’une révision éditoriale.
Inconnu	Réservé à une utilisation future.

id

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

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. Une fois que vous avez chargé une ressource texte, le fichier de résultats inclut l’identificateur de la ressource, par exemple , ""id:""123si la ressource est nouvelle ou existe déjà dans la bibliothèque de ressources du compte.

text

L’attribut de text chaque description doit contenir au moins un mot. La longueur d’entrée maximale de chaque attribut de description est de text 90 caractères. Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 45 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.

L’attribut text ne peut pas contenir le caractère newline (\n).

É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

Status éditorial du groupe d’actifs.

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

Valeur	Description
Actif	Le groupe de ressources a fait l’objet d’une révision éditoriale.
ActiveLimited	Le groupe d’actifs a fait l’objet d’une révision éditoriale sur un ou plusieurs marchés, et un ou plusieurs éléments du groupe d’actifs font l’objet d’une révision éditoriale sur un autre marché. Par exemple, le groupe d’actifs a passé un examen éditorial pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé	La révision éditoriale du groupe de ressources a échoué.
Inactif	Un ou plusieurs éléments du groupe de ressources 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

End Date

Date d’expiration du groupe de ressources.

Si vous ne spécifiez pas de date de fin, le groupe de ressources n’expire pas. La date de fin peut être prolongée pour rendre un groupe d’actifs éligible à la remise, même après l’expiration du groupe de ressources.

La date de fin est incluse. Par exemple, si vous définissez Date de fin sur 31/12/2020, le groupe de ressources expirera à 23h59 le 31/12/2020. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter: Optionnel. Pour ne définir aucune date de fin lors de l’ajout d’un groupe de ressources, ne définissez pas ce champ.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer la date de fin actuelle et ne définir aucune date de fin, définissez ce champ sur la chaîne « delete_value ». Lorsque vous récupérez le groupe de ressources la prochaine fois, ce champ n’est pas défini.
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.

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

Titres

Liste des titres que Bing peut utiliser pour optimiser la disposition des annonces.

Pour optimiser les performances dans tous les formats d’annonce, les titres peuvent ne pas toujours s’afficher dans votre annonce.

Du point de vue d’un modèle de données, les titres sont stockés sous forme de ressources de texte. 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. Les titres sont représentés dans le fichier en bloc sous la forme d’une chaîne JSON. Deux titres sont inclus dans l’exemple JSON ci-dessous. Les id propriétés et text sont des propriétés de la ressource, tandis que les editorialStatus et assetPerformanceLabel sont des propriétés du lien de ressource, c’est-à-dire la relation entre l’élément multimédia et l’annonce. Pour plus d’informations, consultez assetPerformanceLabel, editorialStatus, id et texte ci-dessous.

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

Remarque

Voici un exemple de téléchargement en bloc dans lequel vous obtiendrez également des attributs en lecture seule, par exemple et ideditorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ajouter: Obligatoire si sa campagne parente ne s’associe pas à un magasin, facultatif si la campagne parente s’associe à un magasin. Si la campagne parente est associée à un magasin et que vous spécifiez Titres, vous devez également spécifier Des titres longs, des descriptions et des images. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
Mettre à jour: Optionnel. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez ce champ vide. Si vous définissez ce champ, tous les titres précédemment liés à cette annonce seront remplacés. Si vous spécifiez ce champ, une liste de 3 à 15 titres est requise. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
Supprimer: En lecture seule

assetPerformanceLabel

Cela vous permet de connaître les performances de la ressource.

L’attribut assetPerformanceLabel est en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Faible	Les performances de cette ressource sont faibles et nous vous recommandons de la remplacer pour améliorer les performances de votre publicité.
Good	Cette ressource fonctionne bien. Nous vous recommandons de conserver cette ressource et d’en ajouter d’autres pour améliorer les performances de votre publicité.
Idéale	Les performances de cette ressource sont parmi les meilleures et nous vous recommandons d’ajouter d’autres ressources similaires.
Unrated	Nous n’avons pas d’évaluation des performances pour cette ressource. Cela peut être dû au fait que la ressource est inactive, qu’elle ne contient pas suffisamment d’informations pour déterminer ses performances, ou qu’il n’y a pas assez de ressources similaires à comparer à celle-ci.
Formation	Les performances de la ressource font l’objet d’une évaluation active. Une fois l’évaluation terminée, l’évaluation des ressources sera Faible, Bonne, Meilleure ou Non notée.

editorialStatus

L’attribut editorialStatus est une chaîne en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Actif	L’élément multimédia a fait l’objet d’une révision éditoriale.
ActiveLimited	L’actif a fait l’objet d’une révision éditoriale sur un ou plusieurs marchés, et un ou plusieurs éléments de l’actif font l’objet d’une révision éditoriale dans un autre marché. Par exemple, l’actif a passé l’examen éditorial pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé	La ressource a échoué à la révision éditoriale.
Inactif	Un ou plusieurs éléments de la ressource font l’objet d’une révision éditoriale.
Inconnu	Réservé à une utilisation future.

id

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

text

L’attribut de text chaque titre doit contenir au moins un mot. La longueur d’entrée maximale de l’attribut de chaque titre est de text 30 caractères. Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 15 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.

L’attribut text ne peut pas contenir le caractère newline (\n).

ID

Identificateur généré par le système du groupe de ressources.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. 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

Créez plusieurs 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.

Vous devez fournir au moins 1 LandscapeImageMedia et 1 SquareImageMedia. Jusqu’à 20 images et jusqu’à 5 logos peuvent être enregistré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 la propriété LandscapeImageMedia 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": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"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": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

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 » :""LandscapeImageMedia""},{"id" » :1234567890000,"subType » :"SquareImageMedia », »,"""cropX » :286,""cropY » :0,""cropWidth" » :628,""cropHeight" » :628},{"id" » :1234567890000, « "subType" » :""LandscapeLogoMedia" »,"cropX » :70,"cropY" » :0,""cropWidth" » :200,""cropHeight" » :50},{"id" » :1234567890000,,""subType" » :"""SquareLogoMedia »,""cropX » :308,"cropY" » :0,""cropWidth" » :120,""cropHeight" » :120},{"id" » :1234567890000,"subType » :""ImageMedia15X10 »,"cropX » :129,"cropY" » :0,""cropWidth" » :942,""cropHeight" » :628},{"""id" » :1234567890000,"subType" » :""ImageMedia133X100" »,"cropX » :183,""cropY » :0,"cropWidth » :835,"cropHeight" » :628},{"id » :1234567890000,"subType » :""ImageMedia178X100" »,"cropX" » :41,""cropY" » :0,"cropY » :0,"cropWidth » :1118,""cropHeight" » :628},{"id" » :1234567890000,""subType » :""ImageMedia1X2" »,"cropX" » : » : 41,""cropY" » :0,""cropWidth" » :500,""cropHeight" » :1000},{"id" » :1234567890000,""subType » : » :""ImageMedia4X1" »,""cropX" » :60,""cropY" » :0,""cropWidth" » :1000,""cropHeight" » :250}] ».

Ajouter: Obligatoire si sa campagne parente ne s’associe pas à un magasin, facultatif si la campagne parente s’associe à un magasin. Si la campagne parente est associée à un magasin et que vous spécifiez Images, vous devez également spécifier Titres, Lignes à têtes longues et Descriptions. 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

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. 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.

Les valeurs de sous-type possibles sont LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 et ImageMedia4X1. 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
LandscapeImageMedia	1.91:1	703 largeur x 368 hauteur
SquareImageMedia	1:1	300 largeur x 300 hauteur
LandscapeLogoMedia	4:1	160 largeur x 40 hauteur
SquareLogoMedia	1:1	40 largeur x 40 hauteur
ImageMedia15x10	1.5:1	300 largeur x 200 hauteur
ImageMedia133x100	1.33:1	100 largeur x 75 hauteur
ImageMedia178x100	1.78:1	624 largeur x 350 hauteur
ImageMedia1x2	1:2	470 largeur x 940 hauteur
ImageMedia4x1	4:1	608 largeur x 152 hauteur

Titres longs

Liste des longs titres que Bing peut utiliser pour optimiser la disposition des annonces.

Pour optimiser les performances dans tous les formats d’annonce, les longs titres peuvent ne pas toujours s’afficher dans votre annonce.

Du point de vue d’un modèle de données, les titres longs sont stockés sous forme de ressources de texte. 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 titres longs. Les titres longs sont représentés dans le fichier en bloc sous la forme d’une chaîne JSON. Deux titres longs sont inclus dans l’exemple JSON ci-dessous. Les id propriétés et text sont des propriétés de la ressource, tandis que les editorialStatus et assetPerformanceLabel sont des propriétés du lien de ressource, c’est-à-dire la relation entre l’élément multimédia et l’annonce. Pour plus d’informations, consultez assetPerformanceLabel, editorialStatus, id et texte ci-dessous.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Remarque

Voici un exemple de téléchargement en bloc dans lequel vous obtiendrez également des attributs en lecture seule, par exemple et ideditorialStatus:

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ajouter: Obligatoire si sa campagne parente ne s’associe pas à un magasin, facultatif si la campagne parente s’associe à un magasin. Si la campagne parente est associée à un magasin et que vous spécifiez LongHeadlines, vous devez également spécifier Titres, Descriptions et Images. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
Mettre à jour: Optionnel. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez ce champ vide. Si vous définissez ce champ, tous les titres précédemment liés à cette annonce seront remplacés. Si vous spécifiez ce champ, une liste de 1 à 5 titres est requise. Seul le texte est respecté. Même si la ressource existe déjà dans votre compte, l’id, assetPerformanceLabel et editorialStatus seront ignorés si vous les incluez.
Supprimer: En lecture seule

assetPerformanceLabel

Cela vous permet de connaître les performances de la ressource.

L’attribut assetPerformanceLabel est en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Faible	Les performances de cette ressource sont faibles et nous vous recommandons de la remplacer pour améliorer les performances de votre publicité.
Good	Cette ressource fonctionne bien. Nous vous recommandons de conserver cette ressource et d’en ajouter d’autres pour améliorer les performances de votre publicité.
Idéale	Les performances de cette ressource sont parmi les meilleures et nous vous recommandons d’ajouter d’autres ressources similaires.
Unrated	Nous n’avons pas d’évaluation des performances pour cette ressource. Cela peut être dû au fait que la ressource est inactive, qu’elle ne contient pas suffisamment d’informations pour déterminer ses performances, ou qu’il n’y a pas assez de ressources similaires à comparer à celle-ci.
Formation	Les performances de la ressource font l’objet d’une évaluation active. Une fois l’évaluation terminée, l’évaluation des ressources sera Faible, Bonne, Meilleure ou Non notée.

editorialStatus

L’attribut editorialStatus est une chaîne en lecture seule lorsque vous téléchargez l’annonce de recherche réactive. Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur	Description
Actif	L’élément multimédia a fait l’objet d’une révision éditoriale.
ActiveLimited	L’actif a fait l’objet d’une révision éditoriale sur un ou plusieurs marchés, et un ou plusieurs éléments de l’actif font l’objet d’une révision éditoriale dans un autre marché. Par exemple, l’actif a passé l’examen éditorial pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé	La ressource a échoué à la révision éditoriale.
Inactif	Un ou plusieurs éléments de la ressource font l’objet d’une révision éditoriale.
Inconnu	Réservé à une utilisation future.

id

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

text

L’attribut de text chaque titre long doit contenir au moins un mot. La longueur d’entrée maximale de l’attribut de chaque titre est de text 90 caractères. Pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale est de 45 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.

L’attribut text ne peut pas contenir le caractère newline (\n).

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.

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 de la campagne qui contient le groupe de ressources.

Ce champ en bloc est mappé au champ Id de l’enregistrement de campagne .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de campagne existant ou un identificateur négatif égal au champ Id de l’enregistrement de campagne parent. Cette option est recommandée si vous ajoutez de nouveaux groupes d’annonces à une nouvelle campagne 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

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Campagne .

Chemin d’accès 1

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 (champ Url finale ). Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre URL finale contient https://www.contoso.com, chemin d’accès 1 est défini sur sous-répertoire1 et chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée sera 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 de ressources. 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.

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 (champ Url finale ). Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre URL finale contient https://www.contoso.com, chemin d’accès 1 est défini sur sous-répertoire1 et chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée sera https://www.contoso.com/subdirectory1/subdirectory2.

Vous ne pouvez spécifier le chemin d’accès 2 que si le chemin d’accès 1 est également défini.

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.

État

Status du groupe de ressources.

Les valeurs possibles sont Actif, Supprimé, Expiré ou Suspendu. Le status Expiré est en lecture seule.

Ajouter: Optionnel. La valeur par défaut est Paused.
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é.

Date de début

Date à laquelle le groupe de ressources peut commencer à servir ; sinon, le service peut commencer à servir le groupe de ressources le jour où le groupe de ressources devient actif.

La date de début est incluse. Par exemple, si vous définissez Date de début sur 5/5/2020, le groupe de ressources démarre à 12h00 le 5/5/2020. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter: Optionnel. Si vous ne définissez pas ce champ ou si la date que vous envoyez est antérieure à la date du jour, la date du jour est définie et le service peut commencer à servir le groupe de ressources dès que le groupe de ressources status est actif.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. La date de début ne peut pas être mise à jour après l’envoi du groupe de ressources, c’est-à-dire une fois que la date de début est arrivée.
Supprimer: En lecture seule

Partager via

Enregistrement du groupe de ressources - En bloc

Groupe de ressources

Nom de l’entreprise

Appel à l’action

Campagne

ID client

Descriptions

assetPerformanceLabel

editorialStatus

id

text

État de l’appel éditorial

Emplacement éditorial

Code de raison éditorial

État éditorial

Terme éditorial

End Date

URL finale

Titres

assetPerformanceLabel

editorialStatus

id

text

ID

Des images

cropHeight

cropWidth

cropX

cropY

id

Sous-type

Titres longs

assetPerformanceLabel

editorialStatus

id

text

URL finale mobile

Heure de modification

Parent Id

Chemin d’accès 1

Chemin d’accès 2

État

Date de début

Commentaires

Ressources supplémentaires