Kampagnen negativer Schlüsselwortdatensatz – Massenvorgang

Definiert eine negative Schlüsselwort (keyword) einer Kampagne zugewiesen, die in eine Massendatei hochgeladen und heruntergeladen werden kann.

Im Massenschema werden alle negativen Schlüsselwörter, die einer Kampagne zugeordnet sind, einzeln durch eine eigene Zeile dargestellt. Wenn eine Kampagne z. B. zwei negative Schlüsselwörter aufweist, werden diese durch zwei Kampagnen negative Schlüsselworteinträge in der Massendatei dargestellt, wobei status auf Aktiv festgelegt ist.

Hinweis

Das kampagnen negative Schlüsselwort kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.

Sie können alle Kampagnen negative Schlüsselworteinträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeKeywords 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 eine neue negative Kampagne Schlüsselwort (keyword) 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,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Campaign Negative Keyword,Active,,-112,,,ClientIdGoesHere,,shoes,Exact,

Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager verwenden, um das BulkCampaignNegativeKeyword-Objekt hochzuladen und herunterzuladen, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zu schreiben, um jedes Feld in der Massendatei zu analysieren.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeKeyword
var bulkCampaignNegativeKeyword = new BulkCampaignNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeKeyword);

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 Kampagnenschlüsselwort sind die folgenden Attributfelder im Massendateischema verfügbar.

• Kampagnen
• Client-ID
• Id
• Schlüsselwort
• Übereinstimmungstyp
• Änderungszeit
• Übergeordnete ID
• Status

Kampagne

Der Name der Kampagne, die die negative Schlüsselwort (keyword) enthält.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt und erforderlich

Hinweis

Zum Hinzufügen 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: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner des negativen Schlüsselwort (keyword).

Hinzufügen: Schreibgeschützt
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt und erforderlich

Schlüsselwort

Der negative Schlüsselwort (keyword) Text.

Der Text darf maximal 100 Zeichen enthalten.

Hinzufügen: Erforderlich
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Übereinstimmungstyp

Der Typ der Übereinstimmung, um die negative Schlüsselwort (keyword) und den Suchbegriff des Benutzers zu vergleichen.

Die unterstützten Übereinstimmungstypwerte für einen negativen Schlüsselwort (keyword) sind Phrase und Exact.

Hinzufügen: Erforderlich
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
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: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Übergeordnete ID

Der vom System generierte Bezeichner der Kampagne, die die negative Schlüsselwort (keyword) 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 negative Schlüsselwörter hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Hinweis

Zum Hinzufügen und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.

Status

Stellt die Zuordnung status zwischen der Kampagne und dem negativen Schlüsselwort (keyword) dar.

Wenn der negative Schlüsselwort (keyword) der Kampagne zugeordnet ist, ist der Wert dieses Felds Aktiv.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Nicht zutreffend. Ein negativer Schlüsselwort (keyword) kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden. Um einen bestimmten negativen Schlüsselwort (keyword) zu löschen, müssen Sie den Status, die ID und die übergeordnete ID hochladen. Um alle negativen Schlüsselwörter für die Kampagne zu löschen, müssen Sie nur den Status und die übergeordnete ID in einem einzigen Datensatz hochladen. Optional können Sie dann neue negative Schlüsselwort (keyword) Datensätze hinzufügen, um den gelöschten Satz zu ersetzen.