CalloutAdExtension-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert ein -Objekt, das zusätzlichen Text zu Ihrem Unternehmen, Ihren Produkten oder Diensten angibt, der in eine Textanzeige aufgenommen werden soll.

Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine App-Anzeigenerweiterung zuordnen. Sie müssen pro Entität (Konto, Kampagne oder Anzeigengruppe) 2 bis 20 Legendenanzeigenerweiterungen zuordnen. Wenn Sie Ihrem Konto, Ihrer Kampagne oder Anzeigengruppe eine oder weniger Legendenerweiterungen zuordnen, wird für Ihre Anzeige kein Beschriftungstext angezeigt. Eine Anzeige kann zwischen 2 und 4 Legenden pro Impression enthalten.

Anzeigenerweiterungen, die auf Anzeigengruppenebene zugeordnet sind, überschreiben Anzeigenerweiterungen desselben Typs, die auf Kampagnenebene zugeordnet sind. Wenn Sie beispielsweise zwei Beschriftungserweiterungen für Kampagne A festgelegt haben, keine Legendenerweiterungen, die der Anzeigengruppe AA zugeordnet sind, und eine Beschriftungserweiterung, die Ad Group AB zugeordnet ist, ist nur Ad Group AA berechtigt, ihre Textanzeigen mit Legenden zu versehen.

<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "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": "CalloutAdExtension",
  "Version": IntValueHere,
  "Text": "ValueHere"
}

Elemente

Das CalloutAdExtension-Objekt weist die folgenden Elemente auf: Text.

Element	Beschreibung	Datentyp
Text	Zusätzlicher Beschriftungstext zu Ihrem Unternehmen, Produkten oder Diensten, der in eine Textanzeige aufgenommen werden soll. Der Text der Beschriftungserweiterung muss sich vom Text Ihrer Anzeige unterscheiden. Die Länge dieser Zeichenfolge muss zwischen 1 und 25 Zeichen betragen. Beachten Sie, dass für traditionelle chinesische Zeichen die Länge dieser Zeichenfolge zwischen 1 und 12 Zeichen betragen muss. Hinzufügen: Erforderlich Aktualisieren: Erforderlich	Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von AdExtension

Das CalloutAdExtension-Objekt wird vom AdExtension-Objekt abgeleitet und erbt die folgenden Elemente: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Die folgenden Beschreibungen gelten spezifisch für CalloutAdExtension 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 CalloutAdExtension , wenn Sie eine Legendenanzeigenerweiterung 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

Freigeben über