CallAdExtension データ オブジェクト - キャンペーン管理

テキスト広告に含めるクリック呼び出し電話番号を指定するオブジェクトを定義します。

通話広告拡張機能は、アカウント内のキャンペーンに関連付けることができます。 各エンティティ (キャンペーン) は、1 つの通話広告拡張機能に関連付けることができます。

構文

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

CallAdExtension オブジェクトには、CountryCode、IsCallOnly、IsCallTrackingEnabled、PhoneNumber、RequireTollFreeTrackingNumber という要素があります。

要素	説明	データ型
CountryCode	電話番号が登録されている国コード。 国コードには、2 文字の国コードが含まれている必要があります。 サポートされている国コードの値には、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 が含まれます。 追加： 必須 更新： 必須	string
IsCallOnly	スマートフォンで広告を見ているユーザーに、電話番号と Web サイトの両方、または電話番号のみを表示するオプション。 ビジネスで各顧客と話す必要がある場合は、電話番号のみを表示できます。 広告拡張機能に Web サイトへのリンクのない電話番号のみを表示する場合は true に設定し、それ以外の場合は、電話番号に加えて Web サイトへのリンクを false に設定する場合は、このプロパティを true に設定します。 追加： オプション。 この要素を指定しない場合、または空のままにした場合、既定値は false に設定され、広告拡張機能には電話番号に加えて Web サイトへのリンクが含まれます。 更新： オプション	boolean
IsCallTrackingEnabled	通話広告拡張機能に対して通話追跡が有効かどうかを判断します。 通話追跡は、米国と英国でのみサポートされています。 呼び出しの追跡を有効にするには、このプロパティを true に設定し、それ以外の場合は false に設定 します。 追加： オプション。 この要素を指定しない場合、または空のままにすると、既定値の false が設定されます。 更新： オプション	boolean
PhoneNumber	広告に含めるクリック可能な電話番号。 電話番号には最大 35 文字を含めることができます。指定した国または地域で有効である必要があります。 キャンペーンに通話と位置情報の広告表示オプションが含まれている場合、この電話番号は、位置情報広告表示オプションで指定された電話番号よりも優先されます。 電話番号は再フォーマットされる可能性があることに注意してください。 たとえば、電話番号を 4255551212 に設定すると、(425) 555-1212 に再フォーマットされます。 追加： 必須 更新： 必須	string
RequireTollFreeTrackingNumber	自分の電話番号を使用することも、Microsoft Advertising の転送電話番号を使用することもできます。 Microsoft Advertising 転送電話番号は、ビジネス電話番号にルーティングされる一意の電話番号です。 Microsoft Advertising 転送番号を使用すると、広告からのすべての通話を追跡して、広告のパフォーマンスを分析できます。 この要素は、通話追跡のためにフリーダイヤルの Microsoft Advertising 転送電話番号を作成するかどうかを決定します。 この要素は、 IsCallTrackingEnabled も true の場合にのみ設定できます。 2017 年 8 月より前は、通話追跡のために Microsoft Advertising 転送電話番号を作成する必要がある場合、クライアントはこのプロパティを true に 設定できました。 2017 年 8 月以降、クライアントは新しい無料の Microsoft Advertising 転送電話番号を作成できなくなります。 この値を true に 設定すると、操作は成功します。ただし、フリーダイヤル番号は作成されず、通話広告拡張機能を取得すると、このプロパティは false に設定されます。 2017 年 8 月より前にフリーダイヤル転送番号がプロビジョニングされた場合、通話広告拡張機能を取得するときに番号がまだアクティブな場合、このプロパティは true になります。 追加： オプション。 この要素を指定しない場合、または空のままにすると、既定値の false が設定されます。 更新： オプション	boolean

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

継承された要素

AdExtension から継承された要素

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

要素	説明	データ型
DevicePreference	この広告拡張機能の種類ではサポートされていません。	long
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 現在、 AdExtension オブジェクトの前方互換性の変更はありません。 追加： 読み 取り 専用 更新： 読み 取り 専用	KeyValuePairOfstring 配列
Id	広告拡張機能の一意の Microsoft Advertising 識別子。 追加： 読み 取り 専用 更新： 読み取り専用と必須	long
スケジュール設定	広告表示オプションが広告に表示される資格があるカレンダーの曜日と時刻の範囲を決定します。 追加： オプション 更新： オプション。 この要素を null に設定した場合、広告拡張機能の既存のスケジュール 設定は変更されません。 これを null 以外の Schedule オブジェクトに設定すると、広告拡張機能の既存のスケジュール設定を実質的に置き換えます。 すべてのスケジュールを削除するには、この要素を空の Schedule オブジェクトに設定します。	Schedule
Status	広告拡張機能の状態。 キャンペーン管理サービスでは削除された広告表示オプションが返されないため、値は常に アクティブ になります。 追加： 読み 取り 専用 更新： 読み 取り 専用	AdExtensionStatus
型	広告拡張機能の種類。 この値は、通話広告拡張機能を取得するときの CallAdExtension です。 追加： 読み 取り 専用 更新： 読み 取り 専用 広告拡張機能の種類の詳細については、「 広告拡張機能データ オブジェクトの備考」を参照してください。	string
バージョン	広告拡張機能が更新された回数を追跡します。 バージョンは、広告拡張機能の作成時に 1 に設定され、更新のたびに 1 ずつインクリメントされます。 追加： 許可されていません 更新： 許可されていません	int

要件

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