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

لإنشاء جمهور "مطابقة العملاء"، أرسِل 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.

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

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

uploadKeyTypes

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

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

mobileIdInfo

اضبطها على MobileIdInfo رسالة:

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

  • اضبط keySpace على IOS أو ANDROID.

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

    • بالنسبة إلى أجهزة iOS، تكون سلسلة رقم التعريف هي السلسلة المكوّنة من 9 أرقام التي تظهر في نهاية عنوان URL الخاص بـ App Store. على سبيل المثال، 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. دوِّن القيم في هذَين الحقلَين لأنّك ستحتاج إليهما في الطلبات لإضافة أعضاء الجمهور إلى الجمهور.

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

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