InMarketAudience データ オブジェクト - キャンペーン管理
市場の対象ユーザーを定義します。
注:
Bing広告 API を使用して、市場内オーディエンスを追加、更新、または削除することはできません。 とはいえ、市場内の対象ユーザーの関連付けと除外を追加および削除できます。
Bing広告 API は、現在アクティブな市場内のすべての対象ユーザーを常に返します。 サービスは、削除された市場の対象ユーザーや、変更された内容を確認するための差分ダウンロードを返しません。
Bing広告 API を介して返される市場内オーディエンスは、AU、CA、DE、FR、英国、米国など、すべての市場で利用可能なすべての市場内オーディエンスの和集合です。 AudienceNetworkSize と SearchSize は、対応するネットワーク内の特定の市場の対象ユーザーに対してサポートされているすべての市場のリスト サイズの合計です。 Bing Ads API では、市場ごとのリスト サイズの詳細は提供されません。 たとえば、Bing広告 API を使用して、検索ネットワーク内の "広告とマーケティング" の市場内オーディエンス サイズが17070879 (17.1M) として返される場合があります。 Microsoft Advertising Web アプリケーションに表示される市場ごとの内訳は、米国では 2.88M です。AU では 474K。英国では 13.7M。
サンドボックスの市場の対象ユーザーに依存関係を持ち込むべきではありません。 市場内の一部の対象ユーザーはサンドボックスで利用できますが、運用環境では使用できません。 また、市場内の対象ユーザーのプロパティ値は、サンドボックスと運用環境 (対象ユーザーの名前とサイズなど) によっても異なる場合があります。
注:
この機能は、オーストラリア、カナダ、フランス、ドイツ、イギリス、米国で利用できます。
ヒント
市場内対象ユーザーの概要については、「市場の対象 ユーザー について」のヘルプ トピックを参照してください。
構文
<xs:complexType name="InMarketAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Audience">
<xs:sequence />
</xs:extension>
</xs:complexContent>
</xs:complexType>
要素
InMarketAudience オブジェクトには継承された要素があります。
継承された要素
対象ユーザーから継承された要素
InMarketAudience オブジェクトは Audience オブジェクトから派生し、AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type の各要素を継承します。 以下の説明は InMarketAudience に固有であり、 Audience オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| AudienceNetworkSize | 対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。 追加： サポートされていません 更新： サポートされていません |
long |
| CustomerShare | この要素は、市場の対象ユーザーにはサポートされていません。 追加： サポートされていません 更新： サポートされていません |
CustomerShare |
| 説明 | 対象ユーザーの説明。 説明を使用して、ターゲットとする対象ユーザーを思い出すのに役立ちます。 説明には、最大 1,024 文字を含めることができます。 追加： サポートされていません 更新： サポートされていません |
string |
| ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、 Audience オブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
| Id | 対象ユーザーの Microsoft Advertising 識別子。 追加： サポートされていません 更新： サポートされていません |
long |
| MembershipDuration | 対象ユーザーを作成するときに、Microsoft Advertising が対象ユーザーの定義に一致するアクションを検索する必要がある時間を、どの程度前から検索するかを指定できます。 mimimum 期間は 1 日で、許可される最大期間は 180 日です。 追加： サポートされていません 更新： サポートされていません |
int |
| 名前 | 対象ユーザーの名前。 名前には最大 128 文字を使用することができます。 追加： サポートされていません 更新： サポートされていません |
string |
| ParentId | 市場の対象ユーザーを含む顧客の Microsoft Advertising 識別子。 追加： サポートされていません 更新： サポートされていません |
long |
| 範囲 | スコープは、この対象ユーザーを使用できるアカウントを定義します。 市場内の対象ユーザーの場合、サポートされている範囲は [顧客] のみです。対象ユーザーは、顧客のすべてのアカウントのキャンペーンや広告グループに関連付けることができます。 追加： サポートされていません 更新： サポートされていません |
EntityScope |
| SearchSize | 検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。 追加： サポートされていません 更新： サポートされていません |
long |
| SupportedCampaignTypes | この対象ユーザーをサポートするキャンペーンの種類の一覧。 サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。 追加： サポートされていません 更新： サポートされていません |
string 配列 |
| 型 | 対象ユーザーの種類。 この値は、市場内の対象ユーザーを取得する場合の InMarket です。 対象ユーザーの種類の詳細については、「 対象ユーザー データ オブジェクトの備考」を参照してください。 追加： サポートされていません 更新： サポートされていません |
AudienceType |
要件
サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13