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

يمكنك تحميل أعضاء إلى شريحة جمهور "مطابقة العملاء" عن طريق إرسال الـ 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"
    ]
  }
}