Massendateischema
Das Massenschema definiert den Inhalt der Datei zum Herunterladen oder Hochladen mit der Massen-API. Sowohl beim Herunterladen als auch beim Hochladen unterstützt der Massendienst die Dateitypen und die entsprechenden Schemas im DownloadEntity-Wertsatz .
Weitere Informationen zur Verwendung des Massendiensts zum Verwalten Ihrer Kampagnen finden Sie unter Massendownload und -upload. Weitere Informationen zum Verstehen des Inhalts der Datendatei finden Sie in den folgenden Abschnitten.
Dateischema
Sie können entweder eine Registerkarte oder einen durch Trennzeichen getrennten Satz von Datensätzen (Zeilen) und Feldern (Spalten) herunterladen. Die erste Spaltenüberschrift heißt Type. Die restlichen Spaltennamen werden Eigenschaften innerhalb oder zugeordnet, die dem entsprechenden Datensatztyp zugeordnet sind.
Wichtig
Neue Datensatztypen (Zeilen) und Felder (Spalten) können jederzeit hinzugefügt werden, und Sie sollten sich nicht auf die Datensatz- oder Feldreihenfolge in der Massendownload- oder Massenupload-Ergebnisdatei verlassen. Ebenso sollten Sie, sofern in der Referenzdokumentation nicht anders angegeben, nicht von einem festen Satz von Werten abhängig sein, die in jedem Feld zurückgegeben werden.
Ebenso können Sie während des Uploads die Felder in beliebiger Reihenfolge übermitteln. Die Reihenfolge des Uploaddatensatzes ist wichtig, wenn neue Entitäten erstellt werden, wie unten unter Typhierarchie beschrieben.
Formatversionen
Die Massenformatversion ist von der Version der Bing Ads-API getrennt. Formatversion ermöglicht einen flexiblen Upgradepfad, um die neuesten unterstützten Features zu übernehmen, ohne Ihre Anwendung zu unterbrechen. Als bewährte Methode sollten Sie immer auf die neueste Formatversion aktualisieren. Derzeit wird nur die Formatversion 6.0 unterstützt.
Um die Dateiformatversion mithilfe des Massendownloads anzugeben, legen Sie FormatVersion in der Anforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds auf 6.0 fest.
Um die Version mithilfe des Massenuploads anzugeben, legen Sie das Feld Name des Datensatzes Version format auf 6.0 fest.
Datensatztypen
Datensätze, die zum Hochladen und Herunterladen mit Formatversion 6.0 verfügbar sind, sind in der folgenden Tabelle aufgeführt.
Wichtig
Neue Datensatztypen (Zeilen) und Felder (Spalten) können jederzeit hinzugefügt werden, und Sie sollten sich nicht auf die Datensatz- oder Feldreihenfolge in der Massendownload- oder Massenupload-Ergebnisdatei verlassen.
Typhierarchie
Die Downloaddatei enthält immer einen Datensatz für die Datensatztypen Version formatieren und Konto . Für den Upload ist die Formatversion erforderlich und muss allen anderen Datensatztypen in der Massendatei vorangestellt werden.
Wenn eine übergeordnete Entität in derselben Datei erstellt wird, sollte sie allen abhängigen untergeordneten Datensätzen in der Massendatei vorangehen. Wie im folgenden Diagramm gezeigt, muss beispielsweise beim Zuordnen einer Sitelink-Anzeigenerweiterung zu einer Kampagne der Datensatz "Campaign Sitelink Ad Extension " in die Datei nach den Datensätzen Campaign und Sitelink Ad Extension eingeschlossen werden. Die Felder ID und Übergeordnete ID des Datensatzes "Kampagnen-Sitelink-Anzeigenerweiterung " sollten auf den Bezeichner der Sitelink-Anzeigenerweiterung bzw. des Kampagnendatensatzes festgelegt werden. Wenn die Sitelink-Anzeigenerweiterungs - und Kampagnendatensätze ebenfalls neu sind und noch keine Microsoft Advertising-Bezeichner zugewiesen sind, sollten Sie Verweisschlüssel verwenden.
Es ist nicht erforderlich, den Datensatz für eine übergeordnete Entität einzuschließen, der bereits ein gültiger Microsoft Advertising-Bezeichner zugewiesen wurde.
Partieller Erfolg wird beim Hinzufügen, Aktualisieren und Löschen von Massendateidatensätzen unterstützt. Wenn Sie beispielsweise versuchen, drei Kampagnen hinzuzufügen und nur zwei in der Datei richtig angegeben sind, werden zwei hinzugefügt. Die Ergebnisdatei enthält Details zu erfolgreichen Kampagnendatensätzen , einem versuchten Kampagnendatensatz und einem Kampagnenfehlerdatensatz .
Wenn der neue Kampagnenbezeichner noch nicht bekannt ist, z. B. beim Hinzufügen einer Kampagne, Anzeigengruppe, Textanzeige und Schlüsselwort (keyword) in derselben Datei, geben Sie den Kampagnennamen als logischen Verweisschlüssel für alle untergeordneten Datensätze an. Es ist nicht erforderlich, im Upload ein vorhandenes übergeordnetes Element anzugeben.
Teilupdates werden für Massendatensätze unterstützt, einschließlich negativer Schlüsselwörter, negativer Websites und Zielkriterien. Beispielsweise können Sie das Gebot eines einzelnen Standortkriteriums aktualisieren, und Sie müssen nicht den gesamten Satz von Zielkriterien für die Kampagne oder Anzeigengruppe herunterladen und hochladen.
Beim Aktualisieren eines Datensatzes ist das Id-Feld für den aktualisierten Datensatz erforderlich. Die übergeordnete ID oder die Verweisschlüssel für den übergeordneten Datensatz sind ebenfalls erforderlich.
Beim Aktualisieren des Kampagnen- oder Anzeigengruppennamens ist es optional, den neuen Namen für die untergeordneten Datensätze anzugeben, wenn die richtige übergeordnete ID angegeben wird.
Wenn Sie eine Gruppe von Datensätzen durch einen anderen Satz ersetzen, müssen Sie die gelöschten Datensätze vor dem neuen Satz angeben. Um z. B. das gesamte vorhandene kampagnen negative Schlüsselwort für eine bestimmte Kampagne zu ersetzen, fügen Sie zunächst ein kampagnen negatives Schlüsselwort ein, wobei der Status auf Gelöscht und die übergeordnete ID auf die Kampagnen-ID festgelegt ist. Wenn Sie keine ID angeben, d. h. versuchen Sie nicht, ein bestimmtes camapaign negatives Schlüsselwort (keyword) zu löschen, werden dadurch effektiv alle Kampagnen negative Schlüsselwörter für diese Kampagne gelöscht. Unterhalb des Datensatzes "Alle löschen" können Sie einen oder mehrere neue Kampagnen negative Schlüsselworteinträge mit allen erforderlichen Eigenschaften für den Upload-Add-Vorgang einschließen.
Wenn Sie einen vorhandenen Datensatz durch einen neuen Datensatz mit den gleichen eindeutigen Eigenschaften ersetzen, müssen Sie den gelöschten Datensatz vor dem neuen Datensatz angeben. Um beispielsweise ein vorhandenes Anzeigengruppen-Anzeigenziel für dynamische Suchanzeigen für eine bestimmte Anzeigengruppe zu ersetzen, schließen Sie zunächst ein Anzeigengruppen-Anzeigenziel für dynamische Suche ein, dessen Status auf Gelöscht festgelegt ist, die ID auf die vorhandene ID des dynamischen Anzeigenziels (Webseitenkriterium) und die übergeordnete ID auf die Anzeigengruppen-ID festgelegt ist. Unterhalb des gelöschten Datensatzes können Sie einen neuen Ad Group Dynamic Search Ad Target-Datensatz (vermutlich mit neuen Webseitenbedingungen) einfügen.
Hinweis
In den meisten Fällen können Sie den vorhandenen Datensatz aktualisieren, anstatt separate Lösch- und Datensätze zu übermitteln. Sie können z. B. das Feld "Gebotsanpassung" eines vorhandenen Kampagnen-Geschlechtskriteriums aktualisieren.
Beim Löschen eines Datensatzes ist das Id-Feld erforderlich. Ein Verweis auf die übergeordnete Entität, unabhängig davon, ob es sich bei dem Wert um einen von Microsoft Advertising zugewiesenen Systembezeichner oder einen Verweisschlüssel für den übergeordneten Datensatz handelt, ist ebenfalls erforderlich. Wenn Sie beispielsweise eine Anzeigengruppe löschen, sollte entweder das Feld "Übergeordnete ID " des Anzeigengruppendatensatzes mit dem Feld "Id" im Kampagnendatensatz übereinstimmen, oder das Feld "Kampagne " des Anzeigengruppendatensatzes sollte mit dem Feld "Kampagne " im Kampagnendatensatz übereinstimmen. Wenn beides angegeben wird, wird das Feld Übergeordnete ID des Anzeigengruppendatensatzes (Verweisschlüssel) ignoriert.
Mit wenigen Ausnahmen enthält die Ergebnisdatei nur die Spalten, die Sie hochgeladen haben. Wenn Sie z. B. ein neues negatives Ad Group-Schlüsselwort ohne die Spaltenüberschrift Id hochladen, enthält die Ergebnisdatei nicht den zugewiesenen Bezeichner für die neue negative Schlüsselwort (keyword). Die Massendatei sollte die Spalte ID enthalten. Sie sollten jedoch die ID für jedes neue negative Ad Group-Schlüsselwort leer lassen. Die Ausnahmen von dieser Regel sind Kampagnen, Anzeigengruppen, Anzeigen und Schlüsselwörter. In diesem Fall enthält die Ergebnisdatei alle Spalten, unabhängig von den hochgeladenen Spalten.
Aktualisieren mit delete_value
Um eine vorhandene Einstellung zu entfernen, sollten Sie keine leere Zeichenfolge ("") in die Massendatei schreiben, da solche Zeichenfolgen vom Massendienst ignoriert werden. Verwenden Sie die reservierte Zeichenfolge "delete_value", um den Wert eines optionalen Felds zu löschen oder zurückzusetzen.
- Wenn Sie die reservierte Zeichenfolge "delete_value" in einem optionalen Feld verwenden, wird die vorherige Einstellung gelöscht. Wenn Sie beispielsweise das Feld Benutzerdefinierter Parameter des Anzeigengruppendatensatzes auf "delete_value" festlegen, werden alle vorherigen benutzerdefinierten Parameter aus der Anzeigengruppe gelöscht. Wenn Sie das Feld Nachverfolgungsvorlage des Anzeigengruppendatensatzes auf "delete_value" festlegen, wird die vorherige Nachverfolgungsvorlage aus der Anzeigengruppe gelöscht.
- Die Bing Ads SDKs für .NET, Java und Python schreiben ggf. automatisch "delete_value". Weitere Informationen finden Sie unter Massen Service Manager – Aktualisieren mit delete_value.
Wenn Sie "delete_value" in Pflichtfeldern verwenden, beachten Sie Folgendes.
- Wenn Sie die reservierte Zeichenfolge "delete_value" anstelle eines erforderlichen primitiven Werts verwenden, wird sie ignoriert. Obwohl das Feld nicht aktualisiert wurde, wird die Zeichenfolge "delete_value" über die Upload-Ergebnisdatei übergeben. Wenn Sie beispielsweise das Feld Anzeigengruppe (Name der Anzeigengruppe) des Anzeigengruppeneintrags auf "delete_value" festlegen, wird der Name der Anzeigengruppe nicht aktualisiert.
- Wenn Sie die reservierte Zeichenfolge "delete_value" anstelle eines erforderlichen Wertsatzes verwenden, wird das Feld auf den Standardwert aktualisiert, und die Ergebnisdatei spiegelt diese Änderung wider. Wenn Sie z. B. das Feld Netzwerkverteilung des Anzeigengruppeneintrags auf "delete_value" festlegen, wird die Netzwerkverteilung der Anzeigengruppe auf OwnedAndOperatedAndSyndicatedSearch festgelegt, und die Uploadergebnisdatei würde dasselbe widerspiegeln.
Referenzschlüssel
Wenn Sie auf einen vorherigen Datensatz in der Massendatei verweisen, dem noch kein Microsoft Advertising-Bezeichner zugewiesen ist, können Sie je nach Datensatztyp entweder einen logischen Oder einen negativen Verweisschlüssel verwenden.
Hinweis
Wenn die übergeordnete Entität in derselben Datei erstellt wird, sollte sie allen abhängigen untergeordneten Datensätzen in der Massendatei vorangehen.
Negativer Verweisschlüssel
Wenn Sie auf einen vorherigen Datensatz in der Massendatei verweisen, dem noch kein Microsoft Advertising-Bezeichner zugewiesen ist, können Sie das Feld id der Erweiterung auf eine negative Zahl Ihrer Wahl festlegen. Diese benutzerdefinierte ID wird als negativer Verweisschlüssel bezeichnet. Anschließend können Sie den negativen Verweisschlüssel im Id-Feld eines abhängigen Datensatzes verwenden.
Das erste Beispiel zeigt, wie Sie eine Anzeigengruppe für eine neue Kampagne erstellen. Legen Sie das Feld Übergeordnete ID im Datensatz der Anzeigengruppe auf den negativen Referenzschlüssel der Kampagne (-111) fest. Wenn Sie in derselben Datei zusätzliche Datensätze hinzufügen, die die Anzeigengruppe als übergeordnetes Element aufweisen sollen (z. B. Schlüsselwort - oder Anzeigengruppenbeschriftungserweiterung), sollten Sie auch das Feld Id in der Anzeigengruppe auf einen negativen Wert festlegen, z. B. -1111 , auf den aus den untergeordneten Datensätzen verwiesen werden kann.
| Typ | Id | Übergeordnete ID |
|---|---|---|
| Kampagne | -111 | |
| Anzeigengruppe | -1111 | -111 |
Das zweite Beispiel zeigt, wie Sie eine Kampagnen-Callout-Anzeigenerweiterung für eine neue Kampagne und eine neue Callout-Anzeigenerweiterung erstellen. Das Beispiel zeigt auch, wie Sie eine Anzeigengruppen-Beschriftungs-Anzeigenerweiterung für eine neue Anzeigengruppe und eine weitere neue Beschriftungsanzeigenerweiterung erstellen.
- Legen Sie das Feld Übergeordnete ID im Datensatz Kampagnenbeschriftungsanzeigenerweiterung auf den negativen Referenzschlüssel der Kampagne (-111) und das Feld ID im Datensatz Kampagnenbeschriftungs-Anzeigenerweiterung auf den negativen Referenzschlüssel der Legendenanzeigenerweiterung (-11) fest.
- Legen Sie das Feld "Übergeordnete ID " im Datensatz " Anzeigengruppenbeschriftungs-Erweiterung " auf den negativen Referenzschlüssel der Anzeigengruppe (-1111) und das Feld "Id" im Datensatz der Anzeigengruppenbeschriftungs-Anzeigenerweiterung auf den negativen Referenzschlüssel der Legendenanzeigenerweiterung (-12) fest.
| Typ | Id | Übergeordnete ID |
|---|---|---|
| Erweiterung für Beschriftungsanzeigen | -11 | |
| Erweiterung für Beschriftungsanzeigen | -12 | |
| Kampagne | -111 | |
| Anzeigengruppe | -1111 | -111 |
| Kampagnen-Popup-Anzeigenerweiterung | -11 | -111 |
| Anzeigengruppen-Beschriftungserweiterung | -12 | -1111 |
Logischer Verweisschlüssel
Wenn Sie auf einen neuen Kampagnen- oder Anzeigengruppendatensatz verweisen, können Sie den Kampagnen- und Anzeigengruppennamen verwenden, anstatt das Feld Übergeordnete ID im untergeordneten Datensatz auf einen negativen Verweisschlüssel festzulegen. Wenn Sie beispielsweise einer neuen Kampagne eine neue Anzeigengruppe und der neuen Anzeigengruppe eine neue Schlüsselwort (keyword) hinzufügen möchten, legen Sie die Felder Kampagne und Anzeigengruppe in den untergeordneten Datensätzen fest, wie im folgenden Beispiel gezeigt.
| Typ | Kampagne | Anzeigengruppe |
|---|---|---|
| Kampagne | Damen schuhe | |
| Anzeigengruppe | Damen schuhe | Roter Schuhverkauf für Damen |
Clientbezeichner
Clientbezeichner können verwendet werden, um Eingabedatensätze in der Massenuploaddatei ausgabedatensätzen in der Ergebnisdatei zuzuordnen. Wenn Sie beispielsweise neue Datensätze hinzufügen, können Sie das Feld Client-ID auf einen Zeichenfolgenwert Ihrer Wahl festlegen. Das Microsoft Advertising-System nimmt keine Änderungen an Ihren Clientbezeichnern vor und übergibt sie an die Ergebnisdatei für den entsprechenden Datensatz.
Fehler
Die Massendownloaddatei oder die Massenupload-Ergebnisdatei kann Datensätze enthalten, in denen das entsprechende Feld Typ das Suffix Error enthält. Beispielsweise stellt ein Produktanzeigefehler-Datensatztyp einen Produktanzeigefehler dar. Die Spalten Fehler und Fehlernummer enthalten Details zum Fehler.
Hinweis
Die Uploadergebnisdatei kann mehrere Fehlerdatensätze enthalten, die einem hochgeladenen Datensatz entsprechen.
Fehler im Zusammenhang mit neuen Features, z. B. Endgültige URLs, enthalten zusätzliche Details dazu, wo der Fehler in der Spalte Feldpfad aufgetreten ist. Jeder Feldpfadname entspricht einem Element eines der Datenobjekte des Kampagnenverwaltungsdiensts . Wenn das Feld "Nachverfolgungsvorlage " eines Kampagnendatensatzes beispielsweise nicht mit http:// oder https://, {lpurl} oder {unescapedlpurl} beginnt, lautet der Wert dieses Feldpfadwerts TrackingTemplate. TrackingUrlTemplate ist ein Element des Campaign-Datenobjekts, das mit dem Kampagnenverwaltungsdienst verfügbar ist.
| Typ | Vorlage für die Nachverfolgung | Fehler | Fehlernummer | Feldpfad |
|---|---|---|---|---|
| Kampagnenfehler | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | InvalidUrlScheme | 4600 | TrackingTemplate |
| Kampagnenfehler | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | CampaignServiceInvalidUrl | 2611 | TrackingTemplate |
Wichtig
Der Wert feldpfad kann geändert werden, sodass Sie keine Abhängigkeit vom aktuellen Zeichenfolgenformat annehmen sollten. Der Feldpfad wird nicht für alle Fehler unterstützt. Sie wird für die Felder "Mobile Final URL", "Final URL", "Tracking Template" und " Custom Parameter " der entsprechenden Datensätze "Kampagne", "Anzeigengruppe", " Erweiterte Textanzeige", "Produktanzeige", "Produktpartition", " Schlüsselwort" und "Sitelink-Anzeigenerweiterung " unterstützt. Es wird auch für Fehler im Zusammenhang mit allen Feldern der Einträge "Anzeigenerweiterung für Legende " und "Anzeigenerweiterung überprüfen " unterstützt.
Wenn das Problem mit einem redaktionellen Fehler zusammenhängt, enthalten die Spalten Editorial Location, Editorial Term, Editorial Reason Code und Publisher Countries möglicherweise weitere Informationen zum Fehler.