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

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

إنشاء الطلب

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

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

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"
}

إرسال الطلب

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

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

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