Flyer Ad Extension Record – Bulk
Definiert eine Flyer-Anzeigenerweiterung, die heruntergeladen und in einer Massendatei hochgeladen werden kann.
Flyer Extensions ermöglichen es Werbetreibenden, Produkt- oder Store-Kataloge (Flyer) an potenzielle Kunden zu verteilen.
Sie können in breiten Abfragen wie "wöchentliche Deals" oder "wöchentliche Verkäufe" prominent angezeigt werden und so Kunden ermutigen, auf Ihre Anzeige statt auf die der Konkurrenz zu klicken. Durch ihre Natur tragen sie dazu bei, Sucher besser zu informieren und dadurch die Benutzerbindung zu erhöhen, z. B. die Klickrate.
Hinweis
Flyer-Erweiterungen sind für Kunden im Featurepiloten verfügbar (GetCustomerPilotFeatures gibt 802 zurück).
Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine Flyer-Anzeigenerweiterung zuordnen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann bis zu 3 Flyer-Anzeigenerweiterungen zugeordnet werden. Verwenden Sie die Einträge Account Flyer Ad Extension, Ad Group Flyer Ad Extension und Campaign Flyer Ad Extension , um Zuordnungen von Flyer-Anzeigenerweiterungen zu verwalten.
Sie können alle Flyer Ad Extension-Einträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von FlyerAdExtensions in die Serviceanfrage 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 Flyer-Anzeigenerweiterung hinzugefügt.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,
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 BulkFlyerAdExtension-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.
// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
// '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
// FlyerAdExtension object of the Campaign Management service.
FlyerAdExtension = new FlyerAdExtension
{
// 'Description' column header in the Bulk file
Description = "Flyer description",
// 'Id' column header in the Bulk file
Id = flyerAdExtensionIdKey,
// '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/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// '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/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Flyer Name' column header in the Bulk file
FlyerName = "Flyer name",
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new[] {
(long)12345678,
},
// 'Media Urls' column header in the Bulk file
ImageMediaUrls = null,
// 'Store Id' column header in the Bulk file
StoreId = 12345678,
// '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(bulkFlyerAdExtension);
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 Flyer Ad Extension-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
- Anzeigenzeitplan
- Client-ID
- Beschreibung
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Enddatum
- Endgültige URL
- Name des Flyers
- Id
- Medien-IDs
- Medien-URLs
- Mobile Final Url
- Änderungszeit
- Übergeordnete ID
- Herausgeberländer
- Startdatum
- Status
- Store-ID
- 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 und Searcher-Zeitzone verwenden hängen voneinander ab und werden zusammen aktualisiert. Wenn Sie beide Felder während des Updates leer lassen, wird keines dieser Felder aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für jedes dieser Felder entfernt oder ersetzt.
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
Beschreibung
Beschreibung, die vom Werbetreibenden, der Agentur oder dem Konto-Manager verwendet werden kann, um Flyererweiterungen zu verfolgen, zu kennzeichnen oder zu verwalten.
Diese Beschreibung wird nicht zusammen mit der Anzeige oder dem Bild angezeigt.
Die maximale Länge für dieses Element beträgt 1.024 Zeichen.
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
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.
Das Enddatum muss innerhalb von 30 Tagen nach dem Startdatum sein.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Das Enddatum kann verkürzt oder verlängert werden, solange der Starttermin nicht festgelegt ist oder bis zu 30 Tage vor dem neuen Enddatum liegt.
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
Name des Flyers
Der Name des Flyers.
Die maximale Länge für dieses Element beträgt 150 Zeichen.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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 für die Anzeigenerweiterung kann dann im Feld Id von abhängigen Datensatztypen wie Anzeigengruppen-Flyer-Anzeigenerweiterung und Kampagnenflyer-Anzeigenerweiterung verwiesen werden. 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
Medien-IDs
Der Bezeichner des Bilds, das in die Anzeige aufgenommen werden soll.
Sie können nur eine Medien-ID festlegen.
Jede Medien-ID entspricht einem Image des Untertyps "GenericImage".
Das Bild sollte eine Mindestbreite und Höhe von 220 Pixeln und eine maximale Dateigröße von 3,9 MB aufweisen.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Medien-URLs
Die URL des Mediums, das Sie bereits hinzugefügt haben.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
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
Ü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
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.
Das Enddatum muss innerhalb von 30 Tagen nach dem Startdatum sein.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Der Starttermin kann verkürzt oder verlängert werden, solange das Enddatum nicht festgelegt ist oder bis zu 30 Tage nach dem neuen Startdatum liegt.
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.
Store-ID
Der eindeutige Bezeichner eines Microsoft Merchant Center-Stores, der für Produktanzeigen verwendet wird.
Hinzufügen: Optional
Aktualisieren: Schreibgeschützt. Sie können die Store-ID nicht aktualisieren, nachdem sie festgelegt wurde.
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 und Searcher-Zeitzone verwenden hängen voneinander ab und werden zusammen aktualisiert. Wenn Sie beide Felder während des Updates leer lassen, wird keines dieser Felder aktualisiert. Wenn Sie Werte für eines dieser Felder einschließen, werden die vorherigen Werte für jedes dieser Felder entfernt oder ersetzt.
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