Freigeben über


CallAdExtension-Datenobjekt – Kampagnenverwaltung

Definiert ein -Objekt, das eine Klick-und-Anruf-Telefonnummer angibt, die in eine Textanzeige aufgenommen werden soll.

Sie können kampagnen im Konto eine Anrufanzeigenerweiterung zuordnen. Jede Entität (Kampagne) kann einer Anrufanzeigenerweiterung zugeordnet werden.

Syntax

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das CallAdExtension-Objekt weist die folgenden Elemente auf: CountryCode, IsCallOnly, IsCallTrackingEnabled, PhoneNumber, RequireTollFreeTrackingNumber.

Element Beschreibung Datentyp
CountryCode Die Landesvorwahl, in der die Telefonnummer registriert ist. Der Ländercode muss einen 2-stell großen Ländercode enthalten. Zu den unterstützten Ländercodewerten gehören AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE und VN.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Zeichenfolge
IsCallOnly Die Option, sowohl Ihre Telefonnummer als auch Ihre Website oder nur Ihre Telefonnummer für Personen anzuzeigen, die Ihre Anzeigen auf einem Smartphone sehen. Möglicherweise möchten Sie nur Ihre Telefonnummer anzeigen, wenn Ihr Unternehmen erfordert, dass Sie mit jedem Kunden sprechen.

Legen Sie diese Eigenschaft auf true fest, wenn die Anzeigenerweiterung nur die Telefonnummer ohne Link zu Ihrer Website anzeigt, und andernfalls, wenn die Anzeigenerweiterung zusätzlich zur Telefonnummer einen Link zu Ihrer Website enthält, legen Sie sie auf false fest.

Hinzufügen: Optional. Wenn Sie dieses Element nicht angeben oder leer lassen, wird der Standardwert false festgelegt, und die Anzeigenerweiterung enthält zusätzlich zur Telefonnummer einen Link zu Ihrer Website.
Aktualisieren: Optional
boolean
IsCallTrackingEnabled Bestimmt, ob die Anrufnachverfolgung für die Anrufanzeigenerweiterung aktiviert ist.

Die Anrufnachverfolgung wird nur im USA und im Vereinigten Königreich unterstützt.

Legen Sie diese Eigenschaft auf true fest, um die Anrufnachverfolgung zu aktivieren, und legen Sie sie andernfalls auf false fest.

Hinzufügen: Optional. Wenn Sie dieses Element nicht angeben oder leer lassen, wird der Standardwert false festgelegt.
Aktualisieren: Optional
boolean
PhoneNumber Die anklickbare Telefonnummer, die in die Anzeige aufgenommen werden soll.

Die Telefonnummer darf maximal 35 Zeichen enthalten und muss für das angegebene Land oder die angegebene Region gültig sein.

Wenn die Kampagne Anruf- und Standortanzeigenerweiterungen enthält, überschreibt diese Telefonnummer die in den Ortsanzeigen-Durchwahlen angegebene Telefonnummer.

Beachten Sie, dass die Telefonnummer möglicherweise neu formatiert wird. Wenn Sie beispielsweise die Telefonnummer auf 4255551212 festlegen, wird sie in (425) 555-1212 neu formatiert.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich
Zeichenfolge
RequireTollFreeTrackingNumber Sie können entweder Ihre eigene Telefonnummer oder eine Microsoft Advertising-Weiterleitungstelefonnummer verwenden. Eine Microsoft Advertising-Weiterleitungstelefonnummer ist eine eindeutige Telefonnummer, die an Ihre geschäftliche Telefonnummer weitergeleitet wird. Mit einer Microsoft Advertising-Weiterleitungsnummer können Sie alle Aufrufe aus Ihrer Anzeige nachverfolgen, sodass Sie die Leistung der Anzeige analysieren können. Dieses Element bestimmt, ob eine gebührenfreie Microsoft Advertising-Weiterleitungstelefonnummer für die Anrufnachverfolgung erstellt werden soll. Dieses Element kann nur festgelegt werden, wenn IsCallTrackingEnabled ebenfalls true ist.

Vor August 2017 konnten Clients diese Eigenschaft auf TRUE festlegen, wenn eine Microsoft Advertising-Weiterleitungstelefonnummer für die Anrufnachverfolgung erstellt werden soll. Seit August 2017 können Kunden keine neue gebührenfreie Microsoft Advertising-Weiterleitungstelefonnummer mehr erstellen. Wenn Sie diesen Wert true festlegen, ist der Vorgang erfolgreich. Es wird jedoch keine gebührenfreie Nummer erstellt, und wenn Sie die Anrufanzeigenerweiterung abrufen, wird diese Eigenschaft auf false festgelegt. Wenn vor August 2017 eine gebührenfreie Weiterleitungsnummer bereitgestellt wurde, ist diese Eigenschaft true , wenn die Nummer beim Abrufen der Anrufanzeigenerweiterung noch aktiv ist.

Hinzufügen: Optional. Wenn Sie dieses Element nicht angeben oder leer lassen, wird der Standardwert false festgelegt.
Aktualisieren: Optional
boolean

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

Geerbte Elemente

Geerbte Elemente von AdExtension

Das CallAdExtension-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 CallAdExtension 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. Lange
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
Lange
Zeitplanung Bestimmt den Kalendertag und die Zeitbereiche, in dem die Anzeigenerweiterung in Anzeigen angezeigt werden kann.

Hinzufügen: Optional
Aktualisieren: Optional. 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 CallAdExtension , wenn Sie eine Anrufanzeigenerweiterung 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: Nicht zulässig
Aktualisieren: Nicht zulässig
int

Anforderungen

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