Campaign DeviceOS Criterion Record – Bulk
Definiert ein Kampagnengerä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 Campaign DeviceOS Criterion-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignTargetCriterions 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 Kampagnengerätekriterien (eines für jeden Gerätetyp) hinzugefügt, wenn ein gültiger Wert für die übergeordnete ID angegeben wird.
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,,,,,,,,,
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 BulkCampaignDeviceOSCriterion-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 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();
Für einen Campaign DeviceOS Criterion-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
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, 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 Kampagne, in der dieses Kriterium angewendet oder entfernt wird.
Dieses Massenfeld wird dem Feld Id des Kampagnendatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Kampagnenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Kampagnendatensatzes entspricht. Dies wird empfohlen, wenn Sie einer neuen Kampagne 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 Kampagne und dem Kriterium dar. Wenn das Kriterium auf die Kampagne 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 für die Kampagne keine Gerätekriterien hinzugefügt.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt