Bezeichnungsdatensatz – Massenvorgang

Artikel
12/21/2023

Definiert eine Bezeichnung, die in eine Massendatei hochgeladen und heruntergeladen werden kann.

Mit Bezeichnungen können Sie Kampagnen, Anzeigengruppen, Anzeigen und Schlüsselwörter in Gruppen organisieren, basierend auf dem, was für Sie wichtig ist. Anschließend können Sie Berichte für Ihre Bezeichnungen filtern und ausführen, um die Daten zu erhalten, die für Sie am aussagekräftigsten sind.

Sie können alle Label-Einträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von Labels 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 Bezeichnung hinzugefügt.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

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

uploadEntities.Add(bulkLabel);

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

Color
Client-ID
Beschreibung
Id
Label
Änderungszeit
Status

Farbe

Die Bezeichnungsfarbe als Hexadezimalcode.

Der Hexadezimalwert muss das Präfix "#" aufweisen. Sie können z. B. den Wert von #FFFFFF für ein weißes Etikett verwenden.

Die Farbe kann in der Microsoft Advertising-Webanwendung angezeigt werden. Ihre Anwendung kann die Farbe anzeigen oder den Hexadezimalwert verwenden, um eine Gruppe von Bezeichnungen zu kategorisieren.

Hinzufügen: Optional. Wenn Sie keine Farbe angeben, wird der Wert nach dem Zufallsprinzip für jede Bezeichnung zugewiesen.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Sie können den Farbcode aktualisieren, aber nicht entfernen.
Löschen: Schreibgeschützt

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

Beschreibung

Die Bezeichnungsbeschreibung.

Die Bezeichnungsbeschreibung kann zwischen 1 und 200 Zeichen lang sein.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner der Bezeichnung.

Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für die Bezeichnung kann dann im Feld Übergeordnete ID abhängiger Datensatztypen wie Kampagnenbezeichnung verwiesen werden. Dies wird empfohlen, wenn Sie neue Bezeichnungen und neue abhängige Datensätze in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Label

Der Bezeichnungsname.

Der Bezeichnungsname mit Beachtung der Groß-/Kleinschreibung kann zwischen 1 und 80 Zeichen lang sein und muss für alle Bezeichnungen im Konto eindeutig sein.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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: Schreibgeschützt
Löschen: Schreibgeschützt

Status

Die status der Bezeichnung.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Freigeben über