Freigeben über


Zuordnungsdatensatz für eine negative Schlüsselwortliste der Kampagne – Massenvorgang

Definiert einen Zuordnungsdatensatz zwischen einer Kampagne und einer Negativen Schlüsselwortliste , die in eine Massendatei hochgeladen und heruntergeladen werden kann. Verwenden Sie zum Hochladen oder Herunterladen der Kampagne oder der liste negativer Schlüsselwort (keyword) den Datensatz Kampagne oder Negative Schlüsselwortliste.

Sie können alle Kampagnen negative Keyword List Association-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeKeywordListAssociations 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 einer Kampagne eine negative Schlüsselwort (keyword) Liste zugeordnet, wenn gültige Id- und übergeordnete ID-Werte angegeben werden.

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

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

    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    SharedEntityAssociation = new SharedEntityAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
        // 'Id' column header in the Bulk file
        SharedEntityId = negativeKeywordListIdKey,
    },

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

uploadEntities.Add(bulkCampaignNegativeKeywordList);

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 zur Zuordnung negativer Kampagnenschlüsselwörter sind die folgenden Attributfelder im Massendateischema verfügbar.

Kampagne

Der Name der Kampagne, der die negative Schlüsselwort (keyword) Liste zugeordnet oder entfernt wird.

Hinzufügen: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Hinweis

Zum Hinzufügen und Löschen müssen Sie entweder die ü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
Löschen: Schreibgeschützt

Id

Der Bezeichner des negativen Schlüsselwort (keyword) Liste, die der Kampagne zugeordnet oder daraus entfernt wird.

Dieses Massenfeld wird dem Feld Id des Datensatzes negativer Schlüsselwortliste zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen negativen Schlüsselwort (keyword) Listenbezeichner oder einen negativen Bezeichner angeben, der dem Id-Feld des übergeordneten Datensatzes negativer Schlüsselwortliste entspricht. Dies wird empfohlen, wenn Sie neue negative Schlüsselwort (keyword) Liste hinzufügen und sie einer neuen Kampagne in derselben Massendatei zuordnen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
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
Löschen: Schreibgeschützt

Übergeordnete ID

Der Bezeichner der Kampagne, der diese negative Schlüsselwort (keyword) Liste zugeordnet oder entfernt wird.

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 neue negative Schlüsselwort (keyword) Liste hinzufügen und sie einer neuen Kampagne in derselben Massendatei zuordnen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Löschen: Schreibgeschützt und erforderlich

Hinweis

Zum Hinzufügen und Löschen müssen Sie entweder die übergeordnete ID oder kampagne angeben.

Status

Stellt die Zuordnung status zwischen der Kampagne und der liste der negativen Schlüsselwort (keyword) dar. Wenn die negative Schlüsselwort (keyword) Liste nicht der Kampagne zugeordnet 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.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.