Enregistrement du critère d’intention de l’emplacement du groupe d’annonces - En bloc

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

Chaque critère d’intention d’emplacement définit l’option d’intention pour tous les critères d’emplacement et de rayon de la campagne ou du groupe d’annonces. Il n’y a pas d’ajustement de l’offre des critères d’accompagnement.

Le nombre maximal de critères d’intention d’emplacement que vous pouvez spécifier par campagne ou groupe d’annonces est un.

Vous pouvez télécharger tous les enregistrements du critère d’intention d’emplacement 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 d’intention d’emplacement 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 Location Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,

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 BulkAdGroupLocationIntentCriterion , 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 BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
    // '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 LocationIntentCriterion
        {
            // 'Target' column header in the Bulk file
            IntentOption = IntentOption.PeopleIn
        },

        CriterionBid = null,

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

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

uploadEntities.Add(bulkAdGroupLocationIntentCriterion);

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

• Groupe d’annonces
• Campagne
• Client Id
• Id
• Heure de modification
• Parent Id
• État
• Target (Cible)

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

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 du critère.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
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 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

État

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

Target

Détermine si une personne doit être physiquement située à l’emplacement ciblé pour que l’annonce s’affiche.

Les valeurs suivantes sont prises en charge. La valeur par défaut est PeopleInOrSearchingForOrViewingPages.

• Utilisez PeopleInOrSearchingForOrViewingPages si vous souhaitez afficher des publicités à des personnes dans, rechercher ou afficher des pages sur votre emplacement ciblé.
• Utilisez PeopleIn si vous souhaitez afficher des publicités à des personnes dans votre emplacement ciblé.

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, il doit être défini sur une valeur valide, par exemple PeopleInOrSearchingForOrViewingPages ou PeopleIn.
Supprimer: En lecture seule