Freigeben über

LocationAdExtension-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Anzeigenerweiterung, die eine Geschäftsadresse und Telefonnummer angibt, die in eine Textanzeige aufgenommen werden soll.

Sie können dem Konto oder Kampagnen im Konto eine Erweiterung für Standortanzeigen zuordnen. Jede Entität (Konto oder Kampagne) kann beliebig vielen Standortanzeigeerweiterungen zugeordnet werden, bis zur Gesamtzahl der Standortanzeigeerweiterungen in Ihrem Konto.

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das LocationAdExtension-Objekt weist die folgenden Elemente auf: Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Element Beschreibung Datentyp
Adresse Die Geschäftsadresse.

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		 Adresse
CompanyName Der Name des Unternehmens. Der Name darf maximal 80 Zeichen enthalten.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Zeichenfolge
GeoCodeStatus Ein status Wert, der angibt, ob die Koordinaten des Breiten- und Längengrads des Unternehmens bestimmt wurden.

Wenn Sie die Koordinaten angeben, wird die status auf Abgeschlossen festgelegt. Andernfalls gibt der status den Fortschritt der Bestimmung der Koordinaten der angegebenen Geschäftsadresse an.

Hinzufügen: Unstatthaft
Aktualisieren: Unstatthaft		 BusinessGeoCodeStatus
GeoPoint Die Breiten- und Längengradkoordinaten des angegebenen Address-Elements . Die Koordinaten werden verwendet, um den Geschäftsstandort auf Bing Karten zu markieren, wenn der Benutzer auf die Adresse in der Anzeige klickt. Wenn die angegebenen Koordinaten nicht innerhalb des Gültigen Wertebereichs liegen, bestimmt der Dienst die Koordinaten basierend auf der Adresse.

Wenn Sie die bekannten Koordinaten angeben, bestätigt der Dienst nicht, ob die angegebenen Koordinaten mit der angegebenen Geschäftsadresse übereinstimmen. Wenn Sie die Koordinaten nicht angeben, verwendet der AddAdExtensions-Vorgang die Geschäftsadresse, um die Koordinaten zu bestimmen.

Beim Hinzufügen von mehr als 10 Standortanzeigeerweiterungen löst der Dienst Koordinaten offline auf und löst koordinaten während der Ausführung des Dienstvorgangs im Voraus auf. Der Standort wird erst in einer Anzeige verwendet, wenn die Koordinaten bestimmt sind. Dies kann je nach Anzahl der hinzugefügten Standortanzeigenerweiterungen und der aktuellen Nachfrage von Sekunden bis Minuten dauern.

Um zu bestimmen, ob die Koordinaten aufgelöst wurden, rufen Sie den GetAdExtensionsByIds-Vorgang auf, und greifen Sie auf das GeoCodeStatus-Element zu. Eine Liste der möglichen status Werte finden Sie unter BusinessGeoCodeStatus.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 GeoPoint
PhoneNumber Die geschäftliche Telefonnummer, die in die Anzeige aufgenommen werden soll. Die Telefonnummer kann auf Hi-Fi-Mobilgeräten geklickt werden.

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

Wenn die Kampagne auch eine Durchwahl enthält, überschreibt die Telefonnummer in der Durchwahl diese Telefonnummer.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn Sie dieses Element null festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von AdExtension

Das LocationAdExtension-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 LocationAdExtension 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 LocationAdExtension , wenn Sie eine Standortanzeigenerweiterung 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