Freigeben über

VideoAdExtension-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Anzeigenerweiterung mit einem Video und einer Handlungsanrufschaltfläche.

<xs:complexType name="VideoAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AlternativeText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q66="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q66:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q67="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q67:ArrayOfstring" />
        <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ThumbnailId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="ThumbnailUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <xs:element minOccurs="0" name="VideoId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das VideoAdExtension-Objekt verfügt über die folgenden Elemente: ActionText, AlternativeText, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Name, ThumbnailId, ThumbnailUrl, TrackingUrlTemplate, UrlCustomParameters, VideoId.

Element Beschreibung Datentyp
ActionText Der Aktionstext für die Videoressource. Zeichenfolge
AlternativeText Der Alternativtext für die Videoressource. Zeichenfolge
DisplayText Der Anzeigetext für das Videoobjekt. Zeichenfolge
FinalAppUrls Zur zukünftigen Verwendung. AppUrl-Array
FinalMobileUrls 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 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 Listenelemente für potenzielle Vorwärtskompatibilität.
- 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 DevicePreference auf 30001 (mobil) festgelegt ist.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird die vorherige Einstellung entfernt.		 Zeichenfolgenarray
FinalUrls 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 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 Listenelemente für potenzielle Vorwärtskompatibilität.
- 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 DevicePreference auf 30001 (mobil) festgelegt ist.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird die vorherige Einstellung entfernt.		 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.

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: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird die vorherige Einstellung entfernt.		 Zeichenfolge
Name Der Name des Videomedienobjekts. Zeichenfolge
ThumbnailId Die ID des Miniaturbildobjekts. lang
ThumbnailUrl Die Miniaturansichts-URL des Videoobjekts.

Hinzufügen: Nicht unterstützt
Update: Nicht unterstützt		 Zeichenfolge
TrackingUrlTemplate Die Nachverfolgungsvorlage, die als Standard für alle FinalUrls und FinalMobileUrls 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: Wahlfrei
Aktualisieren: Wahlfrei. Wenn Sie dieses Element null festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge
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 . 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.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn Sie dieses Element null festlegen, wird die vorherige Einstellung gelöscht.		 CustomParameters
VideoId Die ID des Videos. lang

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

Geerbte Elemente

Geerbte Elemente von AdExtension

Das VideoAdExtension-Objekt wird vom AdExtension-Objekt abgeleitet und erbt die folgenden Elemente: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. Die folgenden Beschreibungen sind spezifisch für VideoAdExtension und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom AdExtension-Objekt erben .

Element Beschreibung Datentyp
DevicePreference Dieses Element bestimmt, ob die Anzeigeerweiterung auf mobilen Oder allen Geräten angezeigt werden soll.

Um eine Einstellung für mobile Geräte anzugeben, legen Sie dieses Element auf 30001 fest.

Um alle Geräte anzugeben, legen Sie dieses Element auf 0 (null) fest, oder lassen Sie das Element null. Standardmäßig ist dieses Element null.

Dieses Element gilt nur für die Typen AppAdExtension und SitelinkAdExtension .		 lang
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 Anzeigenerweiterung. lang
Zeitplanung Bestimmt den Kalendertag und die Zeitbereiche, in dem die Anzeigenerweiterung in Anzeigen angezeigt werden kann. Schedule
Status Der status der Anzeigenerweiterung. Der Wert ist immer Aktiv , da der Kampagnenverwaltungsdienst keine gelöschten Anzeigenerweiterungen zurückgibt. AdExtensionStatus
Typ Der Typ der Anzeigenerweiterung.

Weitere Informationen finden Sie unter Hinweise.		 Zeichenfolge
Version Verfolgt nach, wie oft die Anzeigenerweiterung aktualisiert wurde.

Die Version wird beim Erstellen der Anzeigenerweiterung auf 1 festgelegt und nach jedem Update um eins erhöht.		 int

Anforderungen

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