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

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

قائمة Mobile ID

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

uploadKeyTypes

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

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

mobileIdInfo

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

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

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

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

    • بالنسبة إلى أجهزة iOS، سلسلة المعرّف هي سلسلة مكوّنة من 9 أرقام تظهر في نهاية عنوان URL لمتجر التطبيقات. على سبيل المثال، 476943146 لتطبيق "Flood-It!" مع رابط متجر التطبيقات 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"
}

إرسال الطلب

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

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

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

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