Freigeben über

Preisanzeigenerweiterungsdatensatz – Massen

  • Artikel

Definiert eine Anzeigenerweiterung, die zwischen 3 und 8 Preistabellenzeilen enthält.

Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine Preisanzeigenerweiterung zuordnen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann bis zu 20 Preisanzeigenerweiterungen zugeordnet werden. Verwenden Sie die Einträge Account Price Ad Extension, Ad Group Price Ad Extension und Campaign Price Ad Extension , um Zuordnungen von Preisanzeigenerweiterungen zu verwalten.

Sie können alle Datensätze der Preisanzeigenerweiterung im Konto herunterladen, indem Sie den DownloadEntity-Wert von PriceAdExtensions 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 Preisanzeigenerweiterung hinzugefügt.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Tracking Template,Final Url Suffix,Custom Parameter,Price Extension Type,Currency Code 1,Currency Code 2,Currency Code 3,Currency Code 4,Currency Code 5,Currency Code 6,Currency Code 7,Currency Code 8,Price Description 1,Price Description 2,Price Description 3,Price Description 4,Price Description 5,Price Description 6,Price Description 7,Price Description 8,Header 1,Header 2,Header 3,Header 4,Header 5,Header 6,Header 7,Header 8,Final Mobile Url 1,Final Mobile Url 2,Final Mobile Url 3,Final Mobile Url 4,Final Mobile Url 5,Final Mobile Url 6,Final Mobile Url 7,Final Mobile Url 8,Final Url 1,Final Url 2,Final Url 3,Final Url 4,Final Url 5,Final Url 6,Final Url 7,Final Url 8,Price 1,Price 2,Price 3,Price 4,Price 5,Price 6,Price 7,Price 8,Price Qualifier 1,Price Qualifier 2,Price Qualifier 3,Price Qualifier 4,Price Qualifier 5,Price Qualifier 6,Price Qualifier 7,Price Qualifier 8,Price Unit 1,Price Unit 2,Price Unit 3,Price Unit 4,Price Unit 5,Price Unit 6,Price Unit 7,Price Unit 8
Format Version,,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Price Ad Extension,,-24,,,,ClientIdGoesHere,,,,,,(Monday[09:00-21:00]),FALSE,,,{_promoCode}=PROMO1; {_season}=summer,Events,USD,USD,USD,,,,,,Come to the event,Come to the next event,Come to the final event,,,,,,New Event,Next Event,Final Event,,,,,,,,,,,,,,https://contoso.com,https://contoso.com,https://contoso.com,,,,,,9.99,9.99,9.99,,,,,,From,From,From,,,,,,PerDay,PerDay,PerDay,,,,,

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 BulkPriceAdExtension-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 BulkPriceAdExtension
var bulkPriceAdExtension = new BulkPriceAdExtension
{
    // '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 
    // PriceAdExtension object of the Campaign Management service.
    PriceAdExtension = new PriceAdExtension
    {
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Id' column header in the Bulk file
        Id = priceAdExtensionIdKey,
        // 'Price Extension Type' column header in the Bulk file
        PriceExtensionType = PriceExtensionType.Events,

        // '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,

        // TableRows must include between 3 and 8 PriceTableRow
        TableRows = new PriceTableRow[]
        {
            // Each PriceTableRow is mapped to columns with suffix 1..8. 
            // This example shows 3 price table rows i.e., with column suffix from 1..3
            new PriceTableRow
            {
                // 'Currency Code 1' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 1' column header in the Bulk file
                Description = "Come to the new event",
                // 'Final Url 1' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 1' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 1' column header in the Bulk file
                Header = "New Event",
                // 'Price 1' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 1' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 1' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 2' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 2' column header in the Bulk file
                Description = "Come to the next event",
                // 'Final Url 2' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 2' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 2' column header in the Bulk file
                Header = "Next Event",
                // 'Price 2' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 2' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 2' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 3' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 3' column header in the Bulk file
                Description = "Come to the final event",
                // 'Final Url 3' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 3' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 3' column header in the Bulk file
                Header = "Final Event",
                // 'Price 3' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 3' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 3' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
        },
        // '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(bulkPriceAdExtension);

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 der Preisanzeigeerweiterung sind die folgenden Attributfelder im Massendateischema verfügbar.

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 (1-8)

Die Massendatei enthält bis zu 8 Währungscodespalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Währungscode 1, Währungscode 2, Währungscode 3, Währungscode 4, Währungscode 5, Währungscode 6, Währungscode 7 und Währungscode 8.

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.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
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 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.

Wert Beschreibung
Aktiv Die Anzeigenerweiterung hat die redaktionelle Überprüfung bestanden.
ActiveLimited Die Anzeigenerweiterung hat in einem oder mehreren Märkten eine redaktionelle Überprüfung bestanden, und ein oder mehrere Elemente der Anzeigenerweiterung werden in einem anderen Markt redaktionellen Überprüfungen unterzogen. Beispielsweise hat die Anzeigenerweiterung die redaktionelle Überprüfung für Kanada bestanden und steht im USA noch aus.
Abgelehnt Die redaktionelle Überprüfung der Anzeigenerweiterung ist fehlgeschlagen.
Inaktiv Mindestens ein Element der Anzeigenerweiterung wird gerade redaktionsreediert überprüft.

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 mobile URL (1-8)

Die Massendatei enthält bis zu 8 endgültige mobile URL-Spalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Final Mobile URL 1, Final Mobile URL 2, Final Mobile URL 3, Final Mobile URL 4, Final Mobile URL 5, Final Mobile URL 6, Final Mobile URL 7 und Final Mobile URL 8.

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.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Endgültige URL (1-8)

Die Massendatei enthält bis zu 8 endgültige URL-Spalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Final URL 1, Final URL 2, Final URL 3, Final URL 4, Final URL 5, Final URL 6, Final URL 7 und Final URL 8.

Die URL der Landing Page, die mit optionaler Nachverfolgungsvorlage und benutzerdefinierten Parametern verwendet werden soll.

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, die endgültige URL für jedes Preistabellenelement erforderlich ist.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Der Header, der den Preisdaten in Ihrer Preisanzeigenerweiterung vorangestellt ist. Jeder Header darf maximal 25 Zeichen enthalten. Jeder Header muss direkt mit dem Feld Preiserweiterungstyp für die Preisanzeigenerweiterung verknüpft sein.

Die Massendatei enthält bis zu 8 Headerspalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Header 1, Header 2, Header 3, Header 4, Header 5, Header 6, Header 7 und Header 8.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
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 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 Bezeichnersatz für die Anzeigenerweiterung kann dann im Feld Id von abhängigen Datensatztypen wie Anzeigengruppenpreis-Anzeigenerweiterung und Kampagnenpreis-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

Sprache

Die Sprache für die Anzeigenkopie Ihrer Preisanzeigenerweiterung.

Mögliche Werte finden Sie unter Anzeigensprachen.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
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

Preis (1-8)

Der Preis, den Sie ankündigen.

Die Massendatei enthält bis zu 8 Preisspalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind "Preis 1", " Preis 2", "Preis 3", "Preis 4", "Preis 5", "Preis 6", "Preis 7" und "Preis 8".

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Preisbeschreibung (1-8)

Die Beschreibung muss weitere Informationen zum Header enthalten, der ebenfalls in diesem Objekt definiert ist. Jede Beschreibung darf maximal 25 Zeichen enthalten.

Die Massendatei enthält bis zu 8 Preisbeschreibungsspalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Preisbeschreibung 1, Preisbeschreibung 2, Preisbeschreibung 3, Preisbeschreibung 4, Preisbeschreibung 5, Preisbeschreibung 6, Preisbeschreibung 7 und Preisbeschreibung 8.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Preiserweiterungstyp

Der Typ der Preisanzeigenerweiterung.

Mögliche Werte sind: Brands, Events, Locations, Neighborhoods, ProductCategories, ProductTiers, ServiceCategories, Services, ServiceTiers und Unknown. (Unbekannt ist für die zukünftige Verwendung reserviert und kann nicht festgelegt werden.)

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Preisqualifizierer (1-8)

Der Preisqualifizierer für ein bestimmtes Produkt oder eine bestimmte Dienstleistung, z. B. beginnend mit einem bestimmten Preis bis zu einem Höchstpreis.

Mögliche Werte sind: Average, From, UpTo, None und Unknown. (Unbekannt ist für die zukünftige Verwendung reserviert und kann nicht festgelegt werden.)

Die Massendatei enthält bis zu 8 Preisqualifiziererspalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind "Preisqualifizierer 1", "Preisqualifizierer 2", "Preisqualifizierer 3", "Preisqualifizierer 4", "Preisqualifizierer 5", "Preisqualifizierer 6", "Preisqualifizierer 7" und "Preisqualifizierer 8".

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Preis pro Einheit (1-8)

Mit der Preiseinheit können Sie die Kosten in Bezug auf Stunde, Tag, Woche usw. angeben.

Mögliche Werte sind: PerDay, PerHour, PerMonth, PerNight, PerWeek, PerYear, None und Unknown. (Unbekannt ist für die zukünftige Verwendung reserviert und kann nicht festgelegt werden.)

Die Massendatei enthält bis zu 8 Preiseinheitsspalten, d. h. eine für jedes Preistabellenelement in der Anzeigenerweiterung. Die Spaltenüberschriften der Massendatei sind Price Unit 1, Price Unit 2, Price Unit 3, Price Unit 4, Price Unit 5, Price Unit 6, Price Unit 7 und Price Unit 8.

Sie müssen zwischen 3 und 8 Preistabellenelemente pro Preisanzeigenerweiterung haben. Die Reihenfolge, in der Sie sie erstellen, ist die erwartete Reihenfolge in der Anzeige, aber die Reihenfolge ist nicht garantiert. Alle Preistabellenelemente für eine Preisanzeigenerweiterung müssen sich im gleichen Massendateidatensatz befinden. Jedes Preistabellenelement ist demselben Index der Spalten "Währungscode", " Endgültige mobile URL", "Endgültige mobile URL", " Kopfzeile", " Preis", " Preisbeschreibung", " Preiseinheit" und "Preisqualifizierer " zugeordnet. Beispielsweise ist das erste Preistabellenelement den Spalten Währungscode 1, Endgültige mobile URL 1, Endgültige URL 1, Kopfzeile 1, Preis 1, Preisbeschreibung 1, Preiseinheit 1 und Preisqualifizierer 1 zugeordnet.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
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.

Vorlage für die Nachverfolgung

Die Nachverfolgungsvorlage, die für ihre Preistabellenelement-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 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