Freigeben über

Ad Group Negative dynamic search ad target record – Bulk

  • Artikel

Definiert ein Ad Group Negative Dynamic Search Ad Target, das in eine Massendatei hochgeladen und heruntergeladen werden kann.

Der Ad Group Negative Dynamic Search Ad Target-Datensatz kann nur in Suchkampagnen erstellt werden, die über gültige Dynamische Suchanzeigeneinstellungen verfügen (bestehend aus den Feldern Domänensprache, Dynamische Beschreibung aktiviert, Seitenfeed-IDs, Quelle und Website ). Die Experiment-ID der Kampagne muss festgelegt werden, und der Anzeigengruppentyp muss auf "SearchDynamic" festgelegt werden.

Sie können alle Ad Group Negative Dynamic Search Ad Target-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von AdGroupNegativeDynamicSearchAdTargets 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 negatives dynamisches Suchanzeigenziel für eine neue Anzeigengruppe 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,,,,,,,,
Ad Group Negative Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,,Bulk Ad Group Dynamic Search Ad Target,,,Url,Category,PageContent,contoso.com,US/CA/,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 BulkAdGroupNegativeDynamicSearchAdTarget-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 BulkAdGroupNegativeDynamicSearchAdTarget
var bulkAdGroupNegativeDynamicSearchAdTarget = new BulkAdGroupNegativeDynamicSearchAdTarget
{
    // 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 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/",
                        // '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 Ad Group Negative Dynamic Search Ad Target"
            }
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupNegativeDynamicSearchAdTarget);

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 Negative Dynamic Search Ad Target-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Anzeigengruppe

Der Name der Anzeigengruppe, 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 Anzeigengruppe angeben.

Kampagne

Der Name der Kampagne, die die Anzeigengruppe und das dynamische Anzeigenziel (Webseitenkriterium) enthält.

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: 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 Anzeigengruppe 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 Anzeigengruppe 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 Anzeigengruppe 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 Anzeigengruppe 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 Anzeigengruppe 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 Anzeigengruppe 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 die delete_value Schlüsselwort (keyword) angeben, wird der Kriterienname 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 Anzeigengruppe, die das dynamische Anzeigenziel (Webseitenkriterium) enthält.

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 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 Anzeigengruppe 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.