LocationAdExtension-Datenobjekt – Kampagnenverwaltung

Artikel
07/19/2024

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.

Syntax

<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: Nicht zulässig Aktualisieren: Nicht zulässig	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: Optional Aktualisieren: Optional	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: Optional Aktualisieren: Optional. 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.	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 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: Nicht zulässig Aktualisieren: Nicht zulässig	int

Anforderungen

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

Freigeben über