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 広告に含めるビジネス電話番号。 電話番号は、ハイファイモバイルデバイスでクリックできます。

電話番号には最大 35 文字を含めることができます。指定した国または地域で有効である必要があります。

キャンペーンに通話拡張機能も含まれている場合、通話拡張機能の電話番号は、この電話番号をオーバーライドします。

追加： オプション
更新： オプション。 この要素を null に設定すると、前の設定が削除されます。		 string

LocationAdExtension オブジェクトには継承された要素があります。

継承された要素

AdExtension から継承された要素

LocationAdExtension オブジェクトは AdExtension オブジェクトから派生し、DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version の各要素を継承します。 以下の説明は LocationAdExtension に固有であり、 AdExtension オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
DevicePreference この広告拡張機能の種類ではサポートされていません。 long
ForwardCompatibilityMap 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。

現在、 AdExtension オブジェクトの前方互換性の変更はありません。

追加： 読み 取り 専用
更新： 読み 取り 専用		 KeyValuePairOfstring 配列
Id 広告拡張機能の一意の Microsoft Advertising 識別子。

追加： 読み 取り 専用
更新： 読み取り専用と必須		 long
スケジュール設定 広告表示オプションが広告に表示される資格があるカレンダーの曜日と時刻の範囲を決定します。

追加： オプション
更新： オプション。 この要素を null に設定した場合、広告拡張機能の既存のスケジュール 設定は変更されません。 これを null 以外の Schedule オブジェクトに設定すると、広告拡張機能の既存のスケジュール設定を実質的に置き換えます。 すべてのスケジュールを削除するには、この要素を空の Schedule オブジェクトに設定します。		 Schedule
Status 広告拡張機能の状態。 キャンペーン管理サービスでは削除された広告表示オプションが返されないため、値は常に アクティブ になります。

追加： 読み 取り 専用
更新： 読み 取り 専用		 AdExtensionStatus
型 広告拡張機能の種類。 この値は、位置情報広告拡張機能を取得するときの LocationAdExtension です。

追加： 読み 取り 専用
更新： 読み 取り 専用

広告拡張機能の種類の詳細については、「 広告拡張機能データ オブジェクトの備考」を参照してください。		 string
バージョン 広告拡張機能が更新された回数を追跡します。

バージョンは、広告拡張機能の作成時に 1 に設定され、更新のたびに 1 ずつインクリメントされます。

追加： 許可されていません
更新： 許可されていません		 int

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13