共用方式為

LocationAdExtension 數據物件 - 營銷活動管理

  • 發行項

定義廣告延伸模組，指定要包含在文字廣告中的商務地址和電話號碼。

您可以將位置廣告延伸模組與帳戶或帳戶中的營銷活動建立關聯。 每個實體 (帳戶或營銷活動) 可以與您決定的位置廣告延伸模組建立關聯，最多可達您帳戶中的位置廣告延伸模組總數。

語法

<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>

元素

LocationAdExtension 物件具有下列元素：Address、CompanyName、GeoCodeStatus、GeoPoint、PhoneNumber。

元素 描述 資料類型
地址 商務位址。

支援的國碼值包括 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 和 VN。

加： 必填
更新： 必填		 Address
CompanyName 企業名稱。 名稱最多可以包含80個字元。

加： 必填
更新： 必填		 string
GeoCodeStatus 狀態值，指出是否已判斷商務緯度和經度座標。

如果您提供座標，狀態會設定為 [完成];否則，狀態會指出判斷指定之商務位址座標的進度。

加： 不允許
更新： 不允許		 BusinessGeoCodeStatus
GeoPoint 指定之 Address 元素的緯度和經度座標。 當使用者按兩下廣告上的位址時，座標會用來標示 Bing 地圖服務 上的商務位置。 如果指定的座標不在有效值的範圍內，服務會根據位址決定座標。

如果您指定已知的座標，服務不會確認指定的座標是否符合指定的商務位址。 如果您未提供座標， AddAdExtensions 作業會使用商務地址來判斷座標。

新增超過10個位置廣告延伸模組時，服務會脫機解析座標，否則會在服務作業執行期間預先解析座標。 在決定座標之前，將不會在廣告中使用位置，這可能需要幾秒到幾分鐘的時間，視新增的位置廣告延伸模組數目和目前的需求而定。

若要判斷座標是否已解析，請呼叫 GetAdExtensionsByIds 作業並存取 GeoCodeStatus 元素。 如需可能狀態值的清單，請 參閱 BusinessGeoCodeStatus。

加： 自選
更新： 自選		 GeoPoint
PhoneNumber 要包含在廣告中的商務電話號碼。 電話號碼可在Hi-Fi行動裝置上按一下。

電話號碼最多可以包含 35 個字元，而且必須對指定的國家或地區有效。

如果營銷活動也包含通話擴充功能，則通話擴充功能中的電話號碼將會覆寫此電話號碼。

加： 自選
更新： 自選。 如果您將此元素設定為 null，則會刪除先前的設定。		 string

LocationAdExtension 物件具有 Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

LocationAdExtension 物件衍生自 AdExtension 物件，並繼承下列元素：DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version。 下列描述專屬於 LocationAdExtension，而且可能不適用於從 AdExtension 對象繼承相同元素的其他物件。

元素 描述 資料類型
DevicePreference 不支援此廣告延伸模組類型。 長
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

AdExtension 物件目前沒有向前相容性變更。

加： 唯讀
更新： 唯讀		 KeyValuePairOfstringstring 陣 列
標識碼 廣告擴充功能的唯Microsoft廣告標識碼。

加： 唯讀
更新： 唯讀和必要		 長
排程 決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。

加： 自選
更新： 自選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此項目設定為空的 Schedule 物件。		 Schedule
地位 廣告延伸模組的狀態。 此值一律為 [作用 中]，因為營銷活動管理服務不會傳回已刪除的廣告延伸模組。

加： 唯讀
更新： 唯讀		 AdExtensionStatus
類型 廣告延伸模組的類型。 當您擷取位置廣告延伸模組時，此值為 LocationAdExtension 。

加： 唯讀
更新： 唯讀

如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組數據物件備註。		 string
版本 追蹤廣告延伸模組更新的次數。

建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。

加： 不允許
更新： 不允許		 int

需求

服務： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13