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

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

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

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