تحميل بيانات العملاء التي تم جمعها لإنشاء شرائح جمهور "مطابقة العملاء" هذه البيانات حسّاسة. يجب إعدادها بشكل صحيح قبل تحميلها.
تنسيق البيانات
نسِّق البيانات الأولية باتّباع الخطوات التالية:
- أزِل أي مسافات بيضاء من قيم الاسم الأول واسم العائلة وعنوان البريد الإلكتروني.
- تحويل جميع قيم السلسلة إلى أحرف صغيرة
- يجب تنسيق قيمة رقم الهاتف باستخدام تنسيق E.164. يجب تضمين رمز البلد.
تجزئة البيانات
يجب تجزئة قيم البيانات الأولية من الأنواع التالية باستخدام خوارزمية SHA256:
- الاسم الأول
- اسم العائلة
- عنوان البريد الإلكتروني
- رقم الهاتف
تعيين البيانات
تحدّد البيانات التي تستخدمها نوع الجمهور. ويحدّد أيضًا عنصر واجهة برمجة التطبيقات المستخدَم لنقل البيانات.
معلومات الاتصال
في حال استخدام معلومات الاتصال لمطابقة المستخدمين:
- استخدِم نوع الجمهور
CUSTOMER_MATCH_CONTACT_INFO. - مرِّر البيانات في عنصر
ContactInfo.
يحدّد اختيار البيانات المقدَّمة لأحد العملاء الطريقة المستخدَمة لمطابقته:
| طريقة المطابقة | |
|---|---|
| مطابقة عناوين البريد الإلكتروني | يجب إدخال قيمة واحدة على الأقل في الحقل hashedEmails. |
| مطابقة أرقام الهواتف | يجب إدخال قيمة واحدة على الأقل في الحقل hashedPhoneNumbers. |
| مطابقة العناوين البريدية | القيم المعيّنة للحقول hashedFirstName وhashedLastName وzipCodes وcountryCode |
| مطابقة عناوين البريد الإلكتروني والعناوين البريدية وأرقام الهواتف معًا | القيم المعيّنة للحقول hashedEmails وhashedPhoneNumbers وhashedFirstName وhashedLastName وzipCodes وcountryCode |
ضمِّن جميع عناصر ContactInfo لعملية تحميل واحدة في عنصر ContactInfoList.
أرقام تعريف الأجهزة الجوّالة
في حال استخدام أرقام تعريف الأجهزة الجوّالة لمطابقة المستخدمين، يُرجى اتّباع الخطوات التالية:
- استخدِم نوع الجمهور
CUSTOMER_MATCH_DEVICE_ID. - مرِّر البيانات باستخدام سلسلة رقم تعريف الجهاز الجوّال.
أدرِج جميع أرقام تعريف الأجهزة الجوّالة لعملية تحميل واحدة في عنصر
MobileDeviceIdList.
ضبط موافقة المستخدم
اضبط الحقل consent في عنصر البيانات ذي الصلة لتمرير إشارات الموافقة التي منحها المستخدمون المضمّنون.
سيؤدي ضبط أي من الحقلين في العنصر Consent على CONSENT_STATUS_DENIED إلى عرض خطأ.
تنطبق إشارات الموافقة على جميع المستخدمين في الطلب. استخدِم طلبات منفصلة لتحميل المستخدمين الذين لديهم إشارات موافقة مختلفة.