次の方法で共有

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

  • [アーティクル]

一括ファイルにアップロードできる顧客リスト アイテムを定義します。

注:

顧客リスト項目の一括ダウンロードはサポートされていません。

重要

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,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue

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

対象ユーザー

親顧客リスト対象ユーザーの名前。

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

追加： 必須。 [ 親 ID] フィールドまたは [ 対象ユーザー ] フィールドを指定する必要があります。
削除： 必須。 [ 親 ID] フィールドまたは [ 対象ユーザー ] フィールドを指定する必要があります。

クライアント ID

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

追加： オプション
削除： オプション

Parent Id

親顧客リスト対象ユーザーの識別子。

[ 親 ID] フィールドまたは [ 対象ユーザー ] フィールドを指定する必要があります。

追加： 読み取り専用と必須。 既存の顧客リスト識別子を指定するか、親顧客リスト レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい顧客リストに新しい顧客リストアイテムを追加する場合に必要です。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 必須。

Sub Type

[テキスト] フィールドがハッシュされた Email 値を表すかどうかを判断します。

現在、サポートされている値は "Email" のみです。

追加： 必須
削除： 必須

テキスト

テキストとしてのハッシュされた電子メール。

Sub Type が "Email" の場合、このフィールドにプレーン テキストを含めることはできません。 文字列は SHA-256 アルゴリズムを使用してハッシュする必要があります。 ハッシュされた電子メールは、長さ 64 の 16 進文字列である必要があります。 たとえば、"" ではなくtest@contoso.com "f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101" などのハッシュ文字列をアップロードする必要があります。

追加： 必須
削除： 必須