Ad Group Negative Location Criterion Record – Bulk (Datensatz für negative Position in der Anzeigengruppe – Massen)
Definiert ein negatives Standortkriterium für die Anzeigengruppe, das in einer Massendatei hochgeladen und heruntergeladen werden kann.
Obwohl Standortkriterien am häufigsten verwendet werden, um die spezifischen Orte anzugeben, an denen Sie Ihre Anzeigen anzeigen möchten, können Sie in Microsoft Advertising auch Standorte angeben, die Sie von der Anzeige Ihrer Anzeigen ausschließen möchten.
Jedes negative Standortkriterium definiert einen Standortcode, bei dem Ihre Anzeigen nicht angezeigt werden sollen.
Die maximale Anzahl von kombinierten Standort- und negativen Standortkriterien, die Sie pro Kampagne oder Anzeigengruppe angeben können, beträgt 10.000.
Wenn Standortkriterien auf Anzeigengruppenebene angegeben werden (positiv oder negativ), werden die Standortkriterien auf Kampagnenebene für diese Anzeigengruppe ignoriert. Anders ausgedrückt: Die Standortkriterien der Anzeigengruppe überschreiben die Standortkriterien der Kampagne und werden nicht als Union angewendet.
Beachten Sie außerdem, dass Sie die Kriterien Standort, negativer Standort und Radius als eine Reihe von geografischen Kriterien berücksichtigen müssen. Wenn die Anzeigengruppe über geografische Kriterien verfügt, wird keines der geografischen Kriterien der Kampagne geerbt. Wenn die Anzeigengruppe über keine geografischen Kriterien verfügt, werden alle geografischen Kriterien der Kampagne geerbt. Die geografischen Kriterien können von der Kampagne geerbt werden, auch wenn die Anzeigengruppe über ein Standortabsichtskriterium verfügt. Wenn die geografischen Kriterien der Anzeigengruppe verwendet werden, wird das Standortzielkriterium der Anzeigengruppe verwendet. Wenn die geografischen Kriterien der Kampagne geerbt werden, wird das Standortabsichtskriterium der Kampagne verwendet, und das Standortzielkriterium der Anzeigengruppe wird ignoriert. Sie können das Standortzielkriterium einer Kampagne oder Anzeigengruppe nicht löschen, obwohl es ohne Standort- oder Radiuskriterien keinen Zweck hat.
Tipp
Eine Übersicht über die Verwendung von Zielkriterien finden Sie unter Anzeigen von Anzeigen für Ihre Zielgruppe.
Sie können alle Datensätze des Kriteriums "Negativer Speicherort 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 Negatives Standortkriterium für die Anzeigengruppe hinzugefügt, wenn ein gültiger Wert für ü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 Negative Location Criterion,Active,,-1111,PostalCode,,,ClientIdGoesHere,,79381,,,,,,,,,,,
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 BulkAdGroupNegativeLocationCriterion-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 BulkAdGroupNegativeLocationCriterion
var bulkAdGroupNegativeLocationCriterion = new BulkAdGroupNegativeLocationCriterion
{
// '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
// NegativeAdGroupCriterion object of the Campaign Management service.
NegativeAdGroupCriterion = new NegativeAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new LocationCriterion
{
// 'Target' column header in the Bulk file
LocationId = 79381,
// 'Sub Type' column header in the Bulk file
LocationType = "PostalCode"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupNegativeLocationCriterion);
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 mit einem Negativen Ortungskriterium der Anzeigengruppe 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
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 negatives Standortkriterium zu löschen, müssen Sie den Status, die ID und die übergeordnete ID hochladen.
Untertyp
Der Standortuntertyp, den Sie nicht als Ziel verwenden. Der Wert ist z. B . City , wenn der Datensatz ein Standortkriterium darstellt.
Hinweis
Nachbarschaftsstandorte sind in Kürze verfügbar. Der Untertyp ist Nachbarschaft.
Neue Standortuntertypen können jederzeit hinzugefügt werden. In seltenen Fällen ändert sich der Standorttyp für eine bestimmte Standort-ID.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Ziel
Der Bezeichner des Speicherorts, den Sie nicht als Ziel verwenden möchten.
Mögliche Werte finden Sie im Feld Standort-ID der Datei für geografische Standorte. Sie können den Vorgang GetGeoLocationsFileUrl aufrufen, um die Datei herunterzuladen.
Wichtig
Überprüfen Sie das Feld Status in der Datei mit den geografischen Standorten , bevor Sie ein Standortkriterium hinzufügen oder aktualisieren. Wenn die status PendingDeprecation lautet, wird das Standortkriterium nicht mehr für Ziel- oder Ausschlüsse verwendet. Veraltete Standortkriterien können weiterhin abgerufen werden, sie können jedoch keine veralteten Standortkriterien hinzufügen oder aktualisieren.
Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt