CombinedList データ オブジェクト - キャンペーン管理
結合リストは、複数の既存の対象ユーザーの組み合わせから作成された対象ユーザーです。
カスタム オーディエンス、顧客リスト、製品の対象ユーザー、類似ユーザー、リマーケティング リストを組み合わせることができます。 他の組み合わせリストや市場内オーディエンスを組み合わせたリストに含めることはできません。
広告アカウントごとに最大 1,000 個の組み合わせリストを作成でき、顧客ごとに最大 5,000 個のリストを作成できます。 各リストには、最大 100 個の組み合わせルールまたは論理条件セットを含めることができます。また、各 CombinationRule には最大 100 個の対象ユーザー ID を含めることができます。
ヒント
対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。
構文
<xs:complexType name="CombinedList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Audience">
<xs:sequence>
<xs:element minOccurs="0" name="CombinationRules" nillable="true" type="tns:ArrayOfCombinationRule" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
要素
CombinedList オブジェクトには、CombinationRules という要素があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| CombinationRules | 結合されたリストに追加するユーザーを決定するために使用される論理条件。 各リストには、最大 100 個の組み合わせルールまたは論理条件セットを含めることができます。また、各 CombinationRule には最大 100 個の対象ユーザー ID を含めることができます。 詳細については、 CombinationRule 解説を参照してください。 足す： 必須 更新： 必須。 前のルールのいずれかを保持する場合は、更新中に明示的に再度設定する必要があります。 |
CombinationRule 配列 |
CombinedList オブジェクトには継承された要素があります。
継承された要素
対象ユーザーから継承された要素
CombinedList オブジェクトは Audience オブジェクトから派生し、AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type の各要素を継承します。 以下の説明は CombinedList に固有であり、 Audience オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| AudienceNetworkSize | 対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 足す： 読み取り専用 更新： 読み取り専用 |
long |
| CustomerShare | この要素は、組み合わされたリスト対象ユーザーではサポートされていません。 足す： サポートされていません 更新： サポートされていません |
CustomerShare |
| 説明 | 対象ユーザーの説明。 説明を使用して、ターゲットとする対象ユーザーを思い出すのに役立ちます。 説明には、最大 1,024 文字を含めることができます。 足す： 随意 更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
| ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、 Audience オブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
| 身分証明書 | 対象ユーザーの Microsoft Advertising 識別子。 足す： 読み取り専用 更新： 必須と読み取り専用 |
long |
| MembershipDuration | この要素は、組み合わされたリスト対象ユーザーではサポートされていません。 足す： サポートされていません 更新： サポートされていません |
int |
| 名前 | 対象ユーザーの名前。 名前には最大 128 文字を使用することができます。 足す： 必須 更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
| ParentId | アカウントまたは顧客の Microsoft Advertising 識別子。 [スコープ] が [アカウント] に設定されている場合、これはアカウント ID、それ以外の場合は顧客 ID です。 足す： 必須 更新： 読み取り専用。 親 ID は変更できません。 |
long |
| 範囲 | スコープは、この対象ユーザーを使用できるアカウントを定義します。 スコープが [アカウント] に設定されている場合、対象ユーザーは、1 つのアカウントのキャンペーンと広告グループにのみ関連付けることができます。つまり、 ParentId を使用します。 スコープが [顧客] に設定されている場合、対象ユーザーは、顧客のすべてのアカウントのキャンペーンと広告グループに関連付けることができます。 足す： 必須 更新： 随意。 スコープを [アカウント] から [顧客] に変更できますが、スコープを [顧客] から [アカウント] に変更することはできません。 |
EntityScope |
| SearchSize | 検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 このプロパティは、対象ユーザーが作成されている間、最大 24 時間空になります (たとえば、組み合わせたリストメンバーシップ期間、ルール、タグ識別子を追加または更新する場合)。 組み合わされたリストに関連付けられている UET タグの状態が [未確認] または [非アクティブ] の場合、組み合わされたリストは、リストを構築するために必要な顧客情報を Web サイトから受け取ることができないため、このプロパティは nil または空になります。 足す： 読み取り専用 更新： 読み取り専用 |
long |
| SupportedCampaignTypes | この対象ユーザーをサポートするキャンペーンの種類の一覧。 サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。 足す： 読み取り専用 更新： 読み取り専用 |
string 配列 |
| 種類 | 対象ユーザーの種類。 この値は、 結合リスト対象 ユーザーを取得する場合の CombinedList です。 対象ユーザーの種類の詳細については、「 対象ユーザー データ オブジェクトの備考」を参照してください。 足す： 読み取り専用 更新： 読み取り専用 |
AudienceType |
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13