Partager via

Enregistrement du critère de rayon du groupe d’annonces - En bloc

  • Article

Définit un critère de rayon de groupe d’annonces qui peut être chargé et téléchargé dans un fichier en bloc.

Avec les critères de rayon, vous pouvez choisir d’afficher des publicités aux clients potentiels dans, rechercher ou afficher des pages sur un rayon spécifié autour d’un code postal, des coordonnées, d’un point de repère ou d’une zone.

Chaque critère de rayon définit un rayon, une latitude et une longitude pour l’ajustement d’enchère du critère associé.

Le nombre maximal de critères de rayon que vous pouvez spécifier par campagne ou groupe d’annonces est de 2 000.

Remarque

Vous ne pouvez avoir qu’un seul enregistrement de critère d’intention d’emplacement de groupe d’annonces par groupe d’annonces pour déterminer l’option d’intention d’emplacement qui s’applique à tous les enregistrements critère d’emplacement du groupe d’annonces et critère de rayon du groupe d’annonces . Lorsque vous créez le premier critère du groupe d’annonces, un enregistrement critère d’intention d’emplacement de groupe d’annonces 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 du groupe d’annonces d’un groupe d’annonces, que le groupe d’annonces ait ou non d’autres critères. Vous ne pouvez pas supprimer le critère d’intention de l’emplacement du groupe d’annonces d’un groupe d’annonces, bien qu’il n’ait aucun but sans critères d’emplacement ou de rayon.

Si des critères de rayon au niveau du groupe d’annonces sont spécifiés, les critères de rayon au niveau de la campagne sont ignorés pour ce groupe d’annonces. En d’autres termes, les critères de rayon de groupe d’annonces remplacent les critères de rayon 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 de rayon du groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupTargetCriterions 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 de rayon de groupe d’annonces si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Radius Criterion,Active,,-1111,,,,ClientIdGoesHere,,RadiusName,20,,,10,Kilometers,,,,,10.5,40.5

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 BulkAdGroupRadiusCriterion , 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 BulkAdGroupRadiusCriterion
var bulkAdGroupRadiusCriterion = new BulkAdGroupRadiusCriterion
{
    // 'Ad Group' column header in the Bulk file is read-only
    AdGroupName = null,

    // '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 
    // BiddableAdGroupCriterion object of the Campaign Management service.

    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,

        Criterion = new RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        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 = AdGroupCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkAdGroupRadiusCriterion);

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

Groupe d’annonces

Nom du groupe d’annonces dans lequel ce critère est appliqué ou supprimé.

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

Ajustement de l’enchère

Montant en pourcentage auquel vous souhaitez ajuster l’enchère en fonction du critère de rayon correspondant.

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 qui contient le groupe d’annonces dans lequel 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

Latitude

Latitude, en degrés, du critère de rayon.

La latitude doit être supérieure ou égale à -85,0 et inférieure ou égale à +85,0.

Vous spécifiez la latitude et la longitude sous forme de valeurs décimales. Par exemple, la latitude et la longitude de One Redmond Way, Redmond, WA sont de 47,755367 et -122,091827, respectivement. Pour obtenir ces valeurs, vous pouvez entrer l’adresse d’un emplacement géographique dans Bing Cartes et les coordonnées s’affichent sous l’adresse.

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

Longitude

Longitude, en degrés, du critère de rayon.

La longitude doit être supérieure ou égale à -180,0 et inférieure ou égale à +180,0.

Vous spécifiez la latitude et la longitude sous forme de valeurs décimales. Par exemple, la latitude et la longitude de One Redmond Way, Redmond, WA sont de 47,755367 et -122,091827, respectivement. Pour obtenir ces valeurs, vous pouvez entrer l’adresse d’un emplacement géographique dans Bing Cartes et les coordonnées s’affichent sous l’adresse.

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

Nom

Nom de l’emplacement géographique ciblé.

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

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

Parent Id

Identificateur du groupe d’annonces dans lequel ce critère est appliqué ou supprimé.

Ce champ en bloc est mappé au champ Id de l’enregistrement groupe d’annonces .

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

Radius

Rayon qui spécifie la zone entourant l’emplacement géographique à cibler.

Si le champ Unité de rayon est défini sur Miles, les valeurs entières positives comprises entre 1 et 500 sont acceptées.

Si le champ Unité de rayon est défini sur Kilomètres, les valeurs entières positives comprises entre 1 et 800 sont acceptées.

Remarque

Le type de données est double et peut être pris en charge dans une version ultérieure. Actuellement, le service accepte et retourne uniquement des valeurs entières.

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

Statut

Représente l’association status entre le groupe d’annonces et le critère. Si le critère est appliqué au groupe d’annonces, 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 de rayon spécifique, vous devez charger l’état, l’ID et l’ID parent.

Unit

Unité de mesure pour le rayon spécifié.

Les valeurs prises en charge sont Miles (par défaut) et Kilomètres.

Ajouter: Optionnel. S’il n’est pas spécifié, la valeur par défaut miles est définie.
Mettre à jour: Obligatoire
Supprimer: En lecture seule