Freigeben über


Datensatz für negatives Store-Kriterium der Kampagne – Massen

Definiert ein kampagnen negatives Store-Kriterium, das in eine Massendatei hochgeladen und heruntergeladen werden kann.

Jedes Negative Store-Kriterium der Kampagne schließt einen Microsoft Merchant Center-Store von Ihrer Shoppingkampagne für Marken aus. Jede Kampagne kann maximal 10 ausgeschlossene Stores enthalten.

Sie können alle Datensätze des negativen Kampagnenspeicherkriteriums im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeStoreCriterions 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 neues negatives Speicherkriterium für die Kampagne hinzugefügt, wenn ein gültiger Wert für die übergeordnete ID angegeben wird.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Store Id,Name
Format Version,,,,,,,,,6.0
Campaign Negative Store Criterion,Active,,-114,,,ClientIdGoesHere,,StoreIdGoesHere,

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 BulkCampaignNegativeStoreCriterion-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 BulkCampaignNegativeStoreCriterion
var bulkCampaignNegativeStoreCriterion = new BulkCampaignNegativeStoreCriterion
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new StoreCriterion
        {
            // 'Store Id' column header in the Bulk file
            StoreId = StoreIdGoesHere,
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // '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
};

uploadEntities.Add(bulkCampaignNegativeStoreCriterion);

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

Kampagne

Der Name der Kampagne, die das Store-Kriterium enthält.

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

Hinweis

Zum Hinzufügen, Aktualisieren 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 Speicher kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner des Speicherkriteriums.

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

Übergeordnete ID

Der vom System generierte Bezeichner der Kampagne, die das Store-Kriterium 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 dynamische Anzeigenziele hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Nicht zutreffend. Ein negativer Speicher kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Schreibgeschützt

Hinweis

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

Status

Die status des Store-Kriteriums.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Nicht zutreffend. Ein negativer Speicher kann hinzugefügt und gelöscht, aber nicht aktualisiert werden.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Store-ID

Der vom System generierte Bezeichner des auszuschließenden Microsoft Merchant Center-Speichers.

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