収集した顧客データをアップロードして、カスタマー マッチ オーディエンスを作成します。これは機密データです。アップロードする前に適切に準備する必要があります。
データの書式を設定する
次の手順で元データをフォーマットします。
- 名、姓、メールアドレスの値から空白文字を削除します。
- すべての文字列値を小文字にします。
- 電話番号の値は E.164 形式で指定してください。国コードを含めてください。
データをハッシュ化する
次のタイプの生データ値を SHA256 アルゴリズムを使用してハッシュ化します。
- 名
- 姓
- メールアドレス
- 電話番号
データを割り当てる
使用するデータによってオーディエンス タイプが決まります。また、データの受け渡しに使用される API オブジェクトも決定します。
連絡先情報
連絡先情報を使用してユーザーを照合している場合:
- オーディエンス タイプ
CUSTOMER_MATCH_CONTACT_INFOを使用します。 ContactInfoオブジェクトでデータを渡します。
お客様に提供されたデータの選択によって、照合に使用される方法が決まります。
| 照合方法 | |
|---|---|
| メールアドレスの一致確認 | hashedEmails フィールドに割り当てられた値が 1 つ以上。 |
| 電話番号の照合 | hashedPhoneNumbers フィールドに割り当てられた値が 1 つ以上。 |
| 住所の一致確認 | hashedFirstName、hashedLastName、zipCodes、countryCode フィールドに割り当てられた値。 |
| メールアドレス、送付先住所、電話番号の組み合わせの一致確認 | hashedEmails、hashedPhoneNumbers、hashedFirstName、hashedLastName、zipCodes、countryCode フィールドに割り当てられた値。 |
1 回のアップロードですべての ContactInfo オブジェクトを ContactInfoList オブジェクトに含めます。
モバイル デバイス ID
モバイル デバイス ID を使用してユーザーを照合している場合:
- オーディエンス タイプ
CUSTOMER_MATCH_DEVICE_IDを使用します。 - モバイル デバイス ID 文字列を使用してデータを渡します。
1 回のアップロードのすべてのモバイル デバイス ID を MobileDeviceIdList オブジェクトに含めます。
ユーザーの同意を設定する
関連するデータ オブジェクトの consent フィールドを設定して、含まれるユーザーによって付与された同意のシグナルを渡します。
Consent オブジェクトのいずれかのフィールドを CONSENT_STATUS_DENIED に設定すると、エラーが返されます。
同意シグナルは、リクエスト内のすべてのユーザーに適用されます。同意シグナルが異なるユーザーについては、別のリクエストを使ってアップロードしてください。