CustomAudience データ オブジェクト - キャンペーン管理
カスタム対象ユーザーを定義します。
注:
[名前] と [説明] の更新のみがサポートされます。 Bing広告 API を使用してカスタム対象ユーザーを削除することはできますが、追加することはできません。 そうは言っても、カスタム対象ユーザーの関連付けと除外を追加および削除できます。
カスタム オーディエンスは、独自の顧客データを使用して、より豊富なユーザー セグメントを作成することによって生成されるリマーケティング リストの一種です。 カスタム オーディエンスは、通常、データ管理プロバイダー (DMP) を通じて、リマーケティング リストと組み合わせて使用できます。 DMP がカスタムオーディエンス機能に接続すると、カスタムオーディエンスを Microsoft 広告にインポートして検索リマーケティングを行うことができます。 カスタム オーディエンスはリマーケティングとは別に使用でき、UET は必要ありません。
ヒント
カスタム 対象ユーザーの概要については、「 カスタム 対象ユーザー について」のヘルプ トピックを参照してください。
構文
<xs:complexType name="CustomAudience" 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>
要素
CustomAudience オブジェクトには継承された要素があります。
継承された要素
対象ユーザーから継承された要素
CustomAudience オブジェクトは Audience オブジェクトから派生し、AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type という要素を継承します。 以下の説明は CustomAudience に固有であり、 Audience オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。
要素 | 説明 | データ型 |
---|---|---|
AudienceNetworkSize | 対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 追加: サポートされていません 更新: 読み 取り 専用 |
long |
CustomerShare | この要素は、カスタム 対象ユーザーではサポートされていません。 追加: サポートされていません 更新: サポートされていません |
CustomerShare |
説明 | 対象ユーザーの説明。 説明を使用して、ターゲットとする対象ユーザーを思い出すのに役立ちます。 説明には、最大 1,024 文字を含めることができます。 追加: サポートされていません 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 前の設定を削除するには、この elemment を空の文字列値 ("") に設定します。 |
string |
ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、 Audience オブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
Id | 対象ユーザーの Microsoft Advertising 識別子。 追加: サポートされていません 更新: 必須と読み取り専用 |
long |
MembershipDuration | メンバーシップ期間は、ユーザーをリストに追加するために、Microsoft Advertising がカスタム対象ユーザー定義に一致するアクションを検索する必要がある期間を決定します。 カスタム対象ユーザーの場合、Microsoft Advertising Web アプリケーションではメンバーシップ期間が設定されず、Microsoft Advertising ではカスタム対象ユーザー プロバイダーの設定が延期されます。 Bing広告 API を使用してカスタム対象ユーザーを要求すると、返されるメンバーシップ期間は null になります。 追加: サポートされていません 更新: サポートされていません |
int |
名前 | 対象ユーザーの名前。 名前には最大 128 文字を使用することができます。 追加: サポートされていません 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
ParentId | カスタム対象ユーザーを含む顧客の Microsoft Advertising 識別子。 追加: サポートされていません 更新: サポートされていません |
long |
範囲 | スコープは、この対象ユーザーを使用できるアカウントを定義します。 カスタム対象ユーザーの場合、サポートされている範囲は Customer のみであり、対象ユーザーは顧客のすべてのアカウントのキャンペーンや広告グループに関連付けることができます。 追加: サポートされていません 更新: サポートされていません |
EntityScope |
SearchSize | 検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 このプロパティは、対象ユーザーの作成中に最大 24 時間空になります。たとえば、DMP から新しいカスタム 対象ユーザーをインポートした場合、対象ユーザーの作成には 24 時間かかり、その間、このプロパティは nil または empty になります。 追加: サポートされていません 更新: 読み 取り 専用 |
long |
SupportedCampaignTypes | この対象ユーザーをサポートするキャンペーンの種類の一覧。 サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。 追加: サポートされていません 更新: 読み 取り 専用 |
string 配列 |
型 | 対象ユーザーの種類。 カスタム対象 ユーザーを取得 する場合、この値は Custom です。 対象ユーザーの種類の詳細については、「 対象ユーザー データ オブジェクトの備考」を参照してください。 追加: サポートされていません 更新: 読み 取り 専用 |
AudienceType |
要件
サービス: CampaignManagementService.svc v13
名前 空間: https://bingads.microsoft.com/CampaignManagement/v13