Anzeigengruppen-DeviceOS-Kriteriumdatensatz – Massen
Definiert ein Anzeigengruppen-Gerätekriterium, das in einer Massendatei hochgeladen und heruntergeladen werden kann.
Wenn Sie nach Gerät als Zielziel verwenden, entscheiden Sie sich dafür, potenziellen Kunden Bei der Verwendung von Desktops, Tablets oder Smartphones Anzeigen zu zeigen.
Jedes Gerätekriterium definiert einen Gerätenamen für die begleitende Gebotsanpassung des Kriteriums.
Die maximale Anzahl von Gerätekriterien, die Sie pro Kampagne oder Anzeigengruppe angeben können, ist drei. Sie müssen entweder über drei separate Kriterien für Computer, Smartphones und Tablets verfügen, andernfalls können keine Gerätekriterien für die Kampagne oder Anzeigengruppe vorhanden sein.
Wenn Gerätekriterien auf Anzeigengruppenebene angegeben werden, werden die Gerätekriterien auf Kampagnenebene für diese Anzeigengruppe ignoriert. Anders ausgedrückt: Die Gerätekriterien der Anzeigengruppe überschreiben die Gerätekriterien der Kampagne und werden nicht als Union angewendet.
Tipp
Eine Übersicht über die Verwendung von Zielkriterien finden Sie unter Anzeigen von Anzeigen für Ihre Zielgruppe.
Sie können alle DeviceOS-Kriteriumdatensätze 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 werden drei neue Gerätekriterien für Anzeigengruppen hinzugefügt (eines für jeden Gerätetyp), 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,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group DeviceOS Criterion,Active,,-1111,,,,ClientIdGoesHere,,Computers,20,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,,
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 BulkAdGroupDeviceOSCriterion-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>();
var bulkAdGroupDeviceCriterions = new [] {
// Map properties in the Bulk file to the BulkAdGroupDeviceCriterion
new BulkAdGroupDeviceCriterion
{
// '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 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 = AdGroupCriterionStatus.Active,
}
},
new BulkAdGroupDeviceCriterion
{
ClientId = "ClientIdGoesHere",
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
AdGroupId = adGroupIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Smartphones",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
new BulkAdGroupDeviceCriterion
{
ClientId = "ClientIdGoesHere",
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
AdGroupId = adGroupIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Tablets",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
};
foreach (var bulkAdGroupDeviceCriterion in bulkAdGroupDeviceCriterions)
{
uploadEntities.Add(bulkAdGroupDeviceCriterion);
}
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 Ad Group DeviceOS Criterion-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
Anzeigengruppe
Der Name der Anzeigengruppe, in der dieses Kriterium angewendet oder entfernt wird.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Gebotsanpassung
Der Prozentsatz, den Sie das Gebot für das entsprechende Ziel anpassen möchten.
Unterstützte Werte sind -100 (negativ einhundert) bis positive 900 (neunhundert) Prozent. Wenn Sie die Gebotsanpassung auf -100 Prozent festlegen, wird das entsprechende Ziel ausgeschlossen.
Hinzufügen: Optional. Die Gebotsanpassung wird auf den Standardwert 0 festgelegt, wenn sie nicht enthalten ist.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt
Kampagne
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
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: Optional
Id
Der eindeutige Microsoft Advertising-Bezeichner des Kriteriums.
Hinzufügen: Schreibgeschützt
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 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
Status
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. Um ein bestimmtes Gerätekriterium-Gebot zu löschen, müssen Sie den Status, die ID und die übergeordnete ID hochladen.
Ziel
Der Name des Geräts, für das Sie die entsprechende Gebotsanpassung verwenden möchten.
Unterstützte Werte sind Computer, Smartphones und Tablets.
Hinzufügen: Erforderlich. Drei separate Gebote für Computer, Smartphones und Tablets sollten zusammen in der Massendatei angegeben werden (jedes Gebot in einem separaten Datensatz/einer separaten Zeile). Wenn Sie keine einzelnen Gerätekriterien hinzufügen, die jeden der drei Gerätetypen darstellen, werden keine Gerätekriterien für die Anzeigengruppe hinzugefügt.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt