Anrufanzeigen-Erweiterungsdatensatz – Massenvorgang
Definiert eine Anrufanzeigenerweiterung, die in eine Massendatei hochgeladen und heruntergeladen werden kann.
Sie können kampagnen im Konto eine Anrufanzeigenerweiterung zuordnen. Jede Entität (Kampagne) kann einer Anrufanzeigenerweiterung zugeordnet werden. Verwenden Sie den Datensatz Kampagnenaufruf-Anzeigenerweiterung , um Zuordnungen von Anrufanzeigenerweiterungen zu verwalten.
Sie können alle Datensätze für die Anrufanzeigenerweiterung im Konto herunterladen, indem Sie den DownloadEntity-Wert von CallAdExtensions 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 Anrufanzeigenerweiterung hinzugefügt.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Country Code,Call Only,Call Tracking Enabled,Toll Free
Format Version,,,,,,,,,,,,6.0,,,,,,
Call Ad Extension,Active,-12,0,,,ClientIdGoesHere,,,12/31/2020,2065550100,,,(Monday[09:00-21:00]),FALSE,US,TRUE,TRUE,FALSE
Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager verwenden, um das BulkCallAdExtension-Objekt hochzuladen und herunterzuladen, 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 BulkCallAdExtension
var bulkCallAdExtension = new BulkCallAdExtension
{
// '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
// CallAdExtension object of the Campaign Management service.
CallAdExtension = new CallAdExtension
{
// 'Country Code' column header in the Bulk file
CountryCode = "US",
// 'Id' column header in the Bulk file
Id = callAdExtensionIdKey,
// 'Call Only' column header in the Bulk file
IsCallOnly = true,
// 'Call Tracking Enabled' column header in the Bulk file
IsCallTrackingEnabled = true,
// 'Phone Number' column header in the Bulk file
PhoneNumber = "2065550100",
// 'Toll Free' column header in the Bulk file
RequireTollFreeTrackingNumber = false,
// '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(bulkCallAdExtension);
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 Datensatz zur Anrufanzeigenerweiterung sind die folgenden Attributfelder im Massendateischema verfügbar.
- Anzeigenzeitplan
- Nur Anruf
- Anrufnachverfolgung aktiviert
- Client-ID
- Ländercode
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Enddatum
- Id
- Änderungszeit
- Übergeordnete ID
- Telefonnummer
- Herausgeberländer
- Startdatum
- Status
- Gebührenfrei
- 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
Nur Anruf
Die Option, sowohl Ihre Telefonnummer als auch Ihre Website oder nur Ihre Telefonnummer für Personen anzuzeigen, die Ihre Anzeigen auf einem Smartphone sehen. Möglicherweise möchten Sie nur Ihre Telefonnummer anzeigen, wenn Ihr Unternehmen erfordert, dass Sie mit jedem Kunden sprechen.
Legen Sie diese Eigenschaft auf TRUE fest, wenn die Anzeigenerweiterung nur die Telefonnummer ohne Link zu Ihrer Website anzeigt, und andernfalls, wenn die Anzeigenerweiterung zusätzlich zu der Telefonnummer einen Link zu Ihrer Website enthält, legen Sie sie auf FALSE fest.
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert FALSE festgelegt, und die Anzeigenerweiterung enthält zusätzlich zur Telefonnummer einen Link zu Ihrer Website.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Anrufnachverfolgung aktiviert
Bestimmt, ob die Anrufnachverfolgung für die Anrufanzeigenerweiterung aktiviert ist.
Legen Sie diese Eigenschaft auf TRUE fest, um die Anrufnachverfolgung zu aktivieren, und legen Sie sie andernfalls auf FALSE fest.
Hinweis
Die Anrufnachverfolgung wird nur im USA und im Vereinigten Königreich unterstützt.
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert FALSE festgelegt.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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
Country Code
Die Landesvorwahl, in der die Telefonnummer registriert ist.
Der Ländercode muss einen 2-stell großen Ländercode enthalten. Zu den unterstützten Ländercodewerten gehören AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE und VN.
Hinzufügen: Erforderlich
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
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 verwiesen werden, z. B. Campaign Call Ad Extension. 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
Ä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
Telefonnummer
Die anklickbare Telefonnummer, die in die Anzeige aufgenommen werden soll.
Die Telefonnummer darf maximal 35 Zeichen enthalten und muss für das angegebene Land oder die angegebene Region gültig sein.
Wenn die Kampagne Anruf- und Standortanzeigenerweiterungen enthält, überschreibt diese Telefonnummer die in den Ortsanzeigen-Durchwahlen angegebene Telefonnummer.
Die Telefonnummer kann neu formatiert werden. Wenn Sie beispielsweise die Telefonnummer auf 4255551212 festlegen, wird sie in (425) 555-1212 neu formatiert.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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.
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.
Gebührenfrei
Sie können entweder Ihre eigene Telefonnummer oder eine Microsoft Advertising-Weiterleitungstelefonnummer verwenden. Eine Microsoft Advertising-Weiterleitungstelefonnummer ist eine eindeutige Telefonnummer, die an Ihre geschäftliche Telefonnummer weitergeleitet wird. Mit einer Microsoft Advertising-Weiterleitungsnummer können Sie alle Aufrufe aus Ihrer Anzeige nachverfolgen, sodass Sie die Leistung der Anzeige analysieren können. Dieses Feld bestimmt, ob eine gebührenfreie Microsoft Advertising-Weiterleitungstelefonnummer für die Anrufnachverfolgung erstellt werden soll. Dieses Feld kann nur festgelegt werden, wenn das Feld Anrufverfolgung aktiviert ebenfalls TRUE ist.
Vor August 2017 konnten Clients diese Eigenschaft auf TRUE festlegen, wenn eine Microsoft Advertising-Weiterleitungstelefonnummer für die Anrufnachverfolgung erstellt werden soll. Seit August 2017 können Kunden keine neue gebührenfreie Microsoft Advertising-Weiterleitungstelefonnummer mehr erstellen. Wenn Sie diesen Wert TRUE festlegen, ist der Vorgang erfolgreich. Es wird jedoch keine gebührenfreie Nummer erstellt, und wenn Sie die Anrufanzeigenerweiterung abrufen, wird diese Eigenschaft auf FALSE festgelegt. Wenn vor August 2017 eine gebührenfreie Weiterleitungsnummer bereitgestellt wurde, ist diese Eigenschaft TRUE , wenn die Nummer beim Abrufen der Anrufanzeigenerweiterung noch aktiv ist.
Hinzufügen: Optional. Wenn Sie dieses Feld nicht angeben oder leer lassen, wird der Standardwert FALSE festgelegt.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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