Freigeben über

Anzeigengruppen-Erweiterungsdatensatz – Massenvorgang

  • Artikel

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

Hinweis

Höherstufungserweiterungen sind für Kunden im Featurepiloten verfügbar (GetCustomerPilotFeatures gibt 720 zurück).

Sie können alle Ad Group Promotion Ad Extension-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von AdGroupPromotionAdExtensions 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 Werbeanzeigenerweiterung einer Anzeigengruppe zugeordnet, wenn gültige Id - und Übergeordnete ID-Werte angegeben werden.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Ad Group Promotion Ad Extension,Active,-11,-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 BulkAdGroupPromotionAdExtension-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 BulkAdGroupPromotionAdExtension
var bulkAdGroupPromotionAdExtension = new BulkAdGroupPromotionAdExtension
{
    // Map properties in the Bulk file to the 
    // AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
    AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
    {
        // 'Id' column header in the Bulk file
        AdExtensionId = promotionAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAdGroupPromotionAdExtension);

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 der Anzeigenerweiterung für anzeigende Gruppenaufstufung sind die folgenden Attributfelder im Massendateischema verfügbar.

Anzeigengruppe

Der Name der Anzeigengruppe, der diese Anzeigenerweiterung zugeordnet oder entfernt wird.

Hinzufügen: Schreibgeschützt und erforderlich
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.

Kampagne

Der Name der Kampagne, die die Anzeigengruppe enthält, der diese Anzeigenerweiterung zugeordnet 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.

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

Redaktioneller Ort

Die Komponente oder Eigenschaft der Anzeigenerweiterung, bei der die redaktionelle Überprüfung fehlgeschlagen ist.

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

Redaktioneller Grundcode

Ein Code, der die Ursache für den Fehler identifiziert. Eine Liste der möglichen Ursachencodes finden Sie unter Redaktionelle Ursachencodes.

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

Redaktioneller Status

Die redaktionelle status der Anzeigenerweiterung.

Mögliche Werte werden in der folgenden Tabelle beschrieben.

Wert Beschreibung
Aktiv Die Anzeigenerweiterung hat die redaktionelle Überprüfung bestanden.
ActiveLimited Die Anzeigenerweiterung hat in einem oder mehreren Märkten eine redaktionelle Überprüfung bestanden, und ein oder mehrere Elemente der Anzeigenerweiterung werden in einem anderen Markt redaktionellen Überprüfungen unterzogen. Beispielsweise hat die Anzeigenerweiterung die redaktionelle Überprüfung für Kanada bestanden und steht im USA noch aus.
Abgelehnt Die redaktionelle Überprüfung der Anzeigenerweiterung ist fehlgeschlagen.
Inaktiv Mindestens ein Element der Anzeigenerweiterung wird gerade redaktionsreediert überprüft.

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

Redaktionsbegriff

Der Begriff, der bei der redaktionellen Überprüfung nicht erfolgreich war.

Dieses Feld wird nicht festgelegt, wenn eine Kombination von Begriffen den Fehler verursacht hat oder wenn der Fehler auf einem Richtlinienverstoß basiert.

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

Id

Der Bezeichner der Anzeigenerweiterung, die der Anzeigengruppe zugeordnet oder daraus entfernt wird.

Dieses Massenfeld wird dem Id-Feld des Datensatzes "Werbeerweiterung " zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Bezeichner für die Anzeigenerweiterung angeben oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Datensatzes für Werbeanzeigenerweiterung entspricht. Dies wird empfohlen, wenn Sie neue Anzeigenerweiterungen und Zuordnungen in derselben Massendatei hinzufügen. 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, der diese Anzeigenerweiterung zugeordnet 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 Anzeigenerweiterungen einer neuen Anzeigengruppe in derselben Massendatei zuordnen. 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.

Herausgeberländer

Die Liste der Herausgeberländer oder -regionen, deren redaktionelle Richtlinien den angegebenen Begriff nicht zulassen.

In einer Massendatei wird die Liste der Herausgeberländer oder -regionen durch ein Semikolon (;).

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

Status

Stellt die Zuordnung status zwischen der Anzeigengruppe und der Anzeigenerweiterung dar.

Mögliche Werte sind Aktiv und Gelöscht. Wenn die Anzeigenerweiterung der Anzeigengruppe zugeordnet ist, ist der Wert dieses Felds Aktiv.

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