Freigeben über


Datenausschlussdatensatz – Massendatensatz

Definiert die Datenausschlussfelder, die in eine Massendatei hochgeladen und heruntergeladen werden können.

Sie können alle Datenausschlussdatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von SeasonalityAdjustments 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 neuer Datenausschluss hinzugefügt.

Type,AccountId,Id,Campaign Type,Start Date,End Date,Name,Description,Data Exclusion,Device Type,Campaign Associations
Format Version,,,,,,6.0,,,,
Data Exclusion,,,Search,3/15/2024 3:00,3/16/2024 3:00,,Description,TestDE,Tablets,

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 BulkAdGroupDataExclusion-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 BulkDataExclusion
var bulkDataExclusion = new BulkDataExclusion
{
    // Map properties in the Bulk file to the
    // DataExclusion object of the Campaign Management service.
    DataExclusion = new DataExclusion
    {
        // 'Campaign Associations' column header in the Bulk file
        CampaignAssociations = new List<CampaignAssociation>(),
        // 'Campaign Type' column header in the Bulk file
        CampaignTypeFilter = CampaignType.Search,
        // 'Description' column header in the Bulk file
        Description = "Description",
        // 'Device Type' column header in the Bulk file
        DeviceTypeFilter = DeviceType.Computers,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Start Date' column header in the Bulk file
        StartDate = DateTime.UtcNow,
        // 'End Date' column header in the Bulk file
        EndDate = DateTime.UtcNow.AddDays(7),
        // 'Data Exclusion' column header in the Bulk file
        Name = "Data Exclusion",
    },
};

uploadEntities.Add(bulkDataExclusion);

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

Kampagnenverbände

Machen Sie den Datenausschluss für diese Kampagnen.

Hinzufügen: Optional
Aktualisieren: Optional
Löschen: Optional. Es kann nur eine von "Kampagnenzuordnungen" und "Kampagnentyp" angegeben werden. Wenn Sie "Kampagnentyp" festlegen, ist dies NULL.

Kampagnentyp

Machen Sie den Datenausschluss für diese Kampagnentypen.

Hinzufügen: Optional
Aktualisieren: Optional
Löschen: Optional. Es kann nur eine von "Kampagnenzuordnungen" und "Kampagnentyp" angegeben werden. Wenn Sie "Kampagnenzuordnungen" festlegen, ist dies NULL.

Beschreibung

Eine Beschreibung für den Datenausschluss.

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

Gerätetyp

Machen Sie den Datenausschluss für diese Gerätetypen.

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

Enddatum

Das Enddatum.

Wichtig: Der Wert muss in koordinierter Weltzeit (UTC) angegeben sein. Dies unterscheidet sich von den Zeitzonenoptionen beim Hochladen von Offlinekonvertierungen in der Microsoft Advertising-Webanwendung. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

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

Id

Der vom System generierte Bezeichner für den Datenausschluss.

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

Datenausschluss

Der Name des Datenausschlusses.

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

Anfangstermin

Das Startdatum.

Wichtig: Der Wert muss in koordinierter Weltzeit (UTC) angegeben sein. Dies unterscheidet sich von den Zeitzonenoptionen beim Hochladen von Offlinekonvertierungen in der Microsoft Advertising-Webanwendung. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

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