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

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

重要

プログラムによる利用規約の受け入れ (推奨): 一括ファイルで Accept Customer Match Term フィールドを True に設定することで、一括 API 経由で顧客データをアップロードするときに、プログラムでカスタマー マッチ条件に同意できるようになりました。 これにより、Microsoft Advertising UI を使用して条件に同意する必要がなくなります。

従来の要件 (新しいフィールドを使用しない場合):Accept Customer Match Term フィールドを使用せずに一括 API 経由で顧客リスト データをアップロードする前に、まず 1 つの顧客リスト対象ユーザーを作成し、Microsoft Advertising UI の利用規約に同意する必要があります。 最初の顧客リストに顧客データを含める必要はありませんが、[同意する] を選択する必要があります。

UI で [同意する] を選択するか、一括ファイルで Accept Customer Match Term=True を設定することにより、(1) 対象ユーザーの詳細 (個人データ) を Microsoft に合法的に開示できることに同意し、(2) カスタマー マッチ条件、Microsoft Advertising 契約、および Microsoft Advertising ポリシーに同意するものとします。 Microsoft は、お客様がアップロードしたデータをカスタマー マッチ条件に従って使用します。

顧客リストは、顧客一致を可能にするために編集した一連の顧客の連絡先情報です。 各リストには、複数の Email アイテムを含めることができます。

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

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

ヒント

オーディエンスの概要と詳細については、 オーディエンス API テクニカル ガイドを参照してください。

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

次の一括 CSV の例では、プログラムによる条件承諾を含む新しい顧客リストを追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Accept Customer Match Term,Membership Duration
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Account,New Customer List,Add,True,30

顧客リスト レコードの場合、バルク ファイル スキーマで次の属性フィールドを使用できます。

カスタマー マッチ条件を承諾する

この一括アップロードでカスタマー マッチ条件を受け入れるためのオプションのフラグ。

  • True: 条件に同意し、顧客データを処理します。
  • False: 条項を明示的に拒否すると、アップロードは失敗します。
  • Not set Microsoft Advertising UI を介して条件に同意する以前の動作にフォールバックします。

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

アクションの種類

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

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

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

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

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

Audience

顧客リストの名前。

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

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

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

オーディエンス ネットワークでこのオーディエンスに含まれているアクティブなメンバーであるユーザーの合計数。 これにより、ターゲットにできるオーディエンス ネットワーク ユーザーの人数を大まかに把握できます。

Microsoft Advertising が対象ユーザーを最適化に使用するには、オーディエンスが少なくとも 300 人必要です。

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

オーディエンス検索のサイズ

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

Microsoft Advertising が対象ユーザーを最適化に使用するには、オーディエンスが少なくとも 300 人必要です。

このプロパティは、オーディエンスの構築中、たとえば、顧客リストのメンバーシップ期間、ルール、タグ識別子を追加または更新する場合など、最大 24 時間空になります。

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

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

クライアント ID

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

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

説明

顧客リストの説明。 説明を使用すると、この顧客リストでターゲットにしたオーディエンスを思い出せます。

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

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

ID

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

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

変更時刻

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

注:

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

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

Membership Duration

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

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

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

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

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

Parent Id

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

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

範囲

スコープは、この顧客リストを使用できるアカウントを定義します。 顧客リストでは、サポートされる範囲は 顧客のみであり、顧客リストは顧客のすべてのアカウントにわたる任意のキャンペーンや広告グループに関連付けることができます。

追加: 必須
更新日: 読み取り専用です。 スコープは変更できません。
削除: 読み取り専用

状態

顧客リストの状態。

指定可能な値は Active または Deleted です。

追加: オプション。 既定値は Active です。
更新日: 読み取り専用
削除: 必須。 [状態] は [削除済み] に設定する必要があります。

サポートされているキャンペーン タイプ

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

サポートされている値は、Audience、DynamicSearchAds、Search、Shopping です。 新しいキャンペーン タイプは将来追加される可能性があるため、固定された値セットに依存しないでください。

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

  • Last updated on