Erweiterungsdatensatz für Werbeanzeigen – Massen
Definiert eine Werbeerweiterung, die heruntergeladen und in eine Massendatei hochgeladen werden kann.
Hinweis
Promotion-Erweiterungen sind für Kunden in AU, CA, DE, FR, USA und Uk verfügbar.
Sie können eine Werbeanzeigenerweiterung dem Konto oder Kampagnen und Anzeigengruppen im Konto zuordnen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann bis zu 20 Werbeanzeigenerweiterungen zugeordnet werden. Verwenden Sie die Einträge Account Promotion Ad Extension, Ad Group Promotion Ad Extension und Campaign Promotion Ad Extension , um Zuordnungen für Werbeanzeigenerweiterungen zu verwalten.
Sie können alle Einträge für Werbeanzeigenerweiterungen im Konto herunterladen, indem Sie den DownloadEntity-Wertvon PromotionAdExtensions 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 der freigegebenen Bibliothek des Kontos eine neue Werbeanzeigeerweiterung hinzugefügt.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD
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 BulkPromotionAdExtension-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 BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// PromotionAdExtension object of the Campaign Management service.
PromotionAdExtension = new PromotionAdExtension
{
// 'Id' column header in the Bulk file
Id = promotionAdExtensionIdKey,
// 'Currency Code' column header in the Bulk file
CurrencyCode = "USD",
// 'Discount Modifier' column header in the Bulk file
DiscountModifier = PromotionDiscountModifier.None,
// 'Language' column header in the Bulk file
Language = "English",
// 'Money Amount Off' column header in the Bulk file
MoneyAmountOff = null,
// 'Orders Over Amount' column header in the Bulk file
OrdersOverAmount = null,
// 'Percent Off' column header in the Bulk file
PercentOff = 20000000,
// 'Promotion Code' column header in the Bulk file
PromotionCode = "SAVE20",
// 'Promotion Target' column header in the Bulk file
PromotionItem = "shoes",
// 'Occasion' column header in the Bulk file
PromotionOccasion = PromotionOccasion.WomensDay,
// 'Promotion End' column header in the Bulk file
PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Promotion Start' column header in the Bulk file
PromotionStartDate = null,
// '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"
},
// '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"
},
// '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"
},
}
},
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkPromotionAdExtension);
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 Erweiterungsdatensatz für Werbung sind die folgenden Attributfelder im Massendateischema verfügbar.
- Anzeigenzeitplan
- Client-ID
- Währungscode
- Benutzerdefinierter Parameter
- Rabattmodifizierer
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Enddatum
- Endgültige URL
- Endgültiges URL-Suffix
- Id
- Language
- Mobile Final Url
- Änderungszeit
- Money Amount Off
- Anlass
- Orders Over Amount
- Übergeordnete ID
- Herausgeberländer
- Höherstufungscode
- Promotion-Ende
- Höherstufung starten
- Höherstufungsziel
- Startdatum
- Status
- Vorlage für die Nachverfolgung
- Verwenden der Searcher-Zeitzone
- Version
Anzeigenzeitplan
Die Liste der Tages- und Zeitbereiche, in denen die Anzeigenerweiterung mit Ihren Anzeigen angezeigt werden soll. Jeder Tag und Zeitbereich umfasst den geplanten Wochentag, die Start-/Endstunde und die Start-/Endminute. Jeder Tag und Zeitbereich wird durch linke und rechte Klammern eingeschlossen und von anderen Tages- und Zeitbereichen durch ein Semikolon (;) Trennzeichen) getrennt. Innerhalb jedes Tages und Zeitbereichs ist das Format Day[StartHour:StartMinue-EndHour:EndMinute].
Die möglichen Werte von StartHour reichen von 00 bis 23, wobei 00 entspricht 12:00 Uhr und 12 :00 Uhr.
Die möglichen Werte von EndHour reichen von 00 bis 24, wobei 00 entspricht 12:00 Uhr und 12 :00 Uhr.
Die möglichen Werte von StartMinute und EndMinute liegen zwischen 00 und 60.
Im folgenden Beispiel werden Tages- und Zeitbereiche an Wochentagen von 9:00 bis 21:00 Uhr veranschaulicht: (Montag[09:00-21:00]);( Dienstag[09:00-21:00]); (Mittwoch[09:00-21:00]); (Donnerstag[09:00-21:00]); (Freitag[09:00-21:00])
Hinzufügen: Optional. Wenn Sie dieses Feld nicht festlegen, kann die Anzeigenerweiterung jederzeit während des Start - und Enddatums des Kalenders planen.
Aktualisieren: Optional. Die einzelnen Tages- und Zeitbereiche können nicht aktualisiert werden. Sie können die Tages- und Zeitbereiche effektiv aktualisieren, indem Sie einen neuen Satz senden, der den vorherigen Satz ersetzen soll. Die Felder Anzeigenzeitplan, Enddatum, Startdatum und Zeitzone der Suche verwenden hängen voneinander ab und werden gemeinsam aktualisiert. Wenn Sie alle diese Felder während des Updates leer lassen, wird keines von ihnen aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für alle diese Felder entfernt oder ersetzt. Um alle vorherigen Zeitplaneinstellungen zu entfernen, legen Sie jedes dieser Felder auf delete_value fest.
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: Optional
Aktualisieren: Optional
Löschen: Schreibgeschützt
Währungscode
Der Währungscode für den Aktionspreis oder -rabatt.
Dieses Feld gilt nur, wenn Sie "Money Amount Off" oder "Orders Over Amount" (Bestellungen über Betrag) festlegen.
Die unterstützten Währungscodes sind ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD und VEF.
Hinzufügen: Erforderlich, wenn "Money Amount Off" oder "Orders Over Amount " festgelegt sind.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie prozentual deaktiviert oder Höherstufungscode festlegen, ist diese Einstellung nicht mehr anwendbar und wird gelöscht.
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 drei benutzerdefinierten Parameterschlüssel- und Wertpaare, die Sie einschließen, und alle zusätzlichen benutzerdefinierten Parameter werden ignoriert. Für Kunden im Pilotversuch "Limiterhöhung für benutzerdefinierte Parameter" in Phase 3 (GetCustomerPilotFeatures gibt 635 zurück) akzeptiert Microsoft Advertising die ersten 8 benutzerdefinierten Parameterschlüssel- und Wertpaare, die Sie einschließen. 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 200 UTF-8 Bytes nicht überschreiten. Für Kunden im Pilotprogramm für benutzerdefinierte Parameter zur Erhöhung des Grenzwerts in Phase 3 (GetCustomerPilotFeatures gibt 635 zurück) erhöht sich der Wertgrenzwert auf 250 UTF-8 Bytes. 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: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie dieses Feld auf delete_value fest. Die delete_value Schlüsselwort (keyword) entfernt die vorherige Einstellung. Um eine Teilmenge von benutzerdefinierten Parametern zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie beibehalten möchten, und lassen Sie alle parameter aus, die Sie nicht beibehalten möchten. Der neue Satz von benutzerdefinierten Parametern ersetzt alle vorherigen benutzerdefinierten Parametersätze.
Löschen: Schreibgeschützt
Rabattmodifizierer
Der Aktionsrabattmodifizierer.
Die möglichen Werte für dieses Feld sind None und UpTo.
- Keine: Der Aktionsrabatt wird nicht geändert.
- UpTo: Der Aktionsrabatt wird mit dem Zeichenfolgenpräfix "Up to" geändert. Wenn der Rabatt für unveränderte Werbeaktionen beispielsweise "20 USD für Schuhe" lautet, lautet die geänderte Aktion "Bis zu 20 USD off shoes".
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert Keine festgelegt.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Redaktioneller Ort
Die Komponente oder Eigenschaft der Anzeigenerweiterung, 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 Anzeigenerweiterung.
Mögliche Werte werden in der folgenden Tabelle beschrieben.
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
Enddatum
Die als MM/TT/JJJJ formatierte Zeichenfolge für das geplante Enddatum der Anzeigenerweiterung.
Das Enddatum ist inklusive. Wenn Sie dieses Feld beispielsweise auf 31.12.2020 festlegen, werden die Anzeigenerweiterungen am 31.12.2020 um 23:59 Uhr nicht mehr angezeigt.
Hinzufügen: Optional. Wenn Sie kein Enddatum angeben, wird die Anzeigenerweiterung weiterhin übermittelt, es sei denn, Sie halten die zugehörigen Kampagnen, Anzeigengruppen oder Anzeigen an.
Aktualisieren: Optional. Das Enddatum kann verkürzt oder verlängert werden, solange das Startdatum entweder NULL ist oder vor dem neuen Enddatum liegt. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, entfernen Sie effektiv das Enddatum. Die Felder Anzeigenzeitplan, Enddatum, Startdatum und Zeitzone der Suche verwenden hängen voneinander ab und werden gemeinsam aktualisiert. Wenn Sie alle diese Felder während des Updates leer lassen, wird keines von ihnen aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für alle diese Felder entfernt oder ersetzt. Um alle vorherigen Zeitplaneinstellungen zu entfernen, legen Sie jedes dieser Felder auf delete_value fest.
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 Listenelemente für die endgültige url und die mobile endgültige URL angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10 Listenelemente für potenzielle Vorwärtskompatibilität.
- Jede URL ist durch ein Semikolon und Leerzeichen ("; ") getrennt.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
- Wenn Sie Mobile Final URL angeben, müssen Sie auch Final URL angeben.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Endgültiges URL-Suffix
Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.
Hinweis
Dieses Feature ist nur für Kunden im Pilotversuch "End-URL-Suffix Phase 3" verfügbar (GetCustomerPilotFeatures gibt 636 zurück). Wenn Sie sich nicht im Pilotversuch befinden, wird diese Eigenschaft ignoriert, und es wird kein Fehler zurückgegeben.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner der Anzeigenerweiterung.
Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner, der für die Anzeigenerweiterung festgelegt ist, kann dann im Feld Id der abhängigen Datensatztypen verwiesen werden, z. B. Anzeigenerweiterung für Anzeigengruppen-Werbung und Kampagnen-Werbungserweiterung. Dies wird empfohlen, wenn Sie neue Anzeigenerweiterungen 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
Sprache
Die Sprache, in der die Anzeigenerweiterung bereitgestellt wird.
Die Erweiterung wird immer in dieser Sprache bereitgestellt, unabhängig von den Spracheinstellungen der Kampagne oder Anzeigengruppe.
Die unterstützten Sprachzeichenfolgen sind: Dänisch, Niederländisch, Englisch, Finnisch, Französisch, Deutsch, Italienisch, Norwegisch, Portugiesisch, Spanisch, Schwedisch und TraditionellChinesisch.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Mobile Final Url
Die URL der Landing Page für mobile Geräte.
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 Listenelemente für die endgültige url und die mobile endgültige URL angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10 Listenelemente für potenzielle Vorwärtskompatibilität.
- Jede URL ist durch ein Semikolon und Leerzeichen ("; ") getrennt.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
- Wenn Sie Mobile Final URL angeben, müssen Sie auch Final URL angeben.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
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: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Money Amount Off
Das Geld aus Dem Promotion-Wert.
Wenn Sie z. B. "20 USD off shoes - On orders over $100" (Bei Bestellungen über 100 USD) höher stufen möchten, legen Sie das Aktionsziel auf "Schuhe" fest, legen Sie den Währungscode auf "USD" fest, legen Sie Money Amount Off auf 20 fest, und legen Sie Orders Over Amount auf 100 fest.
Hinzufügen: Erforderlich. Sie müssen entweder Money Amount Off oder Percent Off festlegen, aber Sie können nicht beide festlegen.
Aktualisieren: Optional. Sie können entweder Money Amount Off oder Percent Off festlegen, aber sie können nicht beide festlegen.
Löschen: Schreibgeschützt
Anlass
Der Promotion-Anlass.
Sowohl die Felder "Gelegenheit " als auch "Zeitplanung" (Anzeigenzeitplan, "Enddatum", "Startdatum" und " Searcher-Zeitzone verwenden ") bestimmen, wann die Promotion in Anzeigen angezeigt werden kann.
Die Aktion Gelegenheit bestimmt den Zeitraum oder die Saisonalität, z. B. WomensDay vom 15. Februar bis 31. März jedes Jahr. Die Heraufstufung wird nur innerhalb der Datumsangaben ausgeführt, die dem von Ihnen festgelegten Anlass entsprechen. In der folgenden Tabelle finden Sie Details zum definierten Datumsbereich für die einzelnen Anlässe.
Die Zeitplanung kann die Höherstufung auf einen kürzeren Zeitrahmen innerhalb des Datumsbereichs des Anlasses beschränken, z. B. die Ausführung der Höherstufung zwischen dem 20. Februar und dem 8. März zu beschränken. Die Zeitplanung kann auch verwendet werden, um dieselbe Aktion mehrere Jahre auszuführen, z. B. die WomensDay-Aktion jedes Jahr vom 15. Februar bis zum 31. März durchzuführen.
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert Keine festgelegt.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld festlegen, müssen auch die vorherigen Einstellungen " Promotion Start " und " Promotion End " festgelegt werden.
Löschen: Schreibgeschützt
Orders Over Amount
Die Aufträge über den Betragswert, der an das Heraufstufungsziel angefügt wird.
Wenn Sie z. B. "20 USD off shoes - On orders over $100" (Bei Bestellungen über 100 USD) höher stufen möchten, legen Sie das Aktionsziel auf "Schuhe" fest, legen Sie den Währungscode auf "USD" fest, legen Sie Money Amount Off auf 20 fest, und legen Sie Orders Over Amount auf 100 fest.
Hinzufügen: Optional. Sie können nicht sowohl "Orders Over Amount " als auch "Promotion Code" festlegen.
Aktualisieren: Optional. Sie können nicht sowohl "Orders Over Amount " als auch "Promotion Code" festlegen. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf "0" (null) festlegen, wird die vorherige Einstellung gelöscht.
Löschen: Schreibgeschützt
Übergeordnete ID
Der vom System generierte Bezeichner des Kontos, das die Anzeigenerweiterung enthält.
Dieses Massenfeld wird dem Feld Id des Kontodatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
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
Prozentualer Rabatt
Der prozentsatzoffene Heraufstufungswert als double-Wert.
Beispielsweise stellt 10,0 einen Rabatt von 10 % dar.
Hinzufügen: Erforderlich. Sie müssen entweder Money Amount Off oder Percent Off festlegen, aber Sie können nicht beide festlegen.
Aktualisieren: Optional. Sie können entweder Money Amount Off oder Percent Off festlegen, aber sie können nicht beide festlegen. Wenn Sie dieses Feld festlegen, gilt die Einstellung Währungscode nicht mehr und wird gelöscht, wenn sie zuvor festgelegt wurde.
Löschen: Schreibgeschützt
Höherstufungscode
Der an das Heraufstufungsziel angefügte Höherstufungscode.
Wenn Sie z. B. "$20 off shoes - Promocode SAVE20" höher stufen möchten, legen Sie das Aktionsziel auf "schuhe" fest, legen Sie den Währungscode auf "USD" fest, legen Sie Money Amount Off auf 20 fest, und legen Sie den Aktionscode auf "SAVE20" fest.
Die Zeichenfolge darf maximal 15 Zeichen enthalten.
Hinzufügen: Optional. Sie können nicht sowohl "Orders Over Amount " als auch "Promotion Code" festlegen.
Aktualisieren: Optional. Sie können nicht sowohl "Orders Over Amount " als auch "Promotion Code" festlegen. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung gelöscht. Wenn Sie dieses Feld festlegen, gilt die Einstellung Währungscode nicht mehr und wird gelöscht, wenn sie zuvor festgelegt wurde.
Löschen: Schreibgeschützt
Promotion-Ende
Das Enddatum hilft dabei, das Promotiondatum oder die Datumsangaben zu informieren, die in der Anzeige angezeigt werden.
Wenn z. B. beide Datumsangaben für den Start und das Ende der Promotion auf den 14. Februar festgelegt sind, könnte der Text "Gültiger Februar 14" in die angezeigte Höherstufung eingeschlossen werden.
Das Startdatum der Promotion muss vor oder gleich dem Enddatum der Promotion sein.
Diese Eigenschaft überschreibt nicht den inhärenten Übermittlungsbereich für eine Heraufstufung. Sowohl die Felder "Anlass " als auch "Zeitplanung" (Anzeigenzeitplan, Enddatum, Startdatum und Suchzeitzone verwenden) bestimmen, wann die Promotion in Anzeigen angezeigt werden kann.
Wenn das Enddatum für das aktuelle Jahr bereits abgelaufen ist, müssen jedes Start- und Enddatum für Datumsangaben im Folgejahr festgelegt werden.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um das aktuelle Enddatum zu löschen und effektiv kein Enddatum festzulegen, legen Sie dieses Feld auf die delete_value Zeichenfolge fest. Wenn Sie die Werbungserweiterung das nächste Mal abrufen, wird dieses Feld nicht festgelegt.
Löschen: Schreibgeschützt
Höherstufung starten
Das Startdatum hilft ihnen, das Promotionsdatum oder die Datumsangaben zu informieren, die in der Anzeige angezeigt werden.
Wenn z. B. beide Datumsangaben für den Start und das Ende der Promotion auf den 14. Februar festgelegt sind, könnte der Text "Gültiger Februar 14" in die angezeigte Höherstufung eingeschlossen werden.
Das Startdatum der Promotion muss vor oder gleich dem Enddatum der Promotion sein.
Diese Eigenschaft überschreibt nicht den inhärenten Übermittlungsbereich für eine Heraufstufung. Sowohl die Felder "Anlass " als auch "Zeitplanung" (Anzeigenzeitplan, Enddatum, Startdatum und Suchzeitzone verwenden) bestimmen, wann die Promotion in Anzeigen angezeigt werden kann.
Wenn das Enddatum für das aktuelle Jahr bereits abgelaufen ist, müssen jedes Start- und Enddatum für Datumsangaben im Folgejahr festgelegt werden.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um das aktuelle Enddatum zu löschen und effektiv kein Enddatum festzulegen, legen Sie dieses Feld auf die delete_value Zeichenfolge fest. Wenn Sie die Werbungserweiterung das nächste Mal abrufen, wird dieses Feld nicht festgelegt.
Löschen: Schreibgeschützt
Höherstufungsziel
Das Höherstufungsziel oder -element.
Sie können beispielsweise eine Promotion für "Schuhe" mit einem Rabatt von 20 USD oder 20 % durchführen. Um eine Promotion für "Bis zu 20 USD off shoes" auszuführen, legen Sie das Aktionsziel auf "Schuhe" fest, legen Sie den Rabattmodifizierer auf "UpTo" fest, legen Sie den Währungscode auf "USD" fest, und legen Sie Money Amount Off auf 20 fest.
Die Zeichenfolge darf maximal 20 Zeichen enthalten.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Anfangstermin
Die geplante Startdatumszeichenfolge für die Anzeigenerweiterung, die als MM/TT/JJJJ formatiert ist.
Das Startdatum ist inklusive. Wenn Sie z. B . StartDate auf den 5.05.2020 festlegen, werden die Anzeigenerweiterungen am 5.05.2020 um 12:00 Uhr angezeigt.
Hinzufügen: Optional. Wenn Sie kein Startdatum angeben, kann die Anzeigenerweiterung sofort geplant werden.
Aktualisieren: Optional. Das Startdatum kann verkürzt oder verlängert werden, solange das Enddatum entweder NULL ist oder nach dem neuen Startdatum liegt. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, entfernen Sie effektiv das Startdatum, und die Anzeigenerweiterung kann sofort geplant werden. Die Felder Anzeigenzeitplan, Enddatum, Startdatum und Zeitzone der Suche verwenden hängen voneinander ab und werden gemeinsam aktualisiert. Wenn Sie alle diese Felder während des Updates leer lassen, wird keines von ihnen aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für alle diese Felder entfernt oder ersetzt. Um alle vorherigen Zeitplaneinstellungen zu entfernen, legen Sie jedes dieser Felder auf delete_value fest.
Löschen: Schreibgeschützt
Status
Der status der Anzeigenerweiterung.
Mögliche Werte sind Aktiv oder Gelöscht.
Hinzufügen: Optional. Der Standardwert ist Aktiv.
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.
Vorlage für die Nachverfolgung
Die Nachverfolgungsvorlage, die für Ihre Promotion-URLs 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: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt
Verwenden der Searcher-Zeitzone
Bestimmt, ob die Zeitzone des Kontos oder die Zeitzone des Suchbenutzers verwendet werden soll, in der die Anzeigen übermittelt werden könnten.
Legen Sie diese Eigenschaft auf TRUE fest, wenn die Anzeigenerweiterungen in der Zeitzone des Suchbenutzers angezeigt werden sollen, und legen Sie sie andernfalls auf FALSE fest.
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert FALSE festgelegt, und die Kontozeitzone wird verwendet.
Aktualisieren: Optional. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, setzen Sie effektiv auf den Standardwert FALSE zurück. Die Felder Anzeigenzeitplan, Enddatum, Startdatum und Zeitzone der Suche verwenden hängen voneinander ab und werden gemeinsam aktualisiert. Wenn Sie alle diese Felder während des Updates leer lassen, wird keines von ihnen aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für alle diese Felder entfernt oder ersetzt. Um alle vorherigen Zeitplaneinstellungen zu entfernen, legen Sie jedes dieser Felder auf delete_value fest.
Löschen: Schreibgeschützt
Version
Gibt an, wie oft der Inhalt der Anzeigenerweiterung aktualisiert wurde. Die Version wird beim Hinzufügen der Erweiterung auf 1 festgelegt und bei jeder Überarbeitung erhöht.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt