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

يمكنك إنشاء شريحة جمهور "مطابقة العملاء" عن طريق إرسال 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!" الذي عنوان URL الخاص به في App Store هو https://apps.apple.com/us/app/flood-it/id476943146.

  • بالنسبة إلى Android، تكون سلسلة رقم التعريف هي اسم حزمة التطبيق. على سبيل المثال، com.labpixies.flood لتطبيق "Flood-It!" الذي عنوان URL الخاص به في 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. دوِّن القيم في هذَين الحقلَين لأنّك ستحتاج إليهما في الطلبات لإضافة أعضاء شريحة الجمهور إلى شريحة الجمهور.

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