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 配列
Id	対象ユーザーの 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
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13