يمكنك تحميل الأعضاء إلى جمهور "مطابقة العملاء" من خلال إرسال
IngestAudienceMembersRequest.
لضبط الطلب وإرساله، أكمِل الخطوات التالية:
اضبط الحقل
termsOfServiceعلى رسالةTermsOfServiceمع ضبطcustomerMatchTermsOfServiceStatusعلىACCEPTEDلتأكيد قبولoperatingAccountبنود خدمة "مطابقة العملاء".في كل
AudienceMemberفي قائمةaudienceMembers، اضبط حقل البيانات استنادًا إلى نوع البيانات التي يتضمّنها التحميل:إذا كان الملف الذي تم تحميله يحتوي على معلومات اتصال أو بيانات عنوان IP أو كليهما، اضبط الحقل
compositeDataعلى عنصرCompositeData. بالنسبة إلى معلومات الاتصال، اضبط حقلuserDataعلى عنصرUserDataوأضِف إدخالاً منفصلاً في قائمةuserIdentifiersلكل معرّف لعضو في الجمهور. بالنسبة إلى بيانات عناوين IP، أضِف إدخالIpDataفي قائمةipDataلكل عنوان IP خاص بالعضو في الجمهور.مع أنّنا ما زلنا نتيح استخدام
userData، ننصحك باستخدامcompositeDataلضمان استعداد عملية الدمج لديك للتحديثات المستقبلية. يمكنك الاطّلاع على البيانات المركّبة لمزيد من التفاصيل.إذا كانت عملية التحميل تتضمّن أرقام تعريف الأجهزة الجوّالة، اضبط الحقل
mobileDataعلى رسالةMobileData. أضِف إدخالاً منفصلاً في قائمةmobileIdsلكل بيانات تعريف رقمية لعضو في الجمهور.إذا كان الملف الذي يتم تحميله يحتوي على أرقام تعريف المستخدمين، اضبط الحقل
userIdDataعلى رسالةUserIdData، واضبط الحقلuserIdعلى رقم تعريف المستخدم الخاص بالعضو في الجمهور.
أرسِل بيانات "مطابقة العملاء" باتّباع الخطوات الواردة في مقالة إرسال أعضاء الجمهور.
عيّنة من أعضاء الجمهور
توضّح الأمثلة التالية كيفية تنظيم عنصر
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"
}
}