Enregistrement de budget - En bloc
Définit un budget qui peut être chargé et téléchargé dans un fichier en bloc.
Vous pouvez définir un seul budget quotidien qui peut être utilisé par n’importe quelle campagne au sein du même compte. Cela vous permet de distribuer efficacement un seul budget quotidien sur toutes les campagnes ou sur un groupe défini de campagnes au sein de votre compte Microsoft Advertising.
Supposons que vous ayez un budget de 20 $ à utiliser uniformément entre deux campagnes chaque jour. Sur un jour donné, la campagne A dépense seulement 8 $ (sur son budget de 10 $) parce qu’elle a obtenu une plus petite quantité d’impressions et de clics que d’habitude. À l’aide d’un budget partagé, si la campagne B fonctionne bien, Microsoft Advertising prend automatiquement les 2 $ restants et les alloue à la campagne B. Cela augmente les chances que le budget restant soit utilisé pour vous envoyer plus de trafic.
Vous pouvez télécharger tous les enregistrements Budget dans le compte en incluant la valeur DownloadEntity de Budgets 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 budget.
Type,Status,Id,Parent Id,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Name
Format Version,,,,,,,,,,6.0
Budget,Active,-20,0,ClientIdGoesHere,,,My Shared Budget,50,DailyBudgetStandard,
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 BulkBudget , 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 BulkBudget
var bulkBudget = new BulkBudget
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// Map properties in the Bulk file to the
// Budget object of the Campaign Management service.
Budget = new Budget
{
// 'Budget' column header in the Bulk file
Amount = 50,
// 'Budget Type' column header in the Bulk file
BudgetType = BudgetLimitType.DailyBudgetStandard,
// 'Budget Name' column header in the Bulk file
Name = "My Shared Budget",
// 'Id' column header in the Bulk file
Id = budgetIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkBudget);
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 Budget , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
Budget
Montant à dépenser quotidiennement pour toutes les campagnes qui partagent le budget.
Ajouter: Obligatoire
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
Nom du budget
Nom du budget. Le nom doit être unique parmi tous les budgets du compte. Le nom peut contenir un maximum de 255 caractères.
Le service effectue une comparaison qui ne respecte pas la casse lorsqu’il compare le nom aux noms de budget existants.
Ajouter: Obligatoire
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
Budget Type
Le type de budget détermine le rythme auquel le budget est dépensé tout au long de la journée.
Le seul type de budget valide que vous pouvez définir est DailyBudgetStandard.
Ajouter: Obligatoire
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
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
ID
Identificateur généré par le système du budget.
Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un ensemble d’identificateurs négatifs pour le budget peut ensuite être référencé dans le champ Id de budget des types d’enregistrements dépendants tels que Campaign. Cela est recommandé si vous ajoutez un nouveau budget 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
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 le budget.
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
Statut
Status du budget.
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é.