顧客リスト レコード - 一括

一括ファイルでダウンロードおよびアップロードできる顧客リストを定義します。

顧客リストは、顧客の一致を有効にするためにコンパイルした顧客連絡先情報のセットです。 各リストには、複数のEmail項目を含めることができます。

• 一括アップロード ファイルに 顧客リスト レコードを含め、アクション の種類 フィールドを "追加"、"削除"、または "置換" に設定します。
• 同じ一括アップロード ファイルに 1 つ以上の Customer List Item レコードを含め、[ 親 ID]、[ サブタイプ]、[ テキスト] フィールドを設定します。

同じ一括アップロード ファイルに顧客リスト アイテム レコードを含めずに顧客リスト レコードを追加または更新できます。ただし、関連する親顧客リスト レコードなしでは、顧客リストアイテムレコードをアップロードすることはできません。

48 時間後に、[対象ユーザーのサイズ] フィールド (オーディエンス検索サイズなど) をチェックして、Bing ネットワークで一致した顧客の数を確認します。 その時点で、この新しい対象ユーザーに対して広告の表示を開始できます。

アカウント内のすべての顧客リスト レコードをダウンロードできます。これには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に CustomerLists の DownloadEntity 値を含めることができます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、新しい顧客リストを追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add

Customer List レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

• アクションの種類
• Audience
• 対象ユーザーのネットワーク サイズ
• 対象ユーザーの検索サイズ
• クライアント ID
• 説明
• Id
• メンバーシップ期間
• 変更時刻
• Parent Id
• スコープ
• 状態
• サポートされているキャンペーンの種類

アクションの種類

同じ一括アップロード ファイルに含める 顧客リスト アイテム レコードを追加、削除、または置き換えるかどうかを決定します。

アクションの種類が "追加" の場合、サービスは、同じ一括アップロード ファイルに含める 顧客リスト アイテム レコードの追加を試みます。

アクションの種類が "削除" に設定されている場合、サービスは、同じ一括アップロード ファイルに含める 顧客リスト アイテム レコードの削除を試みます。

アクションの種類が "置換" に設定されている場合、このリストの以前の顧客一致データはすべて削除され、サービスは、同じ一括アップロード ファイルに含める 顧客リスト アイテム レコードの追加を試みます。

足す： 随意。 既定では、新しい顧客リストには "追加" アクションの種類が使用されます。 値を設定したかどうかにかかわらず、このフィールドは新しい顧客リストでは無視されます。
更新： 同じ一括アップロード ファイルに既存の対象ユーザーの 顧客リスト アイテム レコードも含める場合は必須です。それ以外の場合は、このフィールドは省略可能です。
削除： 読み取り専用

Audience

顧客リストの名前。

名前には最大 128 文字を使用することができます。

足す： 必須
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

対象ユーザーのネットワーク サイズ

対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。

Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

対象ユーザーの検索サイズ

検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。

Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。

顧客リストのメンバーシップ期間、ルール、タグ識別子を追加または更新する場合など、対象ユーザーが作成されている間、このプロパティは最大 24 時間空になります。

顧客リストに関連付けられている UET タグの状態が [未確認] または [非アクティブ] の場合、このプロパティは空になります。これは、顧客リストがリストの作成に必要な顧客情報を Web サイトから受信できないためです。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

クライアント ID

一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。

足す： 随意
更新： 随意
削除： 読み取り専用

説明

顧客リストの説明。 説明を使用して、この顧客リストで対象としている対象ユーザーを思い出すのに役立ちます。

説明には、最大 1,024 文字を含めることができます。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

Id

顧客リストのシステム生成識別子。

足す： 随意。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 顧客リストに設定された負の識別子は、顧客リストアイテムなどの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい顧客リストと新しい顧客リストアイテムを追加する場合に必要です。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

変更時刻

エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

メンバーシップ期間

顧客リストを作成するときに、ユーザーがそのセグメントに留まる期間を指定できます。

最小期間は 1 日です。 手記： 180 日間アクティビティがないユーザーは、すべてのセグメントから削除されます。

メンバーシップ期間が "-1" の場合、有効期限はありません。

メンバーシップ期間が null の場合、既定の期間 (30 日) が使用されます。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

Parent Id

顧客リストを含む顧客の Microsoft Advertising 識別子。

足す： 随意
更新： 読み取り専用。 親 ID は変更できません。
削除： 読み取り専用

範囲

スコープは、この顧客リストを使用できるアカウントを定義します。 顧客リストの場合、サポートされているスコープは [顧客] のみです。顧客リストは、顧客のすべてのアカウントのすべてのキャンペーンや広告グループに関連付けることができます。

足す： 必須
更新： 読み取り専用。 スコープを変更することはできません。
削除： 読み取り専用

状態

顧客リストの状態。

使用可能な値は [アクティブ] または [削除済み] です。

足す： 随意。 既定値は [アクティブ] です。
更新： 読み取り専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

サポートされているキャンペーンの種類

この顧客リストをサポートするキャンペーンタイプのセミコロン区切りリスト。

サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用