Freigeben über

Dynamischer Anzeigendatensatz – Massenvorgang

  • Artikel

Definiert eine reaktionsfähige Anzeige, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

Reaktionsfähige Anzeigen werden automatisch an die Größen und Formen der Zielgruppenanzeigeformate angepasst. Diese Anzeigen funktionieren am besten mit informativem Text und nicht mit Handlungsaufrufen.

Hinweis

Dieses Feature ist derzeit in den USA, Kanada, großbritannien und Australien verfügbar. Wenn Sie Inserate in den USA, Kanada, dem Vereinigten Königreich oder Australien bewerben und Sich für Zielgruppenanzeigen anmelden möchten, wenden Sie sich an den Support.

Hinweis

Doppelte reaktionsfähige Anzeigen sind in derselben Anzeigengruppe zulässig.

Sie können alle Responsive Ad-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von ResponsiveAds 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 eine neue reaktionsfähige Anzeige hinzugefügt, wenn ein gültiger Wert für übergeordnete ID angegeben wird.

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

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 BulkResponsiveAd-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 BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkResponsiveAd);

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

Anzeigengruppe

Der Name der Anzeigengruppe, die die Anzeige enthält.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Hinweis

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Anzeigengruppe angeben.

Unternehmensname

Der Name des Unternehmens.

Abhängig von der Platzierung Ihrer Zielgruppenanzeige kann der Name Ihres Unternehmens in Ihrer Anzeige angezeigt werden.

Die Länge der Zeichenfolge ist auf 25 Zeichen beschränkt.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Handlungsaufruf

Ein kurzer, schlagkräftiger Grund für Kunden, sofort auf Ihre Anzeige zu klicken.

Die möglichen Werte sind AddToCart, ApplyNow, BookNow, BookTravel, Buy, BuyNow, ContactUs, Download, GetQuote, Install, LearnMore, NoButton, OpenLink, OrderNow, RegisterNow, SeeMore, ShopNow, SignUp, Subscribe und VisitSite.

Hinzufügen: Gilt nicht für Zielgruppenanzeigen.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Call-to-Action-Langauge

Die Sprache, in der der Handlungsaufruf bereitgestellt wird.

Der Handlungsaufruf wird immer in dieser Sprache bereitgestellt, unabhängig von den Spracheinstellungen der Kampagne.

Hinzufügen: Gilt nicht für Zielgruppenanzeigen; Erforderlich für Multimediaanzeigen.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Kampagne

Der Name der Kampagne, die die Anzeigengruppe und die Anzeige enthält.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
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 8 benutzerdefinierten Schlüssel- und Wertpaare, die Sie einschließen, und 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 250 UTF-8 Bytes nicht überschreiten. 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. Das Schlüsselwort delete_value 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

Beschreibungen

Abhängig von der Platzierung Ihrer Zielgruppenanzeige wird dieser Text unterhalb oder neben der langen oder kurzen Überschrift Ihrer Anzeige angezeigt.

Sie haben mehr Platz für Zeichen im Anzeigentext als in der Überschrift. Sobald das Bild und die Überschrift die Aufmerksamkeit des potenziellen Kunden haben, muss der Anzeigentext ihn davon überzeugen, darauf zu klicken. Was zeichnet Ihr Produkt oder Ihre Dienstleistung aus?

Der Text muss mindestens ein Wort enthalten.

Die Obergrenze für Beschreibungen ist 5. Die Länge der Zeichenfolge ist auf 90 Zeichen beschränkt. Das Datenformat von Überschriften ist im json-Beispiel unten enthalten.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Hinzufügen: Erforderlich für Zielgruppenanzeigen und Multimediaanzeigen. Gilt nicht für Videoanzeigen. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Löschen: Schreibgeschützt

Redaktioneller Einspruchsstatus

Bestimmt, ob Sie die von der redaktionellen Rezension gefundenen Probleme anfechten können.

Mögliche Werte werden in der folgenden Tabelle beschrieben.

Wert Beschreibung
Anfechtbar Die redaktionelle Ausgabe ist ansprechend.
Einspruch ausstehend Die Redaktionelle Ausgabe ist anfechtbar, und es wurde Berufung eingelegt.
NotAppealable Die redaktionelle Ausgabe ist nicht ansprechend.

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

Redaktioneller Ort

Die Komponente oder Eigenschaft der Anzeige, 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

Der redaktionelle Status der Anzeige.

Mögliche Werte werden in der folgenden Tabelle beschrieben.

Wert Beschreibung
Aktiv Die Anzeige hat die redaktionelle Überprüfung bestanden.
ActiveLimited Die Anzeige wurde in einem oder mehreren Märkten redaktionsintern überprüft, und ein oder mehrere Elemente der Anzeige werden in einem anderen Markt redaktionsintern überprüft. Zum Beispiel hat die Anzeige die redaktionelle Überprüfung für Kanada bestanden und steht in den VEREINIGTEN Staaten noch aus.
Abgelehnt Die Anzeige scheiterte bei der redaktionellen Überprüfung.
Inaktiv Mindestens ein Element der Anzeige wird gerade redaktionsreprokiert.

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

Endgültige URL

Die URL der Landing Page.

Der Domänenteil der URL in Kombination mit den Zeichenfolgen für Pfad 1 und Pfad 2 darf 67 Zeichen nicht überschreiten.

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, mindestens eine endgültige URL erforderlich ist.

Hinweis

Diese URL wird nur verwendet, wenn das Schlüsselwort keine endgültige URL angibt.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Endgültiges URL-Suffix

Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

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
K

Überschrift

Dies ist eine von zwei möglichen Überschriften, die in Ihren Videoanzeigen erscheinen können.

Da Videoanzeigen reaktionsfähig sind, benötigen wir mehrere Überschriften, damit sie flexibel für eine Vielzahl von Herausgebern und Platzierungen bereitgestellt werden können.

Die Länge der Zeichenfolge ist auf 30 Zeichen beschränkt.

Hinzufügen: Erforderlich für Videoanzeigen. Gilt nicht für Multimedia-Anzeigen und Zielgruppenanzeigen. Aktualisieren: Optional. Veraltet für Multimedia- und Zielgruppenanzeigen. Verwenden Sie stattdessen Überschriften.
Löschen: Schreibgeschützt

Schlagzeilen

Da Zielgruppenanzeigen reaktionsfähig sind, benötigen wir mehrere Überschriften, damit sie flexibel für eine Vielzahl von Herausgebern und Platzierungen verwendet werden können.

Die Obergrenze von Überschriften ist 15. Und die Länge jeder Überschrift ist auf 30 Zeichen beschränkt. Das Datenformat von Überschriften ist im json-Beispiel unten enthalten.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Hinzufügen: Erforderlich für Multimedia-Anzeigen und Zielgruppenanzeigen. Gilt nicht für Videoanzeigen. 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 Anzeige.

Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für die Anzeige kann dann im Feld Übergeordnete ID abhängiger Datensatztypen wie responsive Anzeigenbezeichnung verwiesen werden. Dies wird empfohlen, wenn Sie neue Anzeigen 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

Da Zielgruppenanzeigen reaktionsfähig sind, können Sie mehrere Bildobjekte mit unterschiedlichen Größen und Seitenverhältnissen erstellen, damit sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können.

Hinweis

Ab sofort ersetzt SubType OriginalImage die Rolle von LandscapeImageMedia als Standardbild für ResponsiveAd of Audience Campaign.

Sie müssen nur ein OriginalImage-Objekt angeben, d. h., dieses Feld muss ein Bildobjekt enthalten, bei dem subType auf OriginalImage festgelegt ist. Die empfohlenen Abmessungen für das OriginalImage 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 Bildobjektuntertypen, die Sie nicht explizit festlegen, erstellt Microsoft Advertising automatisch Bildobjektlinks, indem das OriginalImage zugeschnitten wird.

Hinweis

Wenn dieses Feld festgelegt (nicht leer) ist, werden querformatige Bildmedien-ID und Quadratische Bildmedien-ID ignoriert.

Die Bildressourcen werden in der Massendatei als JSON-Zeichenfolge dargestellt. Neun Bilder sind im json-Beispiel unten enthalten, und nur das OriginalImage 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": "OriginalImage"
},
{
	"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"":""OriginalImage""},{""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 Untertyp OriginalImage image erstellt wurde, werden alle Bildressourcen mit Ausnahme des zugeordneten OriginalImage-Bilds zugeschnitten.
  • Unabhängig davon, ob das OriginalImage über eigene Zuschneideeinstellungen verfügt oder nicht, verwendet Microsoft Advertising die tatsächliche Höhe des zugeordneten OriginalImage-Bilds 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 OriginalImage (Untertyp OriginalImage) mit einem Seitenverhältnis von 1,91:1 die Breite und Höhe von 1200 x 628 aufweist. Selbst wenn der Link für das OriginalImage-Objekt mit Zuschneideeinstellungen erstellt wurde, z. B. 703 x 368, basieren die Zuschneideeinstellungen der automatisch generierten Bildressourcen auf den vollständigen Abmessungen des OriginalImage (in diesem Beispiel wäre dies wiederum 1200 x 628).
  • Obwohl Sie in Version 12 der Bing Ads-API die Querformat-Bildmedien-ID und die Quadratische Bildmedien-ID verwenden könnten, sind diese Felder veraltet und werden in einer zukünftigen Version entfernt. Sie haben mehr Flexibilität und Kontrolle über zugeschnittene Bilder über das Feld Bilder .

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 reaktionsfähige Anzeigen ü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 OriginalImage, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 und ImageMedia153X100. Möglicherweise werden in Zukunft neue Untertypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten.

Untertyp Seitenverhältnis Mindestabmessungen in Pixel
OriginalImage Nicht zutreffend 703 Breite x 368 Höhe
LandscapeImageMedia 1.91:1 300 Breite x 157 Höhe
SquareImageMedia 1:1 114 Breite x 114 Höhe
ImageMedia4x1 4:1 608 Breite x 152 Höhe
ImageMedia1x2 1:2 470 Breite x 940 Höhe
ImageMedia201X100 2.01:1 612 Breite x 304 Höhe
ImageMedia120X100 1.2:1 300 Breite x 250 Höhe
ImageMedia200X100 2:1 200 Breite x 100 Höhe
ImageMedia169X100 1.69:1 628 Breite x 372 Höhe
ImageMedia124X100 1.24:1 104 Breite x 84 Höhe
ImageMedia153X100 1.53:1 306 Breite x 200 Höhe

Hinzufügen: Erforderlich, wenn die Medien-ID des Querformats leer ist. 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

UrLs für die Nachverfolgung von Impressionen

Die URLs für 1 x 1 Bildnachverfolgungspixel. Jedes Pixel meldet Microsoft Audience Network-Impressionen an Ihr Drittanbieter-Anzeigenberichtstool.

Sie können für jede reaktionsfähige Anzeige bis zu 2 URLs zur Nachverfolgung von Impressionen hinzufügen. Jede URL ist durch ein Semikolon und Leerzeichen ("; ") getrennt.

Auf jede URL muss zugegriffen werden können. 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.

Für jede Microsoft Audience Network-Impression pingt Microsoft die URL, um die Nachverfolgung von Impressionen in Ihrem Drittanbieter-Anzeigenberichtstool zu ermöglichen. Erweiterte Benutzernachverfolgung wie Conversion Tracking oder Tracking basierend auf Cookies oder IP-Adressen wird nicht unterstützt.

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

Querformatbild-Medien-ID

Der Bezeichner des Bildobjekts, das für Querformatbilder mit einem Seitenverhältnis von 1,91:1 verwendet wird, das in Ihren Zielgruppenanzeigen angezeigt werden könnte.

Das Seitenverhältnis der gespeicherten Bildmedien kann variieren, solange die Einstellungen für das Zuschneiden der Bildressource das unterstützte Seitenverhältnis für dieses Feld ergeben. Um das effektive Seitenverhältnis mit zuschneidenden Einstellungen zu bestätigen, verwenden Sie das Feld Bilder .

Hinweis

Obwohl Sie in Version 12 der Bing Ads-API die Querformat-Bildmedien-ID und SquareImageMediaId verwenden können, sind diese Felder veraltet und werden in einer zukünftigen Version entfernt. Sie haben mehr Flexibilität und Kontrolle über zugeschnittene Bilder über das Feld Bilder .

Hinzufügen: Erforderlich, wenn Images nicht festgelegt ist. Wenn Images festgelegt ist, wird dieses Feld ignoriert.
Aktualisieren: Optional. Wenn Images festgelegt ist, wird dieses Feld ignoriert. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Medien-ID des Querformatlogos

Dieses Feld ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der Bing Ads-API entfernt.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Lange Überschrift

Dies ist eine von zwei möglichen Schlagzeilen, die in Ihren Zielgruppenanzeigen erscheinen können.

Da Zielgruppenanzeigen reaktionsfähig sind, benötigen wir mehrere Überschriften, damit sie flexibel für eine Vielzahl von Herausgebern und Platzierungen verwendet werden können.

Die Länge der Zeichenfolge ist auf 90 Zeichen beschränkt.

Hinzufügen: Erforderlich
Aktualisieren: Veraltet. Verwenden Sie stattdessen lange Überschriften.
Löschen: Schreibgeschützt

Lange Überschriften

Da Zielgruppenanzeigen reaktionsfähig sind, benötigen wir mehrere Überschriften, damit sie flexibel für eine Vielzahl von Herausgebern und Platzierungen verwendet werden können.

Die Obergrenze für lange Überschriften ist 5. Und die Länge jeder Überschrift ist auf 90 Zeichen beschränkt. Das Datenformat langer Überschriften ist im json-Beispiel unten enthalten.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Hinzufügen: Erforderlich für Multimedia-Anzeigen und Zielgruppenanzeigen. Gilt nicht für Videoanzeigen. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Lange Überschriftenzeichenfolge

Überschriften sind der prominenteste Text, der in Ihrer Anzeige angezeigt wird, daher sollten Sie die verfügbaren Zeichen optimal nutzen. Da Zielgruppenanzeigen reaktionsfähig sind, benötigen wir mehrere Überschriften, damit sie flexibel für eine Vielzahl von Herausgebern und Platzierungen verwendet werden können.

Die Länge jeder Überschrift ist auf 90 Zeichen beschränkt. Das Datenformat langer Überschriften ist im json-Beispiel unten enthalten.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Hinzufügen: Erforderlich für Zielgruppenanzeigen und Videoanzeigen. Gilt nicht für Multimediaanzeigen. 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 mobilen 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 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.

Hinweis

Diese URL wird nur verwendet, wenn das Schlüsselwort keine mobile endgültige URL angibt.

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 der Anzeigengruppe, die die Anzeige enthält.

Dieses Massenfeld wird dem Feld Id des Anzeigengruppendatensatzes zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Anzeigengruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Anzeigengruppendatensatzes entspricht. Dies wird empfohlen, wenn Sie einer neuen Anzeigengruppe in derselben Massendatei neue Anzeigen hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Hinweis

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Anzeigengruppe angeben.

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

Status

Der Status der Anzeige.

Mögliche Werte sind Aktiv, Angehalten 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.

Medien-ID für quadratische Bilder

Der Bezeichner der Bildressource, die für quadratische Bilder mit einem Seitenverhältnis von 1:1 verwendet wird, die in Ihren Zielgruppenanzeigen angezeigt werden können.

Das Seitenverhältnis der gespeicherten Bildmedien kann variieren, solange die Einstellungen für das Zuschneiden der Bildressource das unterstützte Seitenverhältnis für dieses Feld ergeben. Um das effektive Seitenverhältnis mit zuschneidenden Einstellungen zu bestätigen, verwenden Sie das Feld Bilder .

Hinweis

Obwohl Sie in Version 12 der Bing Ads-API die Querformat-Bildmedien-ID und SquareImageMediaId verwenden können, sind diese Felder veraltet und werden in einer zukünftigen Version entfernt. Sie haben mehr Flexibilität und Kontrolle über zugeschnittene Bilder über das Feld Bilder .

Hinzufügen: Optional. Wenn Bilder festgelegt ist, wird dieses Feld ignoriert, und Microsoft Advertising erstellt automatisch ein neues quadratisches Bildobjekt, indem das LandscapeImageMedia-Bildobjekt zugeschnitten wird. Wenn Bilder nicht festgelegt ist und Sie dieses Feld nicht festlegen, erstellt Microsoft Advertising automatisch ein neues quadratisches Bildobjekt, indem die Medien-ID des Querformats zugeschnitten wird.
Aktualisieren: Optional. Wenn Bilder festgelegt ist, wird dieses Feld ignoriert, und Microsoft Advertising erstellt automatisch ein neues quadratisches Bildobjekt, indem das LandscapeImageMedia-Bildobjekt zugeschnitten wird. Wenn Bilder nicht festgelegt ist und Sie dieses Feld nicht festlegen, erstellt Microsoft Advertising automatisch ein neues quadratisches Bildobjekt, indem die Medien-ID des Querformats zugeschnitten wird. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Medien-ID des Quadratlogos

Dieses Feld ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der Bing Ads-API entfernt.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Text

Abhängig von der Platzierung Ihrer Videoanzeige wird dieser Text unterhalb oder neben der langen oder kurzen Überschrift Ihrer Anzeige angezeigt.

Sie haben mehr Platz für Zeichen im Anzeigentext als in der Überschrift. Sobald das Bild und die Überschrift die Aufmerksamkeit des potenziellen Kunden haben, muss der Anzeigentext ihn davon überzeugen, darauf zu klicken. Was zeichnet Ihr Produkt oder Ihre Dienstleistung aus?

Der Text muss mindestens ein Wort enthalten.

Die Länge der Zeichenfolge ist auf 90 Zeichen beschränkt.

Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Hinzufügen: Erforderlich für Videoanzeigen. Gilt nicht für Zielgruppenanzeigen oder Multimediaanzeigen. Aktualisieren: Optional für Videoanzeigen. Verwenden Sie stattdessen Beschreibungen für Zielgruppenanzeigen oder Multimediaanzeigen (veraltet).
Löschen: Schreibgeschützt

Vorlage für die Nachverfolgung

Die Nachverfolgungsvorlage, die als Standard für die mit FinalUrls angegebene URL 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 beispielsweise lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}und weder {_season} noch {_promocode} auf Kampagnen-, Anzeigengruppen-, Kriterium-, Schlüsselwort- oder 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