準備使用者資料

上傳收集到的顧客數位資料,建立目標顧客比對目標對象。這是機密資料。上傳前請務必妥善準備。

設定資料格式

請按照下列步驟設定原始資料格式:

  • 從名字、姓氏和電子郵件地址值中移除所有空白字元。
  • 將所有字串值設為小寫。
  • 電話號碼值必須使用 E.164 格式。須包含國家/地區代碼。

雜湊處理資料

使用 SHA256 演算法,對下列類型的原始資料值進行雜湊處理:

  • 名字
  • 姓氏
  • 電子郵件地址
  • 電話號碼

指派資料

您使用的資料會決定目標對象類型。並決定用於傳遞資料的 API 物件。

聯絡資訊

如果您使用聯絡資訊比對使用者:

  • 使用目標對象類型 CUSTOMER_MATCH_CONTACT_INFO
  • ContactInfo 物件的形式傳遞資料。

系統會根據您為顧客提供的資料,決定比對方式:

比對方法
電子郵件地址比對 指派給 hashedEmails 欄位的值至少要有一個。
電話比對 指派給 hashedPhoneNumbers 欄位的值至少要有一個。
郵寄地址比對 指派給 hashedFirstNamehashedLastNamezipCodescountryCode 欄位的值。
電子郵件地址、郵寄地址和電話比對 指派給 hashedEmailshashedPhoneNumbershashedFirstNamehashedLastNamezipCodescountryCode 欄位的值。

ContactInfoList 物件中,加入單一上傳作業的所有 ContactInfo 物件。

行動裝置 ID

如果您使用行動裝置 ID 比對使用者:

  • 使用目標對象類型 CUSTOMER_MATCH_DEVICE_ID
  • 使用行動裝置 ID 字串傳遞資料。

MobileDeviceIdList 物件中,納入單次上傳的所有行動裝置 ID。

在相關資料物件中設定 consent 欄位,傳遞所含使用者授予的同意聲明信號。

如果將 Consent 物件中的任一欄位設為 CONSENT_STATUS_DENIED,系統會傳回錯誤。

同意聲明信號會套用至要求中的所有使用者。請使用不同的要求,上傳同意聲明信號不同的使用者。