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

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

重要

Bulk API を使用して顧客リスト データをアップロードするには、まず 1 人の顧客リスト対象ユーザーを作成し、Microsoft Advertising UI で使用条件に同意する必要があります。 最初の顧客リストには顧客データを含める必要はありませんが、[同意する] を選択する必要があります。 [同意する] を選択すると (1) ユーザーは、個人データである対象ユーザーの詳細を Microsoft に合法的に開示できることに同意し、(2) カスタマー マッチ条項、Microsoft 広告契約、および Microsoft 広告ポリシーに同意します。 Microsoft は、お客様がアップロードしたデータを カスタマー マッチ条項に従って使用します。

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

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

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

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

ヒント

対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。

アカウント内のすべての顧客リスト レコードをダウンロードできます。これには、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 レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

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

アクションの種類

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

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

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

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

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

対象ユーザー

顧客リストの名前。

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

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

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

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

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

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

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

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

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

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

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

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

クライアント ID

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

追加： オプション
更新： オプション
削除： 読み 取り 専用

説明

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

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

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

Id

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

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

変更時刻

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

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

メンバーシップ期間

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

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

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

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

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

Parent Id

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

追加： オプション
更新： 読み 取り 専用。 親 ID は変更できません。
削除： 読み 取り 専用

範囲

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

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

状態

顧客リストの状態。

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

追加： オプション。 既定値は [アクティブ] です。
更新： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

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

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

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

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用