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

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

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

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

displayName
مطلوب الاسم المعروض للقائمة. يجب أن يكون الاسم فريدًا بين جميع القوائم التي يملكها الحساب.
description
وصف موجز للقائمة
integrationCode
معرّف من نظامك
membershipDuration

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

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

في حال استخدام تنسيق Protocol Buffers، استخدِم طريقة سهلة لإنشاء عنصر 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 enum.

  • اضبط قيمة 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}.

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

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

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

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

فتح في "مستكشف واجهات برمجة التطبيقات" 
{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

معرّفات الأجهزة الجوّالة

فتح في "مستكشف واجهات برمجة التطبيقات" 
{
    "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. دوِّن القيم في هذه الحقول لأنّك ستحتاج إليها في الطلبات لإضافة مستخدمين إلى الجمهور.

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

السابق
نظرة عامة
التالي
تحميل أعضاء إلى شريحة جمهور