Freigeben über


Negativer Websitedatensatz der Kampagne – Massenvorgang

Definiert eine negative Website, die einer Kampagne zugewiesen ist und in einer Massendatei hochgeladen und heruntergeladen werden kann.

Im Massenschema werden alle negativen Websites, die einer Kampagne zugeordnet sind, einzeln durch eine eigene Zeile dargestellt. Wenn Sie z. B. zwei negative Websites haben, werden diese durch zwei Kampagnen negative Websitedatensätze in der Massendatei dargestellt, deren Status auf Aktiv festgelegt ist. Beim Hochladen oder Herunterladen von Datensätzen für eine aktualisierte Liste der zugeordneten negativen Websites ist für einen Datensatz der Status mit einem leeren Feld "Website " auf "Gelöscht" festgelegt. Dies weist darauf hin, dass einige Änderungen an der Liste vorgenommen wurden und die folgenden Kampagnen negative Websitedatensätze aktiv sind.

Hinweis

Die negative Kampagnenwebsite kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.

Sie können alle Kampagnen negative Websitedatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeSites 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-Website hinzugefügt, wenn ein gültiger Wert für übergeordnete ID angegeben wird.

Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,contoso.com,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 BulkCampaignNegativeSite-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 BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
                
    // Map properties in the Bulk file to the 
    // CampaignNegativeSites object of the Campaign Management service.
    CampaignNegativeSites = new CampaignNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },

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

// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.

// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
    // '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",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
    // 'Website' column header in the Bulk file
    Website = "contoso.com",
};

uploadEntities.Add(bulkCampaignNegativeSite);

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 einer negativen Kampagne-Website sind die folgenden Attributfelder im Massendateischema verfügbar.

Kampagne

Der Name der Kampagne, die die negative Website enthält.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Nicht zutreffend. Eine negative Website 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: Wahlfrei
Aktualisieren: Nicht zutreffend. Eine negative Website 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. Eine negative Website 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 Website 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 Websites hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Nicht zutreffend. Eine negative Website 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 den Zuordnungsstatus zwischen der Kampagne und der negativen Website dar.

Wenn die negative Website der Kampagne zugeordnet ist, ist der Wert dieses Felds Aktiv.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Wahlfrei. Der Standardwert ist Aktiv.
Aktualisieren: Nicht zutreffend. Eine negative Website kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden. Um eine bestimmte negative Website zu löschen, müssen Sie den Status, die übergeordnete ID und die Website hochladen. Um alle negativen Websites 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 Websitedatensätze hinzufügen, um den gelöschten Satz zu ersetzen.

Website

Die URL der Website, auf der Ihre Anzeigen nicht angezeigt werden sollen.

Jede URL muss den Domänennamen angeben, z. B. contoso.com der bis zu drei Unterdomänen und zwei Unterverzeichnisse enthalten kann. Die Anzahl der Unterdomänen enthält das Präfix www . Beispielsweise sind one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 und one.two.contoso.co.uk/1/2 gültige URLs, während one.two.three.contoso.co.uk/1/2 (zu viele Unterdomänen) und one.two.three.contoso.com/1/2/3 (zu viele Unterverzeichnisse) nicht sind. Doppelte negative Website-URLs pro Kampagne oder Anzeigengruppe sind nicht zulässig.

Sie können Websites nur für Syndizierungssuchwebsites ausschließen. Das Netzwerk der Anzeigengruppe muss auf OwnedAndOperatedAndSyndicatedSearch festgelegt werden.

Negative Website-URLs, die auf Anzeigengruppenebene angegeben sind, werden anstelle aller negativen Website-URLs verwendet, die auf Kampagnenebene angegeben sind. Wenn Sie einem Anzeigenkonto (verfügbar über den Kampagnenverwaltungsdienst) Websiteausschlusslisten zuordnen, wird die Liste der negativen Websites zusätzlich zu den negativen Kampagnen- oder Anzeigengruppenseiten verwendet.

Hinzufügen: Erforderlich
Aktualisieren: Nicht zutreffend. Eine negative Website kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt