Enregistrement d’extension d’annonce d’image - En bloc

Définit une extension d’annonce d’image qui peut être téléchargée et chargée dans un fichier en bloc.

Vous pouvez associer une extension d’image publicitaire au compte ou à des campagnes et des groupes d’annonces dans le compte. Chaque compte peut avoir jusqu’à 250 000 associations d’extension d’image de campagne et jusqu’à 250 000 associations d’extension d’image de groupe d’annonces. Chaque entité (compte, campagne ou groupe d’annonces) peut être associée à jusqu’à 25 extensions publicitaires d’image. Utilisez les enregistrements Account Image Ad Extension, Ad Group Image Ad Extension et Campaign Image Ad Extension pour gérer les associations d’extension d’extension d’annonce d’image.

Vous pouvez télécharger tous les enregistrements d’extension Image Ad dans le compte en incluant la valeur DownloadEntity de ImageAdExtensions 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 extension d’annonce d’image à la bibliothèque partagée du compte.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

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 BulkImageAdExtension , 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 BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

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’extension d’annonce d’image , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Planification des annonces
• Texte de remplacement
• Client Id
• Paramètre personnalisé
• Destination Url
• Afficher le texte
• Emplacement éditorial
• Code de raison éditorial
• État éditorial
• Terme éditorial
• Date de fin
• URL finale
• Suffixe d’URL final
• Id
• Images
• Dispositions
• ID de média
• URL finale mobile
• Heure de modification
• Parent Id
• Pays d’éditeur
• Date de début
• État
• Modèle de suivi
• Utiliser le fuseau horaire du moteur de recherche
• Version

Planification des annonces

Liste des plages de jours et de temps auxquelles vous souhaitez que l’extension d’annonce s’affiche avec vos annonces. Chaque jour et intervalle de temps inclut le jour de la semaine, l’heure de début/fin et la minute de début/fin planifiée. Chaque plage de jours et de temps est placée entre parenthèses gauche et droite, et séparées des autres plages de jour et de temps par un point-virgule (;) délimiteur. Dans chaque jour et intervalle de temps, le format est Day[StartHour :StartMinue-EndHour :EndMinute].

Les valeurs possibles de StartHour sont comprises entre 00 et 23, où 00 équivaut à 12h00 et 12h00 à 12h00.

Les valeurs possibles de EndHour sont comprises entre 00 et 24, où 00 équivaut à 12 :00 et 12  :00.

Les valeurs possibles de StartMinute et EndMinute sont comprises entre 00 et 60.

L’exemple suivant illustre les plages de jour et de temps pendant les jours de la semaine de 9h00 à 21h00 : (lundi[09 :00-21 :00]);( Mardi[09 :00-21 :00]) ; (Mercredi[09 :00-21 :00]) ; (jeudi[09 :00-21 :00]) ; (Vendredi[09 :00-21 :00])

Ajouter: Optionnel. Si vous ne définissez pas ce champ, l’extension d’annonce sera éligible pour la planification à tout moment pendant les dates de début et de fin du calendrier.
Mettre à jour: Optionnel. Les plages de jours et de temps individuelles ne peuvent pas être mises à jour. Vous pouvez mettre à jour efficacement les plages de jours et de temps en envoyant un nouvel ensemble qui doit remplacer l’ensemble précédent. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule

Texte de remplacement

Autre description du support d’image pour plus de facilité d’utilisation. Si l’image n’a pas pu être affichée, le texte de remplacement est utilisé à la place.

La longueur maximale de ce champ est de 90 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

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 3 premières paires clé/valeur de paramètres personnalisés que vous incluez, et tous les paramètres personnalisés supplémentaires seront ignorés. Pour les clients dans le pilote d’augmentation de la limite des paramètres personnalisés phase 3 (GetCustomerPilotFeatures retourne 635), Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètre personnalisé 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 200 UTF-8 octets. Pour les clients du pilote d’augmentation de la limite des paramètres personnalisés phase 3 (GetCustomerPilotFeatures retourne 635), la limite de valeur passe à 250 octets UTF-8. 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 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

Destination URL

URL de la page web vers laquelle l’utilisateur doit se connecter lorsqu’il clique sur l’image.

L’URL peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?.

L’URL peut contenir un maximum de 1 024 caractères. Si l’URL ne spécifie pas de protocole, le système utilise le protocole HTTP lorsqu’un utilisateur clique sur la publicité. Si l’URL spécifie le protocole HTTP lorsque vous ajoutez une publicité, le service supprime la chaîne de protocole http:// (la chaîne de protocole HTTP ne compte pas dans la limite de 1 024 caractères) ; Toutefois, le service ne supprime pas de chaîne de protocole HTTPS (https://) de l’URL.

Ajouter: Optionnel. Note: Ce champ est requis pour les extensions publicitaires multi-images. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Note: Ce champ est requis pour les extensions publicitaires multi-images.
Supprimer: En lecture seule

Afficher le texte

Texte d’affichage de votre extension d’image.

La longueur maximale de ce champ est de 35 caractères.

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

Emplacement éditorial

Composant ou propriété de l’extension d’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

La status éditoriale de l’extension d’annonce.

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

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

Chaîne de date de fin planifiée d’extension d’annonce au format MM/JJ/AAAA.

La date de fin est incluse. Par exemple, si vous définissez ce champ sur 31/12/2020, les extensions d’annonce cesseront d’être affichées à 23h59 le 31/12/2020.

Ajouter: Optionnel. Si vous ne spécifiez pas de date de fin, l’extension d’annonce continuera d’être remise, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés.
Mettre à jour: Optionnel. La date de fin peut être raccourcie ou prolongée, tant que la date de début est null ou se produit avant la nouvelle date de fin. Si vous définissez ce champ sur la chaîne delete_value , vous supprimez effectivement la date de fin. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule

URL finale

URL de la page d’accueil.

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 de liste pour l’URL finale et l’URL finale mobile. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste 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}.
• Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
• Si vous spécifiez l’URL finale 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é.
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

ID

Identificateur généré par le système de l’extension d’annonce.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour l’extension de publicité peut ensuite être référencé dans le champ Id des types d’enregistrements dépendants tels que Extension d’annonce d’image de groupe d’annonces et Extension d’annonce d’image de campagne. Cette option est recommandée si vous ajoutez de nouvelles extensions d’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

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 uniquement fournir une ressource d’image de paysage, c’est-à-dire que ce champ doit contenir une ressource image avec subType défini sur LandscapeImageMedia. Les dimensions recommandées pour landscapeImageMedia sont de 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 le LandscapeImageMedia.

Les ressources d’image sont représentées dans le fichier en bloc sous la forme d’une chaîne JSON. Sept 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": "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
}]

É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 LandscapeImageMedia, toutes les ressources d’image sont rognées, à l’exception de l’image paysage d’origine.
• Que l’image de paysage ait ou non ses propres paramètres de rognage, Microsoft Advertising utilise la vraie hauteur de l’image de paysage 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 l’image de paysage (sous-type LandscapeImageMedia) avec des proportions de 1,91 :1 a une largeur et une hauteur de 1200 x 628. Même si le lien de ressource d’image de paysage a é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’image de paysage (là encore, ce serait 1200 x 628 dans cet exemple).

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 extensions d’annonces d’image via l’enregistrement en bloc Image . 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.

Les valeurs de sous-type possibles sont LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X100, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 et ImageMedia172X100. De nouveaux sous-types peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.

Ajouter: Obligatoire. 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

Dispositions

Liste des dispositions d’image éligibles.

Les valeurs prises en charge sont SearchSingle et SearchMultiple. De nouvelles dispositions étant susceptibles d’être ajoutées à l’avenir, vous ne devez pas dépendre d’un ensemble fixe de valeurs.

Dans un fichier en bloc, la liste des chaînes de disposition est délimitée par un point-virgule (;).

Ajouter: Optionnel. Si vous ne définissez pas ce champ, toutes les dispositions actuelles et futures prises en charge seront définies par défaut.
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

Identificateurs des images à inclure dans l’annonce. Vous ne pouvez pas spécifier d’identificateurs de média pour plusieurs images des mêmes proportions. En d’autres termes, chacune des images référencées doit avoir des proportions différentes.

Vous pouvez spécifier jusqu’à quatre (4) identificateurs d’image . Bien que le minimum requis soit un ID de média d’image, pour pouvoir bénéficier de tous les placements publicitaires, vous devez fournir quatre identificateurs de média d’image.

Dans un fichier en bloc, la liste des identificateurs de média est délimitée par un point-virgule (;).

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

URL finale mobile

URL de la page d’accueil des appareils mobiles.

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 de liste pour l’URL finale et l’URL finale mobile. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste 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}.
• Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
• Si vous spécifiez l’URL finale 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é).

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

Parent Id

Identificateur généré par le système du compte qui contient l’extension d’annonce.

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

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

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

Date de début

Chaîne de date de début planifiée de l’extension d’annonce au format MM/JJ/AAAA.

La date de début est incluse. Par exemple, si vous définissez StartDate sur 5/5/2020, les extensions publicitaires commenceront à s’afficher à 12 :00 le 5/5/2020.

Ajouter: Optionnel. Si vous ne spécifiez pas de date de début, l’extension d’annonce est immédiatement éligible pour être planifiée.
Mettre à jour: Optionnel. La date de début peut être raccourcie ou prolongée, tant que la date de fin est null ou se produit après la nouvelle date de début. Si vous définissez ce champ sur la chaîne delete_value , vous supprimez effectivement la date de début et l’extension d’annonce est immédiatement éligible pour être planifiée. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule

Statut

Status de l’extension d’annonce.

Les valeurs possibles sont Active 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é.

Modèle de suivi

Modèle de suivi à utiliser pour vos URL de promotion.

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

Utiliser le fuseau horaire du moteur de recherche

Détermine s’il faut utiliser le fuseau horaire du compte ou le fuseau horaire de l’utilisateur de recherche où les publicités peuvent être remises.

Affectez à cette propriété la valeur TRUE si vous souhaitez que les extensions publicitaires s’affichent dans le fuseau horaire de l’utilisateur de recherche, et définissez-la sur FALSE.

Ajouter: Optionnel. Si vous ne spécifiez pas ce champ ou si vous le laissez vide, la valeur par défaut false est définie et le fuseau horaire du compte est utilisé.
Mettre à jour: Optionnel. Si vous définissez ce champ sur la chaîne delete_value , vous réinitialisez efficacement la valeur par défaut false. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule

Version

Nombre de fois où le contenu de l’extension d’annonce a été mis à jour. La version est définie sur 1 lorsque vous ajoutez l’extension et est incrémentée chaque fois qu’elle est révisée.

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