ResponsiveAd-Datenobjekt – Kampagnenverwaltung

Ein reaktionsfähiges Anzeigenformat für Zielgruppenanzeigen und Multimediaanzeigen.

Das ResponsiveAd-Objekt wird sowohl für Multimedia-Anzeigen im Suchnetzwerk als auch für Zielgruppenanzeigen im Microsoft Audience Network verwendet. Ausführliche Informationen zu den wichtigsten Unterscheidungsmerkmalen finden Sie weiter unten im Abschnitt mit den Hinweisen .

Hinweis

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

Syntax

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das ResponsiveAd-Objekt verfügt über die folgenden Elemente: BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.

Element	Beschreibung	Datentyp
BusinessName	Der Name des Unternehmens. Je nach Anzeigenplatzierung 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.	Zeichenfolge
CallToAction	Ein kurzer, schlagkräftiger Grund für Kunden, sofort auf Ihre Anzeige zu klicken. Dies wird auf der Schaltfläche "Aktionsaufruf" angezeigt. 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.	CallToAction
CallToActionLanguage	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.	LanguageName
Beschreibungen	Die Beschreibungen, die unter dem Pfad in Ihrer Anzeige angezeigt werden. Um Aufrufe in allen Anzeigenformaten zu maximieren, werden die Beschreibungen möglicherweise nicht immer in Ihrer Anzeige angezeigt. Um Impressionen in allen Anzeigenformaten zu maximieren, werden die Beschreibungen möglicherweise nicht immer in Ihrer Anzeige angezeigt. Sofern Sie eine der Beschreibungen nicht an eine bestimmte Position anheften , optimiert Bing das Anzeigenlayout dynamisch mit den besten Überschriften und Beschreibungen für die Suchabfrage des Benutzers. Aus Sicht eines Datenmodells werden die Desriptionen und Überschriften jeweils als Textressourcen gespeichert, d. h. ein TextAsset pro AssetLink. Dasselbe Medienobjekt kann von mehreren Anzeigen verwendet werden. Wenn "Nahtlose Integration" beispielsweise ein Textobjekt ist, weist es für alle Anzeigen im selben Microsoft Advertising-Konto denselben Medienobjektbezeichner auf. Sie müssen zwischen 1 und 5 Beschreibungen festlegen. Der Text jeder Beschreibung muss mindestens ein Wort enthalten. Zur effizienten Nutzung von Ressourcen wird empfohlen, dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} zu verwenden, anstatt für jede Schlüsselwort (keyword) eine neue Anzeigenkopie zu erstellen. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern. Die maximale Eingabelänge des Texts jeder Beschreibung beträgt 1.000 Zeichen, einschließlich dynamischer Textzeichenfolgen, und von diesen 1.000 sind nach der Ersetzung nicht mehr als 90 endgültige Zeichen zulässig. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 90 Zeichen überschreitet, nachdem ein dynamischer Text ersetzt wurde. Für Sprachen mit Zeichen mit doppelter Breite, z. B. traditionellem Chinesisch, beträgt die maximale Eingabelänge 500 Zeichen, einschließlich dynamischer Textzeichenfolgen, und von diesen 500 sind nach der Ersetzung nicht mehr als 45 endgültige Zeichen zulässig. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 45 Zeichen überschreitet, nachdem ein dynamischer Text ersetzt wurde. Die Zeichen mit doppelter Breite werden durch die Zeichen bestimmt, die Sie anstelle des Zeichensatzes der Spracheinstellungen der Kampagne oder Anzeigengruppe verwenden. Zu den Zeichen mit doppelter Breite gehören koreanische, japanische und chinesische Zeichen sowie Emojis. Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten. Hinzufügen: Erforderlich für Multimedia-Anzeigen und Zielgruppenanzeigen. Gilt nicht für Videoanzeigen. Aktualisieren: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie dieses Element festlegen, werden alle Beschreibungen ersetzt, die zuvor mit dieser Anzeige verknüpft waren.	AssetLink-Array
Überschrift	Überschriften sind der prominenteste Text, der in Ihrer Anzeige angezeigt wird, daher sollten Sie die verfügbaren Zeichen optimal nutzen. Wir benötigen mehrere Überschriften, damit die Anzeige flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden kann. 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.	Zeichenfolge
Schlagzeilen	Überschriften sind der prominenteste Text, der in Ihrer Anzeige angezeigt wird, daher sollten Sie die verfügbaren Zeichen optimal nutzen. Wir benötigen mehrere Überschriften, damit die Anzeige flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden kann. Sofern Sie keine der Überschriften an eine bestimmte Position anheften , optimiert Bing das Anzeigenlayout dynamisch mit den besten Überschriften und Beschreibungen für die Suchabfrage des Benutzers. Aus Sicht eines Datenmodells werden die Desriptionen und Überschriften jeweils als Textressourcen gespeichert, d. h. ein TextAsset pro AssetLink. Dasselbe Medienobjekt kann von mehreren Anzeigen verwendet werden. Wenn "Nahtlose Integration" beispielsweise ein Textobjekt ist, weist es für alle Anzeigen im selben Microsoft Advertising-Konto denselben Medienobjektbezeichner auf. Sie müssen zwischen 1 und 15 Überschriften festlegen. Der Text jeder Überschrift muss mindestens ein Wort enthalten. Zur effizienten Nutzung von Ressourcen wird empfohlen, dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} zu verwenden, anstatt für jede Schlüsselwort (keyword) eine neue Anzeigenkopie zu erstellen. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern. Die maximale Eingabelänge des Texts jeder Überschrift beträgt 1.000 Zeichen, einschließlich dynamischer Textzeichenfolgen, und von diesen 1.000 sind nach der Ersetzung nicht mehr als 30 endgültige Zeichen zulässig. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 30 Zeichen überschreitet, nachdem ein dynamischer Text ersetzt wurde. Für Sprachen mit Zeichen mit doppelter Breite, z. B. traditionellem Chinesisch, beträgt die maximale Eingabelänge 500 Zeichen, einschließlich dynamischer Textzeichenfolgen, und von diesen 500 sind nach der Ersetzung nicht mehr als 15 letzte Zeichen zulässig. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 15 Zeichen überschreitet, nachdem ein dynamischer Text ersetzt wurde. Die Zeichen mit doppelter Breite werden durch die Zeichen bestimmt, die Sie anstelle des Zeichensatzes der Spracheinstellungen der Kampagne oder Anzeigengruppe verwenden. Zu den Zeichen mit doppelter Breite gehören koreanische, japanische und chinesische Zeichen sowie Emojis. Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten. Hinzufügen: Erforderlich für Multimedia-Anzeigen und Zielgruppenanzeigen. Gilt nicht für Videoanzeigen. Aktualisieren: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie dieses Element festlegen, werden alle Überschriften ersetzt, die zuvor mit dieser Anzeige verknüpft waren.	AssetLink-Array
Bilder	Bildressourcen mit unterschiedlichen Größen und Seitenverhältnissen, sodass sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können. Schließen Sie mindestens ein AssetLink-Objekt ein, das jeweils ein ImageAsset mit SubType und Zuschneideeinstellungen enthält, die dem gewünschten Seitenverhältnis entsprechen. Weitere Informationen finden Sie in den nachstehenden Hinweisen . Hinzufügen: Erforderlich Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie während des Updates Images einschließen, werden alle zuvor festgelegten Images ersetzt.	AssetLink-Array
ImpressionTrackingUrls	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. 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. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den Wert ImpressionTrackingUrls in das ReturnAdditionalFields-Element ein, wenn Sie die Dienstvorgänge GetAdsByAdGroupId, GetAdsByEditorialStatus und GetAdsByIds aufrufen. Hinzufügen: Optional Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie dieses Element auf ein leeres Zeichenfolgenarray fest, um urLs für die Impressionsnachverfolgung zu entfernen.	Zeichenfolgenarray
LongHeadline	Bei Zielgruppenkampagnen ist LongHeadline die längere von zwei möglichen reaktionsfähigen Anzeigenüberschriften.	AssetLink
LongHeadlines	Sie müssen zwischen 1 und 5 lange Überschriften festlegen. Der Text jeder Überschrift muss mindestens ein Wort enthalten. Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten. Wenn die übergeordnete Kampagne einem Store zugeordnet ist und Sie LongHeadlines angeben, müssen Sie auch Überschriften, Beschreibungen und Bilder angeben. Hinzufügen: Optional, wenn die übergeordnete Kampagne einem Store zugeordnet ist, erforderlich, wenn die übergeordnete Kampagne keinem Store zugeordnet ist. Verwendet LongHeadlineString , wenn leer. Update: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie einen Wert für dieses Element festlegen, werden alle Überschriften ersetzt, die zuvor mit dieser Ressourcengruppe verknüpft waren. Wenn die übergeordnete Kampagne einem Speicher zugeordnet ist und Sie dieses Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.	AssetLink-Array
LongHeadlineString	Überschriften sind der prominenteste Text, der in Ihrer Anzeige angezeigt wird, daher sollten Sie die verfügbaren Zeichen optimal nutzen. Wir benötigen mehrere Überschriften, damit die Anzeige flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden kann. Die Länge der Zeichenfolge ist auf 90 Zeichen beschränkt. Hinzufügen: Optional. Wird ignoriert, wenn LongHeadlines bereitgestellt wird. Wir füllen LongHeadlines mit LongHeadlineString aus, wenn LongHeadlines leer ist. Gilt nicht für Multimediaanzeigen. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
Text	Dieser Text wird je nach Anzeigenplatzierung 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 Multimedia-Anzeigen und Zielgruppenanzeigen. Aktualisieren: Optional für Videoanzeigen. Verwenden Sie stattdessen Beschreibungen für Zielgruppenanzeigen oder Multimediaanzeigen (veraltet).	Zeichenfolge
VerifiedTrackingSettings	VerifiedTrackingSetting bezieht sich auf Die Messeinstellungen von Drittanbietern. Auf diese Weise können Sie Diesbarkeit, Markensicherheit und Ungültige Datenverkehrsmetriken über einen Drittanbieter für die Überprüfung nachverfolgen, z. B. Integral Ad Science. Dieses Feature ist für native, Display- und Online-Videoanzeigen mit der CPM-Gebotsstrategie verfügbar. Hinweis: Derzeit ist IAS der einzige unterstützte Anbieter (vendorName), aber andere Überprüfungsanbieter sind in Kürze verfügbar. Das folgende Beispiel bezieht sich auf IAS. Es gibt drei Schlüssel-Wert-Paare für IAS: "vendorName" "advertiserEntityID" (Client-ID für Ihren Überprüfungsanbieter) "publisherEntityID" (Berichts-ID für Ihren Überprüfungsanbieter) Beispiel (erforderlich für IAS): vendorName: "IAS" advertiserEntityID: "12345678" publisherEntityID: "12345678"	VerifiedTrackingSetting
Videos	Videoressourcen mit unterschiedlichen Größen und Seitenverhältnissen, sodass sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können. Schließen Sie mindestens ein AssetLink-Objekt ein, das jeweils einen VideoAsset mit einem Untertyp enthält. Hinzufügen: Erforderlich für Videoanzeigen Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie während eines Updates Videos einschließen, werden alle zuvor festgelegten Videos ersetzt.	AssetLink-Array

Das ResponsiveAd-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von Ad

Das ResponsiveAd-Objekt wird vom Ad-Objekt abgeleitet und erbt die folgenden Elemente: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Die folgenden Beschreibungen sind spezifisch für ResponsiveAd und gelten möglicherweise nicht für andere Objekte, die die gleichen Elemente vom Ad-Objekt erben.

Element	Beschreibung	Datentyp
AdFormatPreference	Wird für diesen Anzeigentyp nicht unterstützt.	Zeichenfolge
DevicePreference	Wird für diesen Anzeigentyp nicht unterstützt.	Lange
EditorialStatus	Die redaktionelle Überprüfung status der Anzeige, die angibt, ob die Anzeige überprüft, genehmigt oder abgelehnt wurde. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AdEditorialStatus
FinalAppUrls	Wird für diesen Anzeigentyp nicht unterstützt.	AppUrl-Array
FinalMobileUrls	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 FinalUrls und FinalMobileUrls 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. - 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 FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben. – Sie dürfen FinalMobileUrls nicht angeben, wenn die Geräteeinstellung auf "Mobil" festgelegt ist. Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine endgültige mobile 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 Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.	Zeichenfolgenarray
FinalUrls	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 FinalUrls und FinalMobileUrls 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. - 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 FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben. – Sie dürfen FinalMobileUrls nicht angeben, wenn die Geräteeinstellung auf "Mobil" festgelegt ist. Beachten Sie außerdem, dass, wenn das TrackingUrlTemplate - oder UrlCustomParameters-Element dieser Anzeige festgelegt ist, mindestens eine endgültige URL erforderlich ist. Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine endgültige URL angibt. Hinzufügen: Erforderlich Aktualisieren: Optional	Zeichenfolgenarray
FinalUrlSuffix	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 Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.	Zeichenfolge
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner der Anzeige. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich und Read-Only	Lange
Status	Die status der Anzeige. Sie können die Anzeige status auf Aktiv oder Angehalten festlegen. Hinzufügen: Optional Aktualisieren: Optional	AdStatus
TrackingUrlTemplate	Die Nachverfolgungsvorlage, die als Standard für alle Landing Page-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, überschreiben diejenigen, 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 (keyword)- 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 Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.	Zeichenfolge
Typ	Der Typ der Anzeige. Dieser Wert ist ResponsiveAd , wenn Sie eine reaktionsfähige Anzeige abrufen. Weitere Informationen zu Anzeigentypen finden Sie in den Hinweisen zu Ad Data Object.For more information about ad types, see the Ad Data Object Remarks. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AdType
UrlCustomParameters	Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung. Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente . Hinzufügen: Optional Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.	CustomParameters

Hinweise

Das ResponsiveAd-Objekt wird für Multimedia-Anzeigen im Suchnetzwerk und Zielgruppenanzeigen im Microsoft Audience Network verwendet.

Die meisten unterstützten Eigenschaften sind identisch, aber hier sind einige der wichtigsten Unterscheidungsmerkmale.

• Für Zielgruppenanzeigen legen Sie BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines und Descriptions fest.
• Für Multimediaanzeigen legen Sie BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Images und LongHeadlines fest.

Hinweis

Die Daten für Images werden über den AddMedia-Vorgang bereitgestellt. Sie können die MIME-Typen GIF, JPEG oder PNG verwenden. Bilder mit Animation werden nicht unterstützt. Obwohl Sie medien nur mit wenigen Seitenverhältnissen über den AddMedia-Vorgang hinzufügen können, können Sie imageAsset-Zuschneideeinstellungen verwenden, um das effektive Seitenverhältnis im Kontext jeder reaktionsfähigen Anzeige AssetLink zu bestimmen. Das Seitenverhältnis des gespeicherten Bilds bleibt in der Medienbibliothek auf Kontoebene unverändert.

Die maximale Dateigröße beträgt 5 MB. Die maximale Breite und Höhe in Pixel beträgt unabhängig voneinander 2592 und 2048, und Sie müssen weiterhin eines der unterstützten Seitenverhältnisse beibehalten. Wenn das Bildobjekt mit dem Untertyp LandscapeImageMedia beispielsweise 2592 breit ist, muss die Höhe 1357 sein.

Multimedia-Anzeigenbilder

Für Multimediaanzeigen erstellen Sie mehrere Bildobjekte mit unterschiedlichen Größen und Seitenverhältnissen. Sie müssen mindestens ein Bild mit einem Seitenverhältnis von 1,91:1 und ein Bild mit einem Seitenverhältnis von 1:1 hinzufügen.

Schließen Sie im Images-Element mindestens ein AssetLink-Objekt ein . Jede Medienobjektverknüpfung enthält ein ImageAsset , bei dem SubType auf einen der Zeichenfolgenwerte in der folgenden Tabelle festgelegt ist.

Untertyp	Seitenverhältnis	Mindestabmessungen in Pixel
LandscapeImageMedia	1.91:1	703 Breite x 368 Höhe
ImageMedia4x1	4:1	608 Breite x 152 Höhe
SquareImageMedia	1:1	470 Breite x 470 Höhe
ImageMedia1x2	1:2	470 Breite x 940 Höhe

Multimedia-Anzeigenlogos

Für Multimediaanzeigen erstellen Sie mehrere Logoobjekte mit unterschiedlichen Größen, Seitenverhältnissen und Zuschneideeinstellungen, damit sie flexibel in der Miniaturansichtsliste angezeigt werden können.

Untertyp	Seitenverhältnis	Mindestabmessungen in Pixel
SquareImageMedia	1:1	128 Breite x 128 Höhe
ImageMedia4x1	4:1	512 Breite x 128 Höhe

Bilder von Zielgruppenanzeigen

Für Zielgruppenanzeigen erstellen Sie mehrere Bildressourcen mit unterschiedlichen Größen, Seitenverhältnissen und Zuschneideeinstellungen, damit sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können.

Schließen Sie im Images-Element mindestens ein AssetLink-Objekt ein . Jede Medienobjektverknüpfung enthält ein ImageAsset , bei dem SubType auf einen der Zeichenfolgenwerte in der folgenden Tabelle festgelegt ist.

Hinweis

Die Imageuntertypen und in der folgenden Tabelle für Zielgruppenanzeigen Version 2 und befinden sich derzeit im Pilotversuch.

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

Hinweis

Die Bilduntertypen in der folgenden Tabelle gelten für Zielgruppenanzeigen Version 1.

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

Sie müssen nur ein OriginalImage-Standardimageobjekt bereitstellen (das Standardbild war zuvor LandscapeImageMedia). Fügen Sie im Images-Element einen AssetLink ein, der ein ImageAsset enthält, wobei 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.

Beachten Sie folgendes Beispiel für die GetAdsByAdGroupId-Antwort :

• 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.
• Microsoft Advertising verwendet die Zuschneideeinstellungen von OriginalImage 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. Die Zuschneideeinstellungen der automatisch generierten Bildressourcen basieren auf den Zuschneideeinstellungen des OriginalImage-Medienobjektlinks.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13