Anzeigengruppenbezeichnungsdatensatz – Massen

Definiert einen Zuordnungsdatensatz zwischen einer Anzeigengruppe und einer Bezeichnung , die in eine Massendatei hochgeladen und heruntergeladen werden kann. Verwenden Sie zum Hochladen oder Herunterladen der Anzeigengruppe oder Bezeichnung den Eintrag Anzeigengruppe oder Bezeichnung .

Sie können alle Datensätze der Anzeigengruppenbezeichnung im Konto herunterladen, indem Sie den DownloadEntity-Wert von AdGroupLabels 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 Bezeichnung auf eine Anzeigengruppe angewendet, wenn gültige Id - und Übergeordnete ID-Werte angegeben werden.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Ad Group Label,,-22,-1111,,,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 BulkAdGroupLabel-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 BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkAdGroupLabel);

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

• Anzeigengruppe
• Kampagnen
• Client-ID
• Id
• Änderungszeit
• Übergeordnete ID
• Status

Hinweis

Die Felder Anzeigengruppe und Kampagne werden in der Downloaddatei nicht zurückgegeben.

Anzeigengruppe

Der Name der Anzeigengruppe, in der diese Bezeichnung angewendet oder entfernt wird.

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

Hinweis

Zum Hinzufügen und Löschen müssen Sie entweder die übergeordnete ID oder beide Felder Anzeigengruppe und Kampagne angeben.

Kampagne

Der Name der Kampagne, die die Anzeigengruppe enthält, in der diese Bezeichnung angewendet oder entfernt wird.

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

Hinweis

Zum Hinzufügen und Löschen müssen Sie entweder die übergeordnete ID oder beide Felder Anzeigengruppe und Kampagne angeben. Für den Massendownload werden die Felder Anzeigengruppe und Kampagne nicht zurückgegeben.

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 der Bezeichnung, die angewendet oder aus der Anzeigengruppe entfernt wird.

Dieses Massenfeld wird dem Id-Feld des Label-Datensatzes zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Bezeichnungsbezeichner oder einen negativen Bezeichner angeben, der dem Id-Feld des übergeordneten Bezeichnungsdatensatzes entspricht. Dies wird empfohlen, wenn Sie neue Bezeichnungen auf Anzeigengruppen in derselben Massendatei anwenden. 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 Anzeigengruppe, in der diese Bezeichnung angewendet oder entfernt wird.

Dieses Massenfeld wird dem Feld Id des Anzeigengruppendatensatzes zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Anzeigengruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Anzeigengruppendatensatzes entspricht. Dies wird empfohlen, wenn Sie Bezeichnungen auf eine neue Anzeigengruppe in derselben Massendatei anwenden. 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 beide Felder Anzeigengruppe und Kampagne angeben. Für den Massendownload werden die Felder Anzeigengruppe und Kampagne nicht zurückgegeben.

Status

Stellt die angewendete status zwischen der Anzeigengruppe und der Bezeichnung dar.

Mögliche Werte sind Aktiv und Gelöscht. Wenn die Bezeichnung auf die Anzeigengruppe angewendet wird, ist der Wert dieses Felds Aktiv.

Hinzufügen: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.