Partager via

Enregistrement du critère d’emplacement de la campagne - En bloc

  • Article

Définit un critère d’emplacement de campagne qui peut être utilisé pour afficher des publicités aux utilisateurs dans un emplacement spécifique.

Avec les critères d’emplacement, vous pouvez choisir d’afficher des publicités à des clients potentiels dans, de rechercher ou d’afficher des pages sur :

  • Tous les pays/régions disponibles
  • Villes, codes postaux, zones de métro (zone de marché Microsoft dans le États-Unis), comtés, états/provinces et pays/régions sélectionnés

Chaque critère d’emplacement définit un code d’emplacement pour l’ajustement d’enchère du critère associé.

Le nombre maximal de critères d’emplacement et d’emplacement négatifs combinés que vous pouvez spécifier par campagne ou groupe d’annonces est de 10 000.

Remarque

Vous ne pouvez avoir qu’un seul enregistrement critère d’intention d’emplacement de campagne par campagne pour déterminer l’option d’intention d’emplacement qui s’applique à tous les enregistrements critère d’emplacement de campagne et critère de rayon de campagne de la campagne. Lorsque vous créez le premier critère de la campagne, un enregistrement critère d’intention d’emplacement de campagne est également ajouté automatiquement avec la valeur Target par défaut définie sur PeopleInOrSearchingForOrViewingPages. Vous pouvez ajouter ou mettre à jour le critère d’intention d’emplacement de campagne d’une campagne, que la campagne ait ou non d’autres critères. Vous ne pouvez pas supprimer le critère d’intention d’emplacement de campagne d’une campagne, bien qu’il n’ait aucun but sans critères d’emplacement ou de rayon.

Si les critères d’emplacement au niveau du groupe d’annonces sont spécifiés (positifs ou négatifs), les critères d’emplacement au niveau de la campagne sont ignorés pour ce groupe d’annonces. En d’autres termes, les critères d’emplacement du groupe d’annonces remplacent les critères d’emplacement de campagne et ne sont pas appliqués en tant qu’union.

Notez également que vous devez considérer les critères d’emplacement, d’emplacement négatif et de rayon comme un ensemble de critères géographiques. Si le groupe d’annonces a des critères géographiques, aucun des critères géographiques de la campagne n’est hérité. Si le groupe d’annonces n’a pas de critères géographiques, tous les critères géographiques de la campagne sont hérités. Les critères géographiques peuvent être hérités de la campagne même si le groupe d’annonces a un critère d’intention d’emplacement. Si les critères géographiques du groupe d’annonces sont utilisés, le critère d’intention d’emplacement du groupe d’annonces est utilisé ; si les critères géographiques de la campagne sont hérités, le critère d’intention d’emplacement de la campagne est utilisé et le critère d’intention d’emplacement du groupe d’annonces est ignoré. Vous ne pouvez pas supprimer le critère d’intention d’emplacement d’une campagne ou d’un groupe d’annonces, bien qu’il n’ait aucun but sans critères d’emplacement ou de rayon.

Conseil

Pour obtenir une vue d’ensemble de l’utilisation des critères cibles, consultez Afficher des publicités à votre public cible.

Vous pouvez télécharger tous les enregistrements du critère d’emplacement de campagne dans le compte en incluant la valeur DownloadEntity de CampaignTargetCriterions 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 un nouveau critère d’emplacement de campagne si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Location Criterion,Active,,-111,Country,,ClientIdGoesHere,,190,20,,,,,,,,,

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 BulkCampaignLocationCriterion , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ du fichier en bloc.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignLocationCriterion
var bulkCampaignLocationCriterion = new BulkCampaignLocationCriterion
{
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new LocationCriterion
        {
            // 'Target' column header in the Bulk file
            LocationId = 190,

            // 'Sub Type' column header in the Bulk file
            LocationType = "Country"
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

        // 'Id' column header in the Bulk file
        Id = null,

        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkCampaignLocationCriterion);

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 critère d’emplacement de campagne, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Ajustement de l’enchère

Pourcentage d’ajustement de l’enchère pour la cible correspondante.

Les valeurs prises en charge sont négatives quatre-vingt-dix (-90) à 900 (900) positives.

Ajouter: Optionnel. L’ajustement de l’enchère sera défini sur la valeur par défaut 0 s’il n’est pas inclus.
Mettre à jour: Obligatoire
Supprimer: En lecture seule

Campagne

Nom de la campagne dans laquelle ce critère est appliqué ou supprimé.

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

ID client

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

Ajouter: Optionnel
Mettre à jour: Optionnel
Supprimer: Optionnel

ID

Identificateur unique Microsoft Advertising du critère.

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

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 d’une campagne dans laquelle ce critère est appliqué ou supprimé.

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

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de campagne existant ou un identificateur négatif égal au champ Id de l’enregistrement de campagne parent. Cela est recommandé si vous ajoutez de nouveaux critères à une nouvelle campagne dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Statut

Représente l’association status entre la campagne et le critère. Si le critère est appliqué à la campagne, la valeur de ce champ est Active. Pour supprimer le critère, définissez le status sur Supprimé.

Ajouter: En lecture seule. Le status est toujours défini sur Actif lorsque vous ajoutez des critères. Si vous chargez une autre valeur, par exemple , Foo , le fichier de résultats contient la même valeur, bien que le critère soit actif.
Mettre à jour: Optionnel
Supprimer: Obligatoire. L’état doit être défini sur Supprimé. Pour supprimer une enchère de critère d’emplacement spécifique, vous devez charger l’état, l’ID et l’ID parent.

Sous-type

Sous-type d’emplacement que vous ciblez. Par exemple, la valeur est City si l’enregistrement représente un critère d’emplacement de ville.

Les valeurs possibles sont City, Country, County, MetroArea, PostalCode et State.

Remarque

Les lieux de voisinage sont bientôt disponibles. Le sous-type est Voisinage.

De nouveaux sous-types d’emplacement peuvent être ajoutés à tout moment. Le type d’emplacement change rarement pour un ID d’emplacement donné.

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

Target

Identificateur de l’emplacement que vous souhaitez cibler avec l’ajustement d’enchère correspondant.

Pour connaître les valeurs possibles, consultez le champ Id d’emplacement du fichier d’emplacements géographiques. Vous pouvez appeler l’opération GetGeoLocationsFileUrl pour télécharger le fichier.

Importante

Veuillez case activée le champ État dans le fichier d’emplacements géographiques avant d’ajouter ou de mettre à jour un critère d’emplacement. Si le status est PendingDeprecation, le critère d’emplacement n’est plus utilisé pour le ciblage ou les exclusions. Les critères d’emplacement déconseillés peuvent toujours être récupérés, mais vous ne pouvez pas ajouter ou mettre à jour des critères d’emplacement déconseillés.

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