تحميل أعضاء إلى شريحة جمهور

يمكنك تحميل الأعضاء إلى شريحة جمهور "مطابقة العملاء" من خلال إرسال IngestAudienceMembersRequest.

لضبط الطلب وإرساله، أكمِل الخطوات التالية:

1. اضبط الحقل termsOfService على رسالة TermsOfService مع ضبط customerMatchTermsOfServiceStatus على ACCEPTED لتأكيد قبول operatingAccount بنود خدمة "مطابقة العملاء".

2. في كل AudienceMember في قائمة audienceMembers، اضبط حقل البيانات استنادًا إلى نوع البيانات التي يتضمّنها التحميل:

   • إذا كانت عملية التحميل تحتوي على معلومات اتصال، اضبط الحقل compositeData على عنصر CompositeData، واضبط الحقل userData على عنصر UserData. أضِف إدخالاً منفصلاً في قائمة "userIdentifiers" لكل معرّف لعضو في الجمهور.

     مع أنّنا ما زلنا نتيح استخدام userData، ننصحك باستخدام compositeData لضمان أنّ عملية الدمج جاهزة للتحسينات المستقبلية. يمكنك الاطّلاع على البيانات المركّبة لمزيد من التفاصيل.

   • إذا كان الملف الذي يتم تحميله يحتوي على بيانات تعريف رقمية، اضبط الحقل mobileData على رسالة MobileData. أضِف إدخالاً منفصلاً في قائمة mobileIds لكل بيانات تعريف رقمية لعضو في الجمهور.

3. أرسِل بيانات "مطابقة العملاء" باتّباع الخطوات الواردة في مقالة إرسال أعضاء الجمهور.

عيّنة من أعضاء الجمهور

توضّح الأمثلة التالية كيفية تنظيم عنصر AudienceMember لكل نوع من بيانات الأعضاء. يجب أن يتضمّن كل AudienceMember في طلب واحد النوع نفسه من بيانات المعرّف (compositeData أو mobileData):

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}