Freigeben über

Produktanzeigedatensatz – Massenvorgang

  • Artikel

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

Eine Produktanzeige wird nicht direkt für gelieferte Anzeigenkopien verwendet. Stattdessen generiert die Liefer-Engine Produktanzeigen aus den Produktdetails, die sie im Microsoft Merchant Center-Storekatalog des Kunden findet.

Sie können alle Product Ad-Einträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von ProductAds 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 Produktanzeige 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,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

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 BulkProductAd-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zu schreiben, um jedes Feld in der Massendatei zu analysieren.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkProductAd);

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

Anzeigengruppe

Der Name der Anzeigengruppe, die die Anzeige enthält.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Hinweis

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

Kampagne

Der Name der Kampagne, die die Anzeigengruppe und die Anzeige enthält.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
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: Wahlfrei
Aktualisieren: Wahlfrei
Löschen: Schreibgeschützt

Redaktioneller Einspruchsstatus

Bestimmt, ob Sie die von der redaktionellen Rezension gefundenen Probleme anfechten können.

Mögliche Werte werden in der folgenden Tabelle beschrieben.

Wert Beschreibung
Beschwerdefähig Die redaktionelle Ausgabe ist ansprechend.
Einspruch ausstehend Die Redaktionelle Ausgabe ist anfechtbar, und es wurde Berufung eingelegt.
NotAppealable Die redaktionelle Ausgabe ist nicht ansprechend.

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

Redaktioneller Ort

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

Hinzufügen: Schreibgeschützt
Aktualisieren: 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
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Redaktioneller Status

Die redaktionelle status der Anzeige.

Mögliche Werte werden in der folgenden Tabelle beschrieben.

Wert Beschreibung
Aktiv Die Anzeige hat die redaktionelle Überprüfung bestanden.
ActiveLimited Die Anzeige wurde in einem oder mehreren Märkten redaktionsintern überprüft, und ein oder mehrere Elemente der Anzeige werden in einem anderen Markt redaktionsintern überprüft. Zum Beispiel hat die Anzeige die redaktionelle Überprüfung für Kanada bestanden und steht im USA noch aus.
Verpönt Die Anzeige scheiterte bei der redaktionellen Überprüfung.
Inaktiv Mindestens ein Element der Anzeige wird gerade redaktionsreprokiert.

Hinzufügen: Schreibgeschützt
Aktualisieren: 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
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner der Anzeige.

Hinzufügen: Wahlfrei. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für die Anzeige kann dann im Feld Übergeordnete ID abhängiger Datensatztypen wie Produktanzeigenbezeichnung verwiesen werden. Dies wird empfohlen, wenn Sie neue Anzeigen 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

Ä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

Übergeordnete ID

Der vom System generierte Bezeichner der Anzeigengruppe, die die Anzeige enthält.

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 einer neuen Anzeigengruppe in derselben Massendatei neue Anzeigen hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Hinweis

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Anzeigengruppe 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
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Status

Die status der Anzeige.

Hinweis

Ab dem 3. Dezember 2024 wird der Löschvorgang in der Massen-API für Produktanzeigendatensätze nicht mehr unterstützt. Dies liegt daran, dass die Produktanzeigenentität vom System generiert wird.

Mögliche Werte sind Aktiv, Angehalten oder Gelöscht.

Hinzufügen: Wahlfrei. Der Standardwert ist Aktiv.
Aktualisieren: Wahlfrei. 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.