Textanzeigendatensatz – Massenvorgang
Definiert eine Textanzeige, die heruntergeladen und in eine Massendatei hochgeladen werden kann.
Wichtig
Ab April 2020 wird die Übermittlung von Standart-Textanzeigen (STA) nicht mehr unterstützt.
Standardtextanzeigen wurden zugunsten von erweiterten Textanzeigen (EXTAs) als veraltet gekennzeichnet. Die Unterstützung für das Hinzufügen und Aktualisieren von Standardtextanzeigen (STAs) endete am 31. Juli 2017. Jetzt können Werbetreibende abrufen und löschen, aber keine neuen STAs mehr hinzufügen oder vorhandene Standardtextanzeigen aktualisieren. Eine Ausnahme von der Regel besteht darin, dass Sie die STA-status z. B. von Aktiv auf Angehalten aktualisieren können. Andernfalls führt das Hinzufügen oder Aktualisieren von STAs zum CampaignServiceAdTypeInvalid-Fehler .
Sie können alle Textanzeigeneinträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von TextAds 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 Textanzeige hinzugefügt, wenn ein gültiger Wert für ü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,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,
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 BulkTextAd-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 BulkTextAd
var bulkTextAd = new BulkTextAd
{
// '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
// TextAd object of the Campaign Management service.
TextAd = new TextAd
{
// 'Ad Format Preference' column header in the Bulk file
AdFormatPreference = "All",
// 'Destination Url' column header in the Bulk file
DestinationUrl = null,
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Display Url' column header in the Bulk file
DisplayUrl = "contoso.com",
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkTextAd);
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 Textanzeigedatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
- Anzeigenformateinstellung
- Anzeigengruppe
- Kampagnen
- Client-ID
- Benutzerdefinierter Parameter
- Geräteeinstellung
- Url anzeigen
- Redaktioneller Einspruchsstatus
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Endgültige URL
- Id
- Mobile Final Url
- Änderungszeit
- Übergeordnete ID
- Herausgeberländer
- Status
- Text
- Title
- Vorlage für die Nachverfolgung
Anzeigenformateinstellung
Das Feld Anzeigenformateinstellung wird verwendet, um anzugeben, ob Die Anzeigenkopie den Benutzern als Such- oder Zielgruppenanzeige angezeigt werden soll. Suchanzeigen werden in der Regel als Handlungsaufforderung geschrieben, während Zielgruppenanzeigen eher informativ geschrieben werden sollten. Während Sie die Möglichkeit haben, Suchtextanzeigen als Zielgruppenanzeigen zu verwenden, können Sie eine Anzeige als bevorzugtes Format für Zielgruppenanzeigen festlegen, um deren Messaging für die native Übermittlung zu optimieren.
Wichtig
Sie müssen mindestens eine Textanzeige pro Anzeigengruppe definieren, die keine Zielgruppenanzeigen bevorzugt. Andernfalls ist die Anzeigenkopie aller Textanzeigen sowohl für Such- als auch für Zielgruppenanzeigen geeignet.
Mögliche Werte sind Zielgruppenanzeige und Alle. Wenn diese Option auf Alle festgelegt ist, ist die Anzeige sowohl für such- als auch für Zielgruppenanzeigenformate geeignet. Bei Festlegung auf Zielgruppenanzeige ist die Anzeige nur für das Zielgruppenanzeigenformat geeignet.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Anzeigengruppe
Der Name der Anzeigengruppe, die die Anzeige enthält.
Hinzufügen: Nicht unterstützt
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Hinweis
Zum 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: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Optional
Löschen: Schreibgeschützt
Benutzerdefinierter Parameter
Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.
In einer Massendatei ist die Liste der benutzerdefinierten Parameter wie folgt formatiert.
Formatieren Sie jedes benutzerdefinierte Parameterpaar als Key=Value, z. B. {_promoCode}=PROMO1.
Microsoft Advertising akzeptiert die ersten 8 benutzerdefinierten Schlüssel- und Wertpaare, die Sie einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jedes Schlüssel-Wert-Paar wird durch ein Semikolon und ein Leerzeichen ("; ") getrennt, z. B. {_promoCode}=PROMO1; {_season}=Sommer.
Ein Schlüssel darf kein Semikolon enthalten. Wenn ein Wert ein Semikolon enthält, muss er als "\;" mit Escapezeichen versehen werden. Wenn der Wert außerdem einen umgekehrten Schrägstrich enthält, muss er auch als "\" mit Escapezeichen versehen werden.
Der Schlüssel darf 16 UTF-8 Bytes nicht überschreiten, und der Wert darf 250 UTF-8 Bytes nicht überschreiten. Der Schlüssel ist erforderlich, und der Wert ist optional. Die maximale Größe des Schlüssels enthält keine geschweiften Klammern und Unterstriche, d. h. "{", "_" und "}".
Hinweis
Beim Massendienst muss der Schlüssel mit umgebenden geschweiften Klammern und einem führenden Unterstrich formatiert werden. Wenn der Schlüssel beispielsweise promoCode ist, muss er als {_promoCode} formatiert werden. Mit dem Kampagnenverwaltungsdienst können Sie die umgebenden Klammern und Unterstriche nicht angeben.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Geräteeinstellung
Dieses Feld bestimmt, ob Textanzeigen auf allen Geräten oder nur auf mobilen Geräten angezeigt werden sollen.
Mögliche Werte sind All und Mobile, die sich von den werten unterscheiden, die im Kampagnenverwaltungsdienst verwendet werden.
SixMonths
In der Massendownload- und Upload-Ergebnisdatei ist dieses Feld nie leer. Wenn Sie keine Geräteeinstellung angegeben haben, wird der Standardwert Alle zurückgegeben.
Wichtig
Sie müssen mindestens eine Textanzeige pro Anzeigengruppe definieren, die nicht für mobilgeräte bevorzugt ist. Andernfalls ist die Anzeigenkopie aller Textanzeigen für alle Geräte geeignet.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Url anzeigen
Die URL, die in der Anzeige angezeigt werden soll.
Das Unterverzeichnis der Anzeige-URL kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Der URL-Hostname darf jedoch keinen dynamischen Text enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.
Die maximale Eingabelänge der URL beträgt 200 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann jedoch nicht angezeigt werden, wenn die URL nach der dynamischen Textersetzung 35 Zeichen überschreitet.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
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.
Hinzufügen: Nicht unterstü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: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Status
Die redaktionelle status der Anzeige.
Mögliche Werte werden in der folgenden Tabelle beschrieben.
Hinzufügen: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Endgültige URL
Die URL der Landing Page.
Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
Sie können bis zu 10 Elemente für endgültige URLs und endgültige mobile URLs angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
Jede URL ist durch ein Semikolon und Leerzeichen ("; ") getrennt.
Die Verwendung von '{' und '}' ist nur zum Abgrenzen von Tags zulässig, z. B. "{lpurl}".
Jede URL muss eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
Wenn Sie Final Mobile URLs angeben, müssen Sie auch Final URL angeben.
Beachten Sie außerdem, dass, wenn die Felder Nachverfolgungsvorlage oder Benutzerdefinierter Parameter festgelegt sind, mindestens eine endgültige URL erforderlich ist.
Hinweis
Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine endgültige URL angibt.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner der Anzeige.
Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner, der für die Anzeige festgelegt wurde, kann dann im Feld Übergeordnete ID von abhängigen Datensatztypen wie Textanzeigenbeschriftung 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
Mobile Final Url
Die URL der mobilen Landing Page.
Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
Sie können bis zu 10 Elemente für endgültige URLs und endgültige mobile URLs angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
Jede URL ist durch ein Semikolon und Leerzeichen ("; ") getrennt.
Die Verwendung von '{' und '}' ist nur zum Abgrenzen von Tags zulässig, z. B. "{lpurl}".
Jede URL muss eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
Wenn Sie Final Mobile URLs angeben, müssen Sie auch Final URL angeben.
Hinweis
Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine mobile endgültige URL angibt.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
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: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Hinweis
Zum 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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Status
Die status der Anzeige.
Mögliche Werte sind Aktiv, Angehalten oder Gelöscht.
Hinzufügen: Nicht unterstützt
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.
Text
Die Anzeigenkopie.
Der Text muss mindestens ein Wort enthalten und kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.
Die maximale Eingabelänge der Kopie beträgt 300 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 80 Zeichen nach der dynamischen Textersetzung überschreitet. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, die maximale Eingabelänge der Kopie 150 Zeichen beträgt und der Text nach der Ersetzung auf 40 Zeichen beschränkt ist.
Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Position
Der Titel der Anzeige.
Der Titel muss mindestens ein Wort enthalten. Die Kopie und der Titel der Anzeige müssen zusammen mindestens drei Wörter enthalten.
Der Titel kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.
Die maximale Eingabelänge des Titels beträgt 80 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 25 Zeichen nach der dynamischen Textersetzung überschreitet. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, der Titel nach der Ersetzung auf 15 Zeichen beschränkt ist.
Der Titel darf das Zeilenumbruchzeichen (\n) nicht enthalten.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt
Vorlage für die Nachverfolgung
Die Nachverfolgungsvorlage, die als Standard für die mit FinalUrls angegebene URL verwendet werden soll.
Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, setzen diejenigen außer Kraft, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte.
Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}.
Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage z. B. lautet
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}und weder {_season} noch {_promocode} in der Kampagne, der Anzeigengruppe, dem Kriterium, Schlüsselwort (keyword) oder der Anzeigenebene definiert sind, ist die URL der Landing Page identisch.
Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt
Löschen: Schreibgeschützt