StructuredSnippetAdExtension-Datenobjekt – Kampagnenverwaltung

Definiert ein Objekt, das einen Header mit 3 bis 10 Codeausschnittwerten koppelt, die Kunden mehr über Ihr Unternehmen informieren.

Im folgenden Beispiel ist Courses der Header, und .NET, Java, Python und PHP sind Beispiele für einzelne Werte.

Kurse: .NET, Java, Python, PHP

Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine Erweiterung für strukturierte Ausschnittanzeigen zuordnen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann bis zu 20 strukturierten Codeausschnitt-Anzeigenerweiterungen zugeordnet werden. Eine erweiterte Textanzeige enthält nur einen strukturierten Codeausschnitt (eine Überschrift mit 3 - 10 Werten) pro Impression.

XML

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q54="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q54:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

JSON

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "StructuredSnippetAdExtension",
  "Version": IntValueHere,
  "Header": "ValueHere",
  "Values": [
    "ValueHere"
  ]
}

Elemente

Das StructuredSnippetAdExtension-Objekt weist die folgenden Elemente auf: Header, Werte.

Element	Beschreibung	Datentyp
Kopfzeile	Der Header, der mit einem Doppelpunkt (:) angefügt wird und den Codeausschnittwerten vorangestellt ist. Strukturierte Codeausschnittheader müssen in derselben Sprache angegeben werden, in der sie angezeigt werden sollen. Wenn Sie beispielsweise den Header Annehmlichkeiten in englischer Sprache verwenden möchten, müssen Sie den Header als Annehmlichkeiten angeben. Wenn Sie die Kopfzeile Ausstattung in Deutsch verwenden möchten, müssen Sie den Header Ausstattungangeben. Eine Liste der unterstützten Header pro Sprache finden Sie unter Ad Extension Header Languages( Ad Extension Header Languages). Hinzufügen: Erforderlich Aktualisieren: Erforderlich	Zeichenfolge
Werte	Die Codeausschnittwerte, die nach der Headerkomponente der angezeigten Anzeige folgen. Jeder ausgewählte Textwert kann maximal 25 Zeichen lang sein. Beachten Sie, dass für traditionelle Chinesische Zeichen jeder Wert eine maximale Länge von 12 Zeichen haben kann. Hinzufügen: Erforderlich Aktualisieren: Erforderlich	Zeichenfolgenarray

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

Geerbte Elemente

Geerbte Elemente von AdExtension

Das StructuredSnippetAdExtension-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 StructuredSnippetAdExtension und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom AdExtension-Objekt erben .

Element	Beschreibung	Datentyp
DevicePreference	Wird für diesen Anzeigenerweiterungstyp nicht unterstützt.	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. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für das AdExtension-Objekt . Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner der Anzeigenerweiterung. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt und erforderlich	lang
Zeitplanung	Bestimmt den Kalendertag und die Zeitbereiche, in dem die Anzeigenerweiterung in Anzeigen angezeigt werden kann. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn Sie dieses Element null festlegen, bleiben alle vorhandenen Zeitplanungssätze für die Anzeigenerweiterung unverändert. Wenn Sie dieses Objekt auf ein Schedule-Objekt ungleich NULL festlegen, ersetzen Sie effektiv vorhandene Planungseinstellungen für die Anzeigenerweiterung. Um alle Zeitplanungen zu entfernen, legen Sie dieses Element auf ein leeres Schedule-Objekt fest.	Schedule
Status	Der status der Anzeigenerweiterung. Der Wert ist immer Aktiv , da der Kampagnenverwaltungsdienst keine gelöschten Anzeigenerweiterungen zurückgibt. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AdExtensionStatus
Typ	Der Typ der Anzeigenerweiterung. Dieser Wert ist StructuredSnippetAdExtension , wenn Sie eine Erweiterung für strukturierte Codeausschnittanzeigen abrufen. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt Weitere Informationen zu Anzeigenerweiterungstypen finden Sie in den Hinweisen zu Ad Extension Data Object.	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. Hinzufügen: Unstatthaft Aktualisieren: Unstatthaft	int

Anforderungen

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