Freigeben über

Bildanzeigenerweiterungsdatensatz – Massenvorgang

  • Artikel

Definiert eine Bildanzeigenerweiterung, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine Bildanzeigenerweiterung zuordnen. Jedes Konto kann bis zu 250.000 Zuordnungen von Kampagnenimageerweiterungen und bis zu 250.000 Zuordnungen von Bilderweiterungen für Anzeigengruppen aufweisen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann bis zu 25 Bildanzeigenerweiterungen zugeordnet werden. Verwenden Sie die Einträge Account Image Ad Extension, Ad Group Image Ad Extension und Campaign Image Ad Extension , um Zuordnungen von Bildanzeigenerweiterungen zu verwalten.

Sie können alle Datensätze der Bildanzeigenerweiterung im Konto herunterladen, indem Sie den DownloadEntity-Wert von ImageAdExtensions 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 Bildanzeigenerweiterung 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,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

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 BulkImageAdExtension-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 BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // '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 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

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 Bildanzeigenerweiterung 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

Alternativtext

Alternative Beschreibung der Bildmedien für die Benutzerfreundlichkeit. Wenn das Bild nicht angezeigt werden konnte, wird stattdessen der Alternativtext verwendet.

Die maximale Länge für dieses Feld beträgt 90 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

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

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

Ziel-URL

Die URL der Webseite, zu der der Benutzer gelangen soll, wenn er auf das Bild klickt.

Die URL kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?.

Die URL darf maximal 1.024 Zeichen enthalten. Wenn die URL kein Protokoll angibt, verwendet das System das HTTP-Protokoll, wenn ein Benutzer auf die Anzeige klickt. Wenn die URL das HTTP-Protokoll angibt, wenn Sie eine Anzeige hinzufügen, entfernt der Dienst die http:// Protokollzeichenfolge (die HTTP-Protokollzeichenfolge zählt nicht auf den Grenzwert von 1.024 Zeichen); Der Dienst entfernt jedoch keine HTTPS-Protokollzeichenfolge (https://) aus der URL.

Hinweis

Wenn die URL für die Bildanzeigenerweiterung nicht angegeben ist, wird die URL der Anzeige verwendet.

Hinzufügen: Optional. Hinweis: Dieses Feld ist für Anzeigenerweiterungen mit mehreren Bildern erforderlich. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Hinweis: Dieses Feld ist für Anzeigenerweiterungen mit mehreren Bildern erforderlich.
Löschen: Schreibgeschützt

Anzeigen von Text

Der Anzeigetext Ihrer Bilderweiterung.

Die maximale Länge für dieses Feld beträgt 35 Zeichen.

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

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 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: Optional
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 wurde, kann dann im Feld Id abhängiger Datensatztypen wie Ad Group Image Ad Extension und Campaign Image Ad Extension 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

Bilder

Bildressourcen mit unterschiedlichen Größen und Seitenverhältnissen, sodass sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können.

Sie müssen nur ein Bildobjekt im Querformat bereitstellen, d. h., dieses Feld muss ein Bildobjekt enthalten, bei dem subType auf LandscapeImageMedia festgelegt ist. Die empfohlenen Abmessungen für LandscapeImageMedia sind 1200 Breite x 628 Höhe. Optional können Sie zusätzliche Ressourcenlinks einschließen, d. h. ein Imageobjekt für jeden unterstützten Untertyp. Für alle Untertypen von Bildobjekten, die Sie nicht explizit festlegen, erstellt Microsoft Advertising automatisch Bildobjektlinks, indem LandscapeImageMedia zugeschnitten wird.

Die Bildressourcen werden in der Massendatei als JSON-Zeichenfolge dargestellt. Im json-Beispiel unten sind sieben Bilder enthalten, und nur LandscapeImageMedia subType wird nicht zugeschnitten. ist id eine Eigenschaft des Medienobjekts, während , cropHeightcropWidth, cropX, cropYund subType Eigenschaften der Objektverbindung sind, d. h. die Beziehung zwischen dem Medienobjekt und der Anzeige. Weitere Informationen finden Sie weiter unten unter cropHeight, cropWidth, cropX, cropY, id und subType .

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Hinweis

In der durch Trennzeichen getrennten Massendatei müssen Sie die Liste der Ressourcenverknüpfungen, jeden Attributschlüssel und jeden Attributzeichenfolgenwert mit einem zusätzlichen Satz doppelter Anführungszeichen einschließen, z. B. Die obige JSON-Zeichenfolge würde als "[{""id"":1234567890000,"""subType"":""LandscapeImageMedia""},{""id"":1234567890000,"""subType"":""SquareImageMedia""",", ""cropX"":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{""id"":1234567890000, ""subType"":""ImageMedia169X100",""cropX":70,""cropY"":0,"cropWidth":1061,"""cropHeight"":628},{""id"":1234567890000,""subType"":"ImageMedia93X100",""cropX":308,""cropY"":0,""cropWidth"":584,"""cropHeight"":628},{""cropHeight"":628},{"" id":1234567890000,""subType":""ImageMedia15X10","""cropX":129,""cropY"":0,""cropWidth"":942,"""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia155X100",""cropX"":114,""cropY":0,""cropWidth"":973,""cropHeight"" :628},{""id"":1234567890000,"""subType"":"ImageMedia133X100"",""cropX"":183,"""cropY"":0,""cropWidth"":835,""cropHeight"":628},{""id"":1234567890000,"""subType"":"ImageMedia178X100"",""cropX"":":" 41,""cropY"":0,""cropWidth"":1118,""cropHeight"":628},{"id"":1234567890000,"""subType"":""ImageMedia172X100"",""cropX":60,""cropY"":0,""cropWidth"":1080,""cropHeight"":628}]".

Beachten Sie im obigen Beispiel zum Hochladen der Antwort im JSON-Format Folgendes:

  • Derselbe Bildobjektbezeichner (z. B. 1234567890000) wird für alle automatisch generierten Bildressourcenuntertypen verwendet. Unabhängig davon, ob Sie Microsoft Advertising die zugeschnittenen Bilder automatisch generieren lassen, muss die ID unter den Mit derselben Anzeige verknüpften Bildressourcen nicht eindeutig sein.
  • Da die Anzeige in diesem Beispiel ohne Zuschneideeinstellungen für den Image-Untertyp LandscapeImageMedia erstellt wurde, werden alle Bildressourcen mit Ausnahme des ursprünglichen Querformatbilds zugeschnitten.
  • Unabhängig davon, ob das Querformatbild über eigene Zuschneideeinstellungen verfügt oder nicht, verwendet Microsoft Advertising die tatsächliche Höhe des Querformatbilds für alle Standardzuschneideeinstellungen. In diesem Beispiel beträgt die Zuschneidehöhe für alle systemgenerierten Bildressourcen 628, und wir können daraus ableiten, dass das Querformatbild (Untertyp LandscapeImageMedia) mit einem Seitenverhältnis von 1,91:1 eine Breite und Höhe von 1200 x 628 aufweist. Selbst wenn die Querformat-Medienobjektverknüpfung mit Zuschneideeinstellungen erstellt worden wäre, z. B. 703 x 368, basieren die Zuschneideeinstellungen der automatisch generierten Bildressourcen auf den vollständigen Abmessungen des Querformatbilds (in diesem Beispiel wäre dies wiederum 1200 x 628).

cropHeight

Die Anzahl von Pixeln, die von der Bildobjektquelle verwendet werden sollen, beginnend mit der CropY-Position und der Bewegung nach oben.

cropWidth

Die Anzahl der Pixel, die von der Bildobjektquelle verwendet werden sollen, beginnend mit der CropX-Position und der Bewegung nach rechts.

cropX

Ausgehend von der unteren linken Ecke der Bildobjektquelle ist dies die Anzahl von Pixeln, die vor dem Anwenden von cropWidth auf der X-Achse nach rechts springen sollen.

cropY

Ausgehend von der unteren linken Ecke der Bildobjektquelle ist dies die Anzahl von Pixeln, die auf der Y-Achse nach oben übersprungen werden sollen, bevor der CropHeight angewendet wird.

id

Das id Attribut ist ein eindeutiger Microsoft Advertising-Bezeichner für das Medienobjekt in einem Microsoft Advertising-Konto.

Derselbe Bildobjektbezeichner kann mehrmals in derselben Anzeige für unterschiedliche Seitenverhältnisse verwendet werden und kann auch von mehreren Anzeigen im selben Microsoft Advertising-Konto verwendet werden. Der Bezeichner des Bildobjekts, bei dem SubType auf LandscapeImageMedia festgelegt ist, wird für alle automatisch generierten Bildmedienobjekttypen innerhalb derselben Anzeige verwendet. Unabhängig davon, ob Sie Microsoft Advertising die zugeschnittenen Bilder automatisch generieren lassen, muss die ID unter den Mit derselben Anzeige verknüpften Bildressourcen nicht eindeutig sein.

Sie können Bilder für Bildanzeigenerweiterungen über den Bild-Massendatensatz erstellen. Anschließend können Sie den zurückgegebenen Medienbezeichner als Imageobjekt-ID verwenden. Das Seitenverhältnis des hinzugefügten Bilds muss für den Untertyp der Bildressource unterstützt werden.

Untertyp

Das subType -Attribut stellt das Seitenverhältnis für dieses Bildobjekt dar.

Das wahre Seitenverhältnis des Bilds , das in der Medienbibliothek auf Kontoebene gespeichert ist, kann variieren, solange die resultierenden Dimensionen zu dem erwarteten Seitenverhältnis pro Untertyp führen. Wenn Sie keine Zuschneideeinstellungen angeben, wird der Dienst automatisch auf den maximal möglichen Bereich aus der Mitte des Bilds angezeigt. Bei einem Bild von 1000 x 1000 Pixeln lautet die Einstellung für das Seitenverhältnis 1,91:1 beispielsweise cropWidth=1000, cropHeight=524, cropX=0 und cropY=238.

Mögliche Untertypwerte sind LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X10, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 und ImageMedia172X100. Möglicherweise werden in Zukunft neue Untertypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten.

Untertyp Mindestabmessungen in Pixel
LandscapeImageMedia 703 Breite x 368 Höhe
Aspect Radio 1.91:1
SquareImageMedia 300 Breite x 300 Höhe
Aspect Radio 1:1
ImageMedia169X100 622 Breite x 368 Höhe
Aspect Radio 1.69:1
ImageMedia93X100 311 Breite x 333 Höhe
Aspect Radio 0.93:1
ImageMedia15X10 300 Breite x 200 Höhe
Aspect Radio 1.5:1
ImageMedia155X100 300 Breite x 194 Höhe
Aspect Radio 1.55:1
ImageMedia133X100 100 Breite x 75 Höhe
Aspect Radio 1.33:1
ImageMedia178X100 624 Breite x 350 Höhe
Aspect Radio 1.78:1
ImageMedia172X100 300 Breite x 174 Höhe
Aspect Radio 1.72:1

Hinzufügen: Erforderlich. Für jede Medienobjektverbindung sind nur die ID und der Untertyp erforderlich.
Aktualisieren: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Feld fest oder lassen sie leer. Wenn Sie dieses Feld festlegen, werden alle Bilder ersetzt, die zuvor mit dieser Anzeige verknüpft waren. Wenn Sie dieses Feld festlegen, sind nur die ID und der Untertyp für jede Medienobjektverbindung erforderlich.
Löschen: Schreibgeschützt

Layouts

Die Liste der geeigneten Bildlayouts.

Unterstützte Werte sind SearchSingle und SearchMultiple. Möglicherweise werden in Zukunft neue Layouts hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten.

In einer Massendatei wird die Liste der Layoutzeichenfolgen durch ein Semikolon (;).

Hinzufügen: Optional. Wenn Sie dieses Feld nicht festlegen, werden alle aktuellen und zukünftigen unterstützten Layouts standardmäßig festgelegt.
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

Medien-IDs

Die Bezeichner der Bilder, die in die Anzeige aufgenommen werden sollen. Sie dürfen keine Medienbezeichner für mehr als ein Bild mit demselben Seitenverhältnis angeben. Anders ausgedrückt: Jedes der Bilder, auf die verwiesen wird, muss unterschiedliche Seitenverhältnisse aufweisen.

Sie können bis zu vier (4) Bildbezeichner angeben. Obwohl mindestens eine Bildmedien-ID erforderlich ist, müssen Sie vier Bildmedienbezeichner angeben, um sich für alle Anzeigenplatzierungen zu qualifizieren.

In einer Massendatei wird die Liste der Medienbezeichner durch ein Semikolon (;).

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

Ü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.

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