Partager via

Enregistrement d’extension d’annonce de prix - En bloc

  • Article

Définit une extension d’annonce qui inclut entre 3 et 8 lignes de table de prix.

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

Vous pouvez télécharger tous les enregistrements d’extension Price Ad dans le compte en incluant la valeur DownloadEntity de PriceAdExtensions 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 Price Ad à 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,Tracking Template,Final Url Suffix,Custom Parameter,Price Extension Type,Currency Code 1,Currency Code 2,Currency Code 3,Currency Code 4,Currency Code 5,Currency Code 6,Currency Code 7,Currency Code 8,Price Description 1,Price Description 2,Price Description 3,Price Description 4,Price Description 5,Price Description 6,Price Description 7,Price Description 8,Header 1,Header 2,Header 3,Header 4,Header 5,Header 6,Header 7,Header 8,Final Mobile Url 1,Final Mobile Url 2,Final Mobile Url 3,Final Mobile Url 4,Final Mobile Url 5,Final Mobile Url 6,Final Mobile Url 7,Final Mobile Url 8,Final Url 1,Final Url 2,Final Url 3,Final Url 4,Final Url 5,Final Url 6,Final Url 7,Final Url 8,Price 1,Price 2,Price 3,Price 4,Price 5,Price 6,Price 7,Price 8,Price Qualifier 1,Price Qualifier 2,Price Qualifier 3,Price Qualifier 4,Price Qualifier 5,Price Qualifier 6,Price Qualifier 7,Price Qualifier 8,Price Unit 1,Price Unit 2,Price Unit 3,Price Unit 4,Price Unit 5,Price Unit 6,Price Unit 7,Price Unit 8
Format Version,,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Price Ad Extension,,-24,,,,ClientIdGoesHere,,,,,,(Monday[09:00-21:00]),FALSE,,,{_promoCode}=PROMO1; {_season}=summer,Events,USD,USD,USD,,,,,,Come to the event,Come to the next event,Come to the final event,,,,,,New Event,Next Event,Final Event,,,,,,,,,,,,,,https://contoso.com,https://contoso.com,https://contoso.com,,,,,,9.99,9.99,9.99,,,,,,From,From,From,,,,,,PerDay,PerDay,PerDay,,,,,

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 BulkPriceAdExtension , 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 BulkPriceAdExtension
var bulkPriceAdExtension = new BulkPriceAdExtension
{
    // '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 
    // PriceAdExtension object of the Campaign Management service.
    PriceAdExtension = new PriceAdExtension
    {
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Id' column header in the Bulk file
        Id = priceAdExtensionIdKey,
        // 'Price Extension Type' column header in the Bulk file
        PriceExtensionType = PriceExtensionType.Events,

        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,

        // TableRows must include between 3 and 8 PriceTableRow
        TableRows = new PriceTableRow[]
        {
            // Each PriceTableRow is mapped to columns with suffix 1..8. 
            // This example shows 3 price table rows i.e., with column suffix from 1..3
            new PriceTableRow
            {
                // 'Currency Code 1' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 1' column header in the Bulk file
                Description = "Come to the new event",
                // 'Final Url 1' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 1' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 1' column header in the Bulk file
                Header = "New Event",
                // 'Price 1' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 1' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 1' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 2' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 2' column header in the Bulk file
                Description = "Come to the next event",
                // 'Final Url 2' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 2' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 2' column header in the Bulk file
                Header = "Next Event",
                // 'Price 2' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 2' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 2' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 3' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 3' column header in the Bulk file
                Description = "Come to the final event",
                // 'Final Url 3' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 3' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 3' column header in the Bulk file
                Header = "Final Event",
                // 'Price 3' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 3' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 3' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
        },
        // '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(bulkPriceAdExtension);

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

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

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

Code monétaire (1-8)

Le fichier en bloc comprend jusqu’à 8 colonnes de code monétaire, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont Le code monétaire 1, le code monétaire 2, le code monétaire 3, le code monétaire 4, le code monétaire 5, le code monétaire 6, le code monétaire 7 et le code monétaire 8.

Les codes monétaires pris en charge sont ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD et VEF.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

Ajouter: Obligatoire
Mettre à jour: Obligatoire
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, le paramètre précédent est supprimé.
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.

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

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 mobile finale (1-8)

Le fichier en bloc inclut jusqu’à 8 colonnes d’URL mobile finales, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont Final Mobile URL 1, Final Mobile URL 2, Final Mobile URL 3, Final Mobile URL 4, Final Mobile URL 5, Final Mobile URL 6, Final Mobile URL 7 et Final Mobile URL 8.

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.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, le paramètre précédent est supprimé.
Supprimer: En lecture seule

URL finale (1-8)

Le fichier en bloc inclut jusqu’à 8 colonnes d’URL finales, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont l’URL finale 1, l’URL finale 2, l’URL finale 3, l’URL finale 4, l’URL finale 5, l’URL finale 6, l’URL finale 7 et l’URL finale 8.

URL de la page d’accueil à utiliser avec le modèle de suivi facultatif et les paramètres personnalisés.

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, l’URL finale est requise pour chaque élément de table de prix.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

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

En-tête qui précède les données de tarification dans votre extension d’annonce de prix. Chaque en-tête peut contenir un maximum de 25 caractères. Chaque en-tête doit être lié directement au champ Type d’extension de prix pour l’extension d’annonce de prix.

Le fichier en bloc comprend jusqu’à 8 colonnes d’en-tête, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont En-tête 1, En-tête 2, En-tête 3, En-tête 4, En-tête 5, En-tête 6, En-tête 7 et En-tête 8.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

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

Remarque

Cette fonctionnalité n’est disponible que pour les clients dans le pilote Final URL Suffix Phase 3 (GetCustomerPilotFeatures renvoie 636). Si vous n’êtes pas dans le pilote, cette propriété sera ignorée et aucune erreur ne sera retournée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, 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 l’extension d’annonce de prix du groupe d’annonces et l’extension de publicité de prix 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

Langue

Langue de la copie publicitaire de votre extension d’annonce de prix.

Pour connaître les valeurs possibles, consultez Langages publicitaires.

Ajouter: Obligatoire
Mettre à jour: Obligatoire
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 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

Prix (1-8)

Le prix que vous annoncez.

Le fichier en bloc comprend jusqu’à 8 colonnes de prix, c’est-à-dire une pour chaque élément de table de prix dans l’extension de publicité. Les en-têtes de colonne de fichiers en bloc sont Price 1, Price 2, Price 3, Price 4, Price 5, Price 6, Price 7 et Price 8.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

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

Description du prix (1-8)

La description doit fournir des informations supplémentaires sur l’en-tête qui est également défini dans cet objet. Chaque description peut contenir un maximum de 25 caractères.

Le fichier en bloc comprend jusqu’à 8 colonnes de description de prix, c’est-à-dire une pour chaque élément de la table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont Description du prix 1, Description du prix 2, Description du prix 3, Description du prix 4, Description du prix 5, Description du prix 6, Description du prix 7 et Description du prix 8.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

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

Type d’extension de prix

Type de l’extension d’annonce de prix.

Les valeurs possibles sont les suivantes : Brands, Events, Locations, Neighborhoods, ProductCategories, ProductTiers, ServiceCategories, Services, ServiceTiers et Unknown. (Inconnu est réservé à une utilisation future et ne peut pas être défini.)

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

Qualificateur de prix (1-8)

Qualificateur de prix pour un produit ou service donné, par exemple, à partir d’un prix spécifique et jusqu’à un prix maximal.

Les valeurs possibles sont les suivantes : Average, From, UpTo, None et Unknown. (Inconnu est réservé à une utilisation future et ne peut pas être défini.)

Le fichier en bloc comprend jusqu’à 8 colonnes de qualificateur de prix, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont Price Qualifier 1, Price Qualifier 2, Price Qualifier 3, Price Qualifier 4, Price Qualifier 5, Price Qualifier 6, Price Qualifier 7 et Price Qualifier 8.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

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

Unité de prix (1-8)

L’unité de prix vous permet de spécifier le coût en termes d’heure, de jour, de semaine, etc.

Les valeurs possibles sont les suivantes : PerDay, PerHour, PerMonth, PerNight, PerWeek, PerYear, None et Unknown. (Inconnu est réservé à une utilisation future et ne peut pas être défini.)

Le fichier en bloc comprend jusqu’à 8 colonnes d’unité de prix, c’est-à-dire une pour chaque élément de table de prix dans l’extension d’annonce. Les en-têtes de colonne de fichier en bloc sont Price Unit 1, Price Unit 2, Price Unit 3, Price Unit 4, Price Unit 5, Price Unit 6, Price Unit 7 et Price Unit 8.

Vous devez avoir entre 3 et 8 articles de table de prix par extension d’annonce de prix. L’ordre dans lequel vous les créez est l’ordre attendu dans l’annonce, mais la commande n’est pas garantie. Tous les éléments de table de prix d’une extension d’annonce de prix doivent se trouver dans le même enregistrement de fichier en bloc. Chaque élément de la table de prix est mappé au même index des colonnes Code monétaire, URL mobile finale, URL finale, En-tête, Prix, Description du prix, Unité de prix et Qualificateur de prix . Par exemple, le premier élément de table de prix est mappé aux colonnes Code monétaire 1, URL mobile finale 1, Url finale 1, En-tête 1, Prix 1, Description du prix 1, Unité de prix 1 et Qualificateur de prix 1 .

Ajouter: Obligatoire
Mettre à jour: Obligatoire
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 d’élément de table de prix.

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