Partager via

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

  • Article

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

Vous pouvez associer une extension d’annonce d’emplacement au compte ou à des campagnes dans le compte. Chaque entité (compte ou campagne) peut être associée à autant d’extensions d’annonce d’emplacement que vous le souhaitez, jusqu’au nombre total d’extensions d’annonces d’emplacement dans votre compte. Utilisez les enregistrements Extension d’annonce d’emplacement de compte et Extension d’annonce d’emplacement de campagne pour gérer les associations d’extension d’annonce d’emplacement.

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US

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 BulkLocationAdExtension , 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 BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
    // '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 
    // LocationAdExtension object of the Campaign Management service.
    LocationAdExtension = new LocationAdExtension
    {
        Address = new Address
        {
            // 'City' column header in the Bulk file
            CityName = "Woodinville",
            // 'Country Code' column header in the Bulk file
            CountryCode = "US",
            // 'Postal Code' column header in the Bulk file
            PostalCode = "98608",
            // 'State Or Province Code' column header in the Bulk file
            ProvinceCode = null,
            // 'Province Name' column header in the Bulk file
            ProvinceName = "WA",
            // 'Address Line 1' column header in the Bulk file
            StreetAddress = "1234 Washington Place",
            // 'Address Line 2' column header in the Bulk file
            StreetAddress2 = "Suite 1210",
        },
        // 'Business Name' column header in the Bulk file
        CompanyName = "Contoso Shoes",
        // 'Geo Code Status' column header in the Bulk file
        GeoCodeStatus = null,
        GeoPoint = new GeoPoint
        {
            // 'Latitude' column header in the Bulk file
            LatitudeInMicroDegrees = 0,
            // 'Longitude' column header in the Bulk file
            LongitudeInMicroDegrees = 0,
        },
        // 'Id' column header in the Bulk file
        Id = locationAdExtensionIdKey,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "206-555-0100",

        // '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,
    },
};

uploadEntities.Add(bulkLocationAdExtension);

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

Ligne d’adresse 1

Première ligne de l’adresse.

La première ligne peut contenir un maximum de 80 caractères.

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

Ligne d’adresse 2

Deuxième ligne de l’adresse.

La deuxième ligne peut contenir un maximum de 80 caractères.

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

Nom de l’entreprise

Nom de l’entreprise.

Le nom peut contenir un maximum de 80 caractères.

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

Ville

Nom de la ville où se trouve l’adresse de la rue.

Le nom peut contenir un maximum de 80 caractères.

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

Country Code

Pays ou région où se trouve l’adresse postale.

Le code de pays doit contenir un code de pays à 2 caractères. Les valeurs de code de pays prises en charge incluent AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE et VN.

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

État du code géographique

Valeur status qui indique si les coordonnées de latitude et de longitude de l’entreprise ont été déterminées.

Si vous fournissez les coordonnées, le status est défini sur Terminé ; sinon, le status indique la progression de la détermination des coordonnées de l’adresse professionnelle spécifiée.

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

Valeur Description
Exécuter Détermination réussie de la latitude et de la longitude de l’entreprise.
Échec Impossible de déterminer la latitude et la longitude de l’entreprise.
Invalid Impossible de déterminer la latitude et la longitude de l’entreprise, probablement parce que l’adresse n’a pas été résolue.
Pending Dans le processus de détermination de la latitude et de la longitude de l’entreprise.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
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 d’annonce peut ensuite être référencé dans le champ Id des types d’enregistrements dépendants tels que l’extension d’annonce d’emplacement 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

Latitude

Latitude spécifiée en degrés. La latitude doit être supérieure ou égale à -85 et inférieure ou égale à +85.

Remarque

Le service Gestion des campagnes utilise des micro-degrés, c’est-à-dire de -85000000 à 85000000. Lorsque vous utilisez BulkLocationAdExtension via les kits SDK, vous devez utiliser des micro-degrés, car l’implémentation BulkLocationAdExtension convertit à partir de micro degrés et écrit la valeur sous forme de degrés dans le fichier en bloc.

Les coordonnées de latitude et de longitude sont utilisées pour marquer l’emplacement de l’entreprise sur Bing Cartes lorsque l’utilisateur clique sur l’adresse sur l’annonce. Si les coordonnées spécifiées ne se trouvent pas dans la plage de valeurs valides, le service détermine les coordonnées en fonction de l’adresse.

Si vous spécifiez les coordonnées connues, le service ne vérifie pas si les coordonnées spécifiées correspondent à l’adresse professionnelle spécifiée. Si vous ne fournissez pas les coordonnées, le service en bloc utilise l’adresse de l’entreprise pour déterminer les coordonnées.

Remarque

Lors de l’ajout de plus de 10 extensions d’annonces d’emplacement, le service résout les coordonnées hors connexion et résout les coordonnées à l’avance lors de l’exécution de l’opération de service. L’emplacement n’est pas utilisé dans une annonce tant que les coordonnées ne sont pas déterminées, ce qui peut prendre de quelques secondes à quelques minutes en fonction du nombre d’extensions d’annonces d’emplacement ajoutées et de la demande actuelle.

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

Longitude

Longitude spécifiée en degrés. La longitude doit être supérieure ou égale à -180 et inférieure ou égale à +180.

Remarque

Le service Gestion des campagnes utilise des micro-degrés, c’est-à-dire de -180000000 à 180000000. Lorsque vous utilisez BulkLocationAdExtension via les kits SDK, vous devez utiliser des micro-degrés, car l’implémentation BulkLocationAdExtension convertit à partir de micro degrés et écrit la valeur sous forme de degrés dans le fichier en bloc.

Les coordonnées de latitude et de longitude sont utilisées pour marquer l’emplacement de l’entreprise sur Bing Cartes lorsque l’utilisateur clique sur l’adresse sur l’annonce. Si les coordonnées spécifiées ne se trouvent pas dans la plage de valeurs valides, le service détermine les coordonnées en fonction de l’adresse.

Si vous spécifiez les coordonnées connues, le service ne vérifie pas si les coordonnées spécifiées correspondent à l’adresse professionnelle spécifiée. Si vous ne fournissez pas les coordonnées, le service en bloc utilise l’adresse de l’entreprise pour déterminer les coordonnées.

Remarque

Lors de l’ajout de plus de 10 extensions d’annonces d’emplacement, le service résout les coordonnées hors connexion et résout les coordonnées à l’avance lors de l’exécution de l’opération de service. L’emplacement n’est pas utilisé dans une annonce tant que les coordonnées ne sont pas déterminées, ce qui peut prendre de quelques secondes à quelques minutes en fonction du nombre d’extensions d’annonces d’emplacement ajoutées et de la demande actuelle.

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

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

Numéro de téléphone

Numéro de téléphone cliquable de l’entreprise à inclure dans l’annonce.

Le numéro de téléphone peut contenir un maximum de 35 caractères et doit être valide pour le pays ou la région spécifié.

Si la campagne inclut également une extension d’appel, le numéro de téléphone dans l’extension d’appel remplacera le numéro de téléphone de l’extension d’annonce de localisation.

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

Code postal

Code postal ou postal.

Le code postal peut contenir un maximum de 80 caractères.

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

Nom de la province

Nom de l’état ou de la province où se trouve l’adresse postale, par exemple Washington.

Le nom peut contenir un maximum de 50 caractères.

Vous devez spécifier le nom de la province ou le code de l’état ou de la province.

Remarque

Le code de l’état ou de la province et le nom de la province ne sont pas obligatoires si le champ Country Code est défini sur FR, IE ou SG.

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

Code d’état ou de province

Code qui identifie l’état ou la province où se trouve l’adresse postale, par exemple WA.

Le code peut contenir un maximum de 50 caractères.

Vous devez spécifier le nom de la province ou le code de l’état ou de la province.

Remarque

Le code de l’état ou de la province et le nom de la province ne sont pas obligatoires si le champ Country Code est défini sur FR, IE ou SG.

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

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