Budgetdatensatz – Massenvorgang
Definiert ein Budget, das in eine Massendatei hochgeladen und heruntergeladen werden kann.
Sie können ein einzelnes Tagesbudget festlegen, das von jeder Kampagne innerhalb desselben Kontos verwendet werden kann. Auf diese Weise können Sie ein einzelnes Tagesbudget effizient auf alle Kampagnen oder eine definierte Gruppe von Kampagnen in Ihrem Microsoft Advertising-Konto verteilen.
Angenommen, Sie haben ein Budget von 20 US-Dollar, das zwischen zwei Kampagnen pro Tag einheitlich verwendet werden kann. An einem bestimmten Tag gibt Kampagne A nur $ 8 (von ihrem Budget von $ 10) aus, da sie eine geringere Anzahl von Eindrücken und Klicks als üblich erhielt. Wenn Kampagne B gut funktioniert, werden von Microsoft Advertising bei Verwendung eines gemeinsamen Budgets automatisch die restlichen 2 US-Dollar in Die Zuweisung zu Kampagne B eingeteilt. Dies erhöht die Wahrscheinlichkeit, dass das verbleibende Budget verwendet wird, um Ihnen mehr Datenverkehr zu senden.
Sie können alle Budgetdatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von Budgets in die Serviceanforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.
Im folgenden Massen-CSV-Beispiel wird ein neues Budget hinzugefügt.
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,
Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Hochladen und Herunterladen des BulkBudget-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.
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();
Für einen Budgetdatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
Budget
Der Betrag, der täglich für alle Kampagnen ausgegeben werden soll, die sich das Budget teilen.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Budgetname
Der Name des Budgets. Der Name muss für alle Budgets innerhalb des Kontos eindeutig sein. Der Name darf maximal 255 Zeichen enthalten.
Der Dienst führt einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung durch, wenn er den Namen mit vorhandenen Budgetnamen vergleicht.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Budgettyp
Der Budgettyp bestimmt die Geschwindigkeit, in der das Budget im Laufe des Tages ausgegeben wird.
Der einzige gültige Budgettyp, den Sie festlegen können, ist DailyBudgetStandard.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Client-ID
Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.
Hinzufügen: Optional
Aktualisieren: Optional
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner des Budgets.
Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für das Budget kann dann im Feld Budget-ID abhängiger Datensatztypen wie Campaign verwiesen werden. Dies wird empfohlen, wenn Sie ein neues Budget und neue abhängige Datensätze in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Änderungszeit
Das Datum und die Uhrzeit der letzten Aktualisierung der Entität. Der Wert wird in UTC (Coordinated Universal Time) angegeben.
Hinweis
Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Übergeordnete ID
Der vom System generierte Bezeichner des Kontos, das das Budget enthält.
Dieses Massenfeld wird dem Feld Id des Kontodatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Status
Die status des Haushaltsplans.
Mögliche Werte sind Aktiv oder Gelöscht.
Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.