Enregistrement du critère DeviceOS de campagne - En bloc

Article
12/21/2023

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

Lorsque vous ciblez par appareil, vous choisissez d’afficher des publicités aux clients potentiels lorsqu’ils utilisent des ordinateurs de bureau, des tablettes ou des smartphones.

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

Le nombre maximal de critères d’appareil que vous pouvez spécifier par campagne ou groupe d’annonces est de trois. Vous devez avoir trois critères distincts pour ordinateurs, smartphones et tablettes, sinon aucun critère d’appareil ne peut exister pour la campagne ou le groupe d’annonces.

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

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 Campaign DeviceOS 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 trois nouveaux critères d’appareil de campagne (un pour chaque type d’appareil) 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 DeviceOS Criterion,Active,,-111,,,ClientIdGoesHere,,Computers,20,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,

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 BulkCampaignDeviceOSCriterion , 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>();

var bulkCampaignDeviceCriterions = new[] {
    // Map properties in the Bulk file to the BulkCampaignDeviceCriterion
    new BulkCampaignDeviceCriterion
    {
        // '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 DeviceCriterion
            {
                // 'Target' column header in the Bulk file
                DeviceName = "Computers",
            },

            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,
        }
    },
    new BulkCampaignDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        CampaignCriterion = new BiddableCampaignCriterion
        {
            CampaignId = campaignIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Smartphones",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
    new BulkCampaignDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        CampaignCriterion = new BiddableCampaignCriterion
        {
            CampaignId = campaignIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Tablets",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
};

foreach (var bulkCampaignDeviceCriterion in bulkCampaignDeviceCriterions)
{
    uploadEntities.Add(bulkCampaignDeviceCriterion);
}

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

Ajustement de l’enchère
Campagne
Client Id
Id
Heure de modification
Parent Id
État
Target (Cible)

Ajustement de l’enchère

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

Les valeurs prises en charge sont de -100 (une centaine négatives) à 900 (neuf cents) pour cent positifs. La définition de l’ajustement de l’enchère sur -100 % entraîne l’exclusion de la cible correspondante.

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 de la 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. Cette option est recommandée 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’appareil spécifique, vous devez charger l’état, l’ID et l’ID parent.

Target

Nom de l’appareil que vous souhaitez cibler avec l’ajustement d’enchère correspondant.

Les valeurs prises en charge sont Ordinateurs, Smartphones et Tablettes.

Ajouter: Obligatoire. Trois enchères distinctes pour les ordinateurs, smartphones et tablettes doivent être spécifiées ensemble dans le fichier en bloc (chaque enchère dans un enregistrement/ligne distinct). Si vous n’ajoutez pas de critères d’appareil individuels représentant chacun des trois types d’appareils, aucun critère d’appareil n’est ajouté pour la campagne.
Mettre à jour: Obligatoire
Supprimer: En lecture seule

Partager via