Datensatz des Ad Group Location Intent-Kriteriums – Massen
Definiert ein Kriterium für den Speicherort einer Anzeigengruppe, das in eine Massendatei hochgeladen und heruntergeladen werden kann.
Jedes Standortabsichtskriterium definiert die Absichtsoption für alle Standort- und Radiuskriterien der Kampagne oder Anzeigengruppe. Es gibt keine begleitende Gebotsanpassung.
Die maximale Anzahl von Standortabsichtskriterien, die Sie pro Kampagne oder Anzeigengruppe angeben können, ist eins.
Hinweis
Sie können nur über einen Datensatz für das Ad Group Location Intent Criterion pro Anzeigengruppe verfügen, um die Standortabsichtsoption zu bestimmen, die für alle Datensätze des Ad Group Location Criterion und des Anzeigengruppenradiuskriteriums gilt. Wenn Sie das erste Kriterium der Anzeigengruppe erstellen, wird auch automatisch ein Datensatz für das Ad Group Location Intent Criterion hinzugefügt, wobei der Standardziel auf PeopleInOrSearchingForOrViewingPages festgelegt ist. Sie können das Ad Group Location Intent Criterion einer Anzeigengruppe hinzufügen oder aktualisieren, unabhängig davon, ob die Anzeigengruppe über andere Kriterien verfügt oder nicht. Sie können das Ad Group Location Intent-Kriterium einer Anzeigengruppe nicht löschen, obwohl es ohne Standort- oder Radiuskriterien keinen Zweck hat.
PeopleSearchingForOrViewingPages ist ab April 2024 veraltet. Wenn Sie versuchen, IntentOption auf PeopleSearchingForOrViewingPages festzulegen, wird es stattdessen auf PeopleInOrSearchingForOrViewingPages festgelegt. Vorhandene Kampagnen mit dieser Einstellung werden automatisch in PeopleInOrSearchingForOrViewingPages konvertiert.
Wichtig
Legen Sie AIM Location Intent Criteria auf PeopleIn anstelle von PeopleInOrSearchingForOrViewingPages fest.
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 Ad Group Location Intent Criterion 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 Kriterium für den Standort der 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 Location Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,
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 BulkAdGroupLocationIntentCriterion-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 BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
// '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 LocationIntentCriterion
{
// 'Target' column header in the Bulk file
IntentOption = IntentOption.PeopleIn
},
CriterionBid = null,
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupLocationIntentCriterion);
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 des Ad Group Location Intent Criterion 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 Bezeichner des Kriteriums.
Hinweis
Derzeit ist der Bezeichner des Standortabsichtskriteriums gleich dem übergeordneten Bezeichner, obwohl Sie keine Abhängigkeit von dieser Beziehung annehmen sollten. Als bewährte Methode sollten Sie den Bezeichner des Standortabsichtskriteriums als eindeutig betrachten.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Ä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 für die Anzeigengruppe festgelegt ist, 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 Standortabsichtskriterium zu löschen, müssen Sie den Status und die übergeordnete ID hochladen.
Ziel
Bestimmt, ob sich eine Person physisch am Zielort befinden muss, damit die Anzeige angezeigt werden kann.
Die folgenden Werte werden unterstützt. Der Standardwert ist PeopleInOrSearchingForOrViewingPages.
- Verwenden Sie PeopleInOrSearchingForOrViewingPages , wenn Sie Anzeigen für Personen anzeigen möchten, die auf Ihren Zielstandort verweisen, nach Seiten suchen oder diese anzeigen möchten.
- Verwenden Sie PeopleIn , wenn Sie Anzeigen für Personen an Ihrem Zielstandort anzeigen möchten.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld festlegen, muss es auf einen gültigen Wert festgelegt werden, d. h. PeopleInOrSearchingForOrViewingPages oder PeopleIn.
Löschen: Schreibgeschützt