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

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

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

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

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

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

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

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

    • إذا كان الملف الذي يتم تحميله يحتوي على أرقام تعريف المستخدمين، اضبط الحقل userIdData على رسالة UserIdData، واضبط الحقل userId على رقم تعريف المستخدم الخاص بالعضو في الجمهور.

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

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

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

معلومات الاتصال

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

بيانات عنوان IP

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

بيانات جهات الاتصال وعناوين IP

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

بيانات التعريف الرقمية

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

أرقام تعريف المستخدمين

{
  "userIdData": {
    "userId": "user_987654321"
  }
}