Anzeigengruppenlänge des Datensatzes des Kriteriums "Bleibdauer" – Massen
Definiert ein Anzeigegruppendauerkriterium, das in einer Massendatei hochgeladen und heruntergeladen werden kann.
Tipp
Eine Übersicht über die Verwendung von Zielkriterien finden Sie unter Anzeigen von Anzeigen für Ihre Zielgruppe.
Sie können alle Datensätze zur Länge des Verweilkriteriums der Anzeigengruppe im Konto herunterladen, indem Sie den DownloadEntity-Wert von AdGroupTargetCriterions 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 Bleibekriterium für die Anzeigengruppe hinzugefügt, wenn ein gültiger Wert für die übergeordnete ID angegeben wird.
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Target,Min Target Value,Max Target Value,Name
Format Version,,,,,,,,,,,,,6
Ad Group Length of Stay Criterion,Active,,-1111,,,,ClientIdGoesHere,,10,,5,10,
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 BulkAdGroupLengthOfStayCriterion-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 BulkAdGroupLengthOfStayCriterion
var bulkAdGroupLengthOfStayCriterion = new BulkAdGroupLengthOfStayCriterion
{
// '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 LengthOfStayCriterion
{
// 'MinNights' column header in the Bulk file
MinNights = 2,
// 'MaxNights' column header in the Bulk file
MaxNights = 5
},
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(bulkAdGroupLengthOfStayCriterion);
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 Datensatz zur Länge des Verweilkriteriums der Anzeigengruppe sind die folgenden Attributfelder im Massendateischema verfügbar.
- Anzeigengruppe
- Gebotsanpassung
- Kampagnen
- Client-ID
- Id
- Änderungszeit
- Übergeordnete ID
- Status
- Untertyp
- Target
Der Name der Anzeigengruppe, in der dieses Kriterium angewendet oder entfernt wird.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Der Prozentsatz, den Sie das Gebot für das entsprechende Ziel anpassen möchten.
Unterstützte Werte sind negative neunzig (-90) bis positive neunhundert (900).
Hinzufügen: Optional. Die Gebotsanpassung wird auf den Standardwert 0 festgelegt, wenn sie nicht enthalten ist.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt
Der Name der Kampagne, die die Anzeigengruppe enthält, in der dieses Kriterium angewendet oder entfernt wird.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
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: Optional
Der eindeutige Microsoft Advertising-Bezeichner des Kriteriums.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
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
Der Bezeichner der Anzeigengruppe, in der dieses Kriterium angewendet oder entfernt wird.
Dieses Massenfeld wird dem Feld Id des Anzeigengruppendatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Anzeigengruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Anzeigengruppendatensatzes entspricht. Dies wird empfohlen, wenn Sie einer neuen Anzeigengruppe in derselben Massendatei neue Kriterien hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Stellt die Zuordnung status zwischen der Anzeigengruppe und dem Kriterium dar. Wenn das Kriterium auf die Anzeigengruppe angewendet wird, ist der Wert dieses Felds Aktiv. Um das Kriterium zu löschen, legen Sie die status auf Gelöscht fest.
Hinzufügen: Schreibgeschützt. Die status wird immer auf Aktiv festgelegt, wenn Sie Kriterien hinzufügen. Wenn Sie z. B. einen anderen Wert hochladen, enthält foo die Ergebnisdatei denselben Wert, obwohl das Kriterium aktiv ist.
Aktualisieren: Optional
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden. Zum Löschen eines bestimmten Gebots für die Dauer des Aufenthaltskriteriums müssen Sie den Status, die ID und die übergeordnete ID hochladen.
Die Länge des Untertyps "Aufenthalt", auf den Sie abzielen.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Der Bezeichner der Verweildauer, die Sie mit der entsprechenden Gebotsanpassung anzielen möchten.
Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt