إنشاء جمهور مطابقة العملاء

أنشئ شريحة جمهور "مطابقة العملاء" من خلال إرسال CreateUserListRequest.

إنشاء نص الطلب

أنشئ UserList موردًا. في ما يلي الحقول الشائعة التي يجب ضبطها.

displayName

مطلوبة تمثّل هذه السمة الاسم المعروض للقائمة. يجب أن يكون الاسم فريدًا بين جميع القوائم التي يملكها الحساب.

description

وصف موجز للقائمة

integrationCode

معرّف من نظامك

membershipDuration

هي المدة التي يبقى فيها أحد أفراد الجمهور في القائمة بعد إضافته إليها. يجب أن تتوافق القيمة مع عدد الأيام الكاملة. إذا لم يتم ضبطه، يكون الحد الأقصى هو القيمة التلقائية.

في حال استخدام JSON، احسب عدد الثواني من خلال ضرب عدد أيام المدة في 86400 (عدد الثواني في اليوم). بعد ذلك، اضبط القيمة على نتيجة الضرب، متبوعة بـ s. على سبيل المثال، إذا أردت أن تبلغ مدة الاشتراك 90 يومًا، استخدِم القيمة 7776000s لأنّ 90 * 86400 = 7776000.

في حال استخدام تنسيق بروتوكول المخزن المؤقت، استخدِم طريقة سهلة لإنشاء عنصر Duration استنادًا إلى عدد الأيام، إذا كانت هذه الطريقة السهلة متاحة. على سبيل المثال، تحتوي مكتبة protobuf-java-util للغة Java على طريقة ملائمة fromDays(). بخلاف ذلك، احسب عدد الثواني عن طريق ضرب عدد أيام المدة في 86400 (عدد الثواني في اليوم)، واستخدِم النتيجة لضبط الحقل seconds في العنصر Duration.

الحقول المطلوبة لميزة "مطابقة العملاء"

يجب ملء الحقل ingestedUserListInfo لإنشاء جمهور "مطابقة العملاء".

في ما يلي الحقول التي يجب ضبطها في IngestedUserListInfo استنادًا إلى نوع البيانات التي تريد استخدامها لإضافة مستخدمين إلى القائمة.

قائمة معلومات الاتصال

اضبط الحقول التالية إذا كنت تريد استخدام معلومات الاتصال (عناوين البريد الإلكتروني المجزّأة أو أرقام الهواتف أو العناوين) لتحديد أفراد جمهورك:

uploadKeyTypes

اضبط القيمة على قائمة تحتوي على نوع مفتاح التحميل CONTACT_ID.

يجب أن تحتوي قائمة uploadKeyTypes على إدخال واحد فقط.

contactIdInfo

يجب ضبطها على رسالة ContactIdInfo مع ضبط dataSourceType على القيمة المناسبة من DataSourceType enum.

قائمة أرقام التعريف على الأجهزة الجوّالة

اضبط الحقول التالية إذا كنت تريد استخدام أرقام تعريف الأجهزة الجوّالة لتحديد أفراد جمهورك:

uploadKeyTypes

اضبط القيمة على قائمة تحتوي على نوع مفتاح التحميل MOBILE_ID.

يجب أن تحتوي قائمة uploadKeyTypes على إدخال واحد فقط.

mobileIdInfo

ضبط رسالة MobileIdInfo:

• اضبط dataSourceType على القيمة المناسبة من التعداد DataSourceType.

• اضبط قيمة keySpace على IOS أو ANDROID.

• اضبط قيمة appId على السلسلة التي تحدّد بشكل فريد تطبيق الأجهزة الجوّالة الذي تم جمع البيانات منه.

  • بالنسبة إلى نظام التشغيل iOS، فإنّ سلسلة المعرّف هي السلسلة المكوّنة من 9 أرقام التي تظهر في نهاية عنوان URL الخاص بمتجر التطبيقات. على سبيل المثال، 476943146 لتطبيق "Flood-It!" مع رابط App Store https://apps.apple.com/us/app/flood-it/id476943146.

  • بالنسبة إلى Android، سلسلة المعرّف هي اسم حزمة التطبيق. على سبيل المثال، com.labpixies.flood للتطبيق "Flood-It!" مع رابط Google Play https://play.google.com/store/apps/details?id=com.labpixies.flood.

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

اضبط الحقول التالية إذا كنت تريد استخدام أرقام تعريف المستخدمين لتحديد أعضاء جمهورك:

uploadKeyTypes

اضبط القيمة على قائمة تحتوي على نوع مفتاح التحميل USER_ID.

يجب أن تحتوي قائمة uploadKeyTypes على إدخال واحد فقط.

إنشاء الطلب

لإنشاء شريحة جمهور "مطابقة العملاء"، أنشئ create طلبًا للمورد UserList.

1. اضبط الحقل parent على اسم المورد الخاص بالحساب. يجب أن يتّبع اسم المرجع التنسيق accountTypes/{accountType}/accounts/{account_id}.

2. استخدِم UserList الذي أنشأته لنص الطلب.

3. إذا لم تكن بيانات الاعتماد خاصة بحساب Google تابع لمستخدم على parent، اضبط العناوين على النحو الموضّح في إعداد الوجهات والعناوين.

في ما يلي نماذج لطلبات بتنسيق JSON لأنواع معلومات المستخدم المختلفة. يضبط كل طلب قيمة membershipDuration على 2592000s، حيث يمثّل 2592000 عدد الثواني في 30 يومًا. انقر على الزر فتح في API Explorer لتجربة طلب.

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

فتح في "مستكشف واجهات برمجة التطبيقات"

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Mobile IDs

فتح في "مستكشف واجهات برمجة التطبيقات"

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

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

فتح في "مستكشف واجهات برمجة التطبيقات"

{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

إرسال الطلب

أرسِل الطلب، وأدرِج عناوين الطلب إذا لزم الأمر.

في حال نجاح الطلب، تحتوي الاستجابة على UserList الذي تم إنشاؤه مع ملء الحقلين id وname. دوِّن قيم هذه الحقول لأنّك ستحتاج إليها في الطلبات لإضافة أفراد إلى الجمهور.

إذا تعذّر تنفيذ الطلب، افحص الأخطاء لتحديد سبب تعذّره، وعدِّل الطلب والعناوين لحلّ أي مشاكل، ثم أرسِل الطلب والعناوين المعدَّلة.