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 Advertising 識別碼。 添加： 唯讀 更新： 唯讀和必要	長
排程	決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。 添加： 選 更新： 選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此專案設定為空的 Schedule 物件。	Schedule
狀態	廣告延伸模組的狀態。 此值一律為 [作用 中]，因為行銷活動管理服務不會傳回已刪除的廣告延伸模組。 添加： 唯讀 更新： 唯讀	AdExtensionStatus
類型	廣告延伸模組的類型。 當您擷取位置廣告延伸模組時，此值為 LocationAdExtension 。 添加： 唯讀 更新： 唯讀 如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組資料物件備註。	string
版本	追蹤廣告延伸模組更新的次數。 建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。 添加： 不允許 更新： 不允許	int

需求

服務： CampaignManagementService.svc v13
命名 空間： https://bingads.microsoft.com/CampaignManagement/v13