Freigeben über


Negativer Schlüsselwortlistendatensatz – Massenvorgang

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

Sie können alle Einträge der Negativen Schlüsselwortliste im Konto herunterladen, indem Sie den DownloadEntity-Wertvon NegativeKeywordLists 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 Schlüsselwort (keyword) Liste hinzugefügt.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Negative Keyword List,Active,-19,,,,ClientIdGoesHere,,,,My Negative Keyword List

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 BulkNegativeKeywordList-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 BulkNegativeKeywordList
var bulkNegativeKeywordList = new BulkNegativeKeywordList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeywordList object of the Campaign Management service.
    NegativeKeywordList = new NegativeKeywordList
    {
        // 'Id' column header in the Bulk file
        Id = negativeKeywordListIdKey,
        // 'Name' column header in the Bulk file
        Name = "My Negative Keyword List",
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkNegativeKeywordList);

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 negativen Schlüsselwortlisten sind die folgenden Attributfelder im Massendateischema verfügbar.

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

Id

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

Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für die negative Schlüsselwort (keyword) Liste kann dann im Feld Id von abhängigen Datensatztypen wie Campaign Negative Keyword List Association verwiesen werden. Dies wird empfohlen, wenn Sie neue negative Schlüsselwort (keyword) Liste hinzufügen und sie Kampagnen in derselben Massendatei zuordnen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
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 Name der negativen Schlüsselwort (keyword) Liste.

Die maximale Länge des Namens beträgt 255.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Status

Die status der liste der negativen Schlüsselwort (keyword).

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.