Kampagnen negativer dynamischer Suchanzeigen-Zieldatensatz – Massen
Definiert ein kampagnen negatives dynamisches Suchanzeigenziel, das in eine Massendatei hochgeladen und heruntergeladen werden kann.
Der Kampagneneintrag negative dynamische Suchanzeigenziel kann nur in Suchkampagnen erstellt werden, die über gültige dynamische Suchanzeigeneinstellungen verfügen (bestehend aus den Feldern Domänensprache, Dynamische Beschreibung aktiviert, Seitenfeed-ID, Quelle und Website ). Die Experiment-ID der Kampagne muss festgelegt werden, und der Anzeigengruppentyp muss auf "SearchDynamic" festgelegt werden.
Sie können alle Kampagnen negative dynamischen Suchzieldatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeDynamicSearchAdTargets 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 dynamisches Suchanzeigenziel für die Kampagne hinzugefügt, wenn ein gültiger Wert für übergeordnete ID angegeben wird.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Campaign Negative Dynamic Search Ad Target,Active,,-114,,,ClientIdGoesHere,,,Bulk Campaign Dynamic Search Ad Target,,,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers
Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager verwenden, um das BulkCampaignNegativeDynamicSearchAdTarget-Objekt hochzuladen und herunterzuladen, 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 BulkCampaignNegativeDynamicSearchAdTarget
var bulkCampaignNegativeDynamicSearchAdTarget = new BulkCampaignNegativeDynamicSearchAdTarget
{
// Map properties in the Bulk file to the
// NegativeCampaignCriterion object of the Campaign Management service.
NegativeCampaignCriterion = new NegativeCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new Webpage
{
Parameter = new WebpageParameter
{
Conditions = new[]
{
new WebpageCondition
{
// 'Dynamic Ad Target Value 1' column header in the Bulk file
Argument = "contoso.com",
// 'Dynamic Ad Target Condition 1' column header in the Bulk file
Operand = WebpageConditionOperand.Url
},
new WebpageCondition
{
// 'Dynamic Ad Target Value 2' column header in the Bulk file
Argument = "US/CA/SFO",
// 'Dynamic Ad Target Condition 2' column header in the Bulk file
Operand = WebpageConditionOperand.Category
},
new WebpageCondition
{
// 'Dynamic Ad Target Value 3' column header in the Bulk file
Argument = "flowers",
// 'Dynamic Ad Target Condition 3' column header in the Bulk file
Operand = WebpageConditionOperand.PageContent
},
},
// 'Name' column header in the Bulk file
CriterionName = "Bulk Campaign Negative Dynamic Search Ad Target"
}
},
// 'Id' column header in the Bulk file
Id = null,
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCampaignNegativeDynamicSearchAdTarget);
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 kampagnen negativen dynamischen Suchzieldatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
- Kampagnen
- Client-ID
- Dynamische Werbezielbedingung 1
- Dynamische Werbezielbedingung 2
- Dynamische Werbezielbedingung 3
- Dynamisches Anzeigenzielwert 1
- Zielwert für dynamische Anzeigen 2
- Zielwert für dynamische Anzeigen 3
- Id
- Änderungszeit
- Name
- Übergeordnete ID
- Status
Kampagne
Der Name der Kampagne, die das dynamische Anzeigenziel (Webseitenkriterium) enthält.
Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.
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: Schreibgeschützt
Dynamische Werbezielbedingung 1
Der erste von bis zu 3 Webseitenbedingungsopernden. Die Bedingung ist erfüllt, wenn die Webseiteneigenschaft, auf die von diesem Feld verwiesen wird, den Wert des dynamischen Anzeigenziels 1 enthält oder gleich ist.
Mögliche Werte sind Category, CustomLabel, PageContent, PageTitle und Url.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Dynamische Werbezielbedingung 2
Der zweite von bis zu 3 Webseitenbedingungsopernden. Die Bedingung ist erfüllt, wenn die Webseiteneigenschaft, auf die von diesem Feld verwiesen wird, den Wert des dynamischen Anzeigenziels 2 enthält oder gleich ist.
Mögliche Werte sind Category, CustomLabel, PageContent, PageTitle und Url.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Dynamische Werbezielbedingung 3
Der dritte von bis zu 3 Webseitenbedingungsopernden. Die Bedingung ist erfüllt, wenn die Webseiteneigenschaft, auf die von diesem Feld verwiesen wird, den Wert des dynamischen Anzeigenziels 1 enthält oder gleich ist.
Mögliche Werte sind Category, CustomLabel, PageContent, PageTitle und Url.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Dynamisches Anzeigenzielwert 1
Das erste von bis zu 3 Webseitenbedingungs- oder Kriteriumargumenten.
Sie können diese Zeichenfolge auf die URL, kategorie, den Seitentitel oder den Seiteninhalt für Ihre Website festlegen. Wenn beispielsweise das Feld Dynamische Werbezielbedingung 1 auf URL festgelegt ist, können Sie dieses Feld auf contoso.com/flowers festlegen.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Zielwert für dynamische Anzeigen 2
Das zweite von bis zu 3 Webseitenbedingungs- oder Kriteriumargumenten.
Sie können diese Zeichenfolge auf die URL, kategorie, den Seitentitel oder den Seiteninhalt für Ihre Website festlegen. Wenn beispielsweise das Feld Dynamic Ad Target Condition 2 auf Url festgelegt ist, können Sie dieses Feld auf contoso.com/flowers festlegen.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Zielwert für dynamische Anzeigen 3
Das dritte von bis zu 3 Webseitenbedingungs- oder Kriteriumargumenten.
Sie können diese Zeichenfolge auf die URL, kategorie, den Seitentitel oder den Seiteninhalt für Ihre Website festlegen. Wenn beispielsweise das Feld Dynamic Ad Target Condition 3 auf Url festgelegt ist, können Sie dieses Feld auf contoso.com/flowers festlegen.
Hinzufügen: Optional. Wenn Sie keines der dynamischen Anzeigenziel-Bedingungs- oder Wertfelder festlegen, sind Sie effektiv auf alle Webseiten ausgerichtet. Sie können nur ein dynamisches Anzeigenziel pro Kampagne für alle Webseiten verwenden.
Aktualisieren: Nicht zulässig. Sie können die Bedingungs- oder Wertfelder für dynamische Anzeigen nicht aktualisieren. Um die Webseitenbedingungen zu aktualisieren, müssen Sie das dynamische Anzeigenziel löschen und ein neues hinzufügen.
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner des dynamischen Anzeigenziels (Webseitenkriterium).
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
Name
Der Kriterienname, den Sie verwenden können, um die Kriterien zu identifizieren, z. B. können Sie alphabetisch filtern oder sortieren.
Die Länge des Kriteriumnamens muss zwischen 1 und einschließlich 2048 liegen.
Hinzufügen: Optional. Wenn Sie keinen Namen angeben, wird der Name standardmäßig auf eine verkettete Liste von Bedingungen festgelegt. Jede Bedingung wird durch die Schlüsselwort (keyword) und getrennt. Wenn die Bedingungen z. B. a) Url enthält Blume , b) Url enthält Buch und c) PageContent enthält seattle, lautet der Standardkriteriumsname Url contains flower und URL contains book und PageContent contains seattle. Wenn alle Bedingungs- und Wertfelder leer sind, zielen Sie effektiv auf alle Webseiten ab, und der Name wird auf Alle Webseiten festgelegt.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt. Wenn Sie die delete_value Schlüsselwort (keyword) angeben, wird der Kriterienname effektiv auf den Standardwert aktualisiert, d. h. entweder Alle Webseiten oder eine verkettete Liste von Kriterien.
Löschen: Schreibgeschützt
Übergeordnete ID
Der vom System generierte Bezeichner der Kampagne, die das dynamische Anzeigenziel (Webseitenkriterium) enthält.
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 dynamische Anzeigenziele hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.
Status
Die status des dynamischen Anzeigenziels (Webseitenkriterium).
Mögliche Werte sind Aktiv, Angehalten oder Gelöscht.
Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.