কাস্টমার ম্যাচ অডিয়েন্স তৈরি করা

CreateUserListRequest পাঠিয়ে কাস্টমার ম্যাচ অডিয়েন্স তৈরি করুন।

অনুরোধের প্রধান অংশ তৈরি করুন

UserList রিসোর্স তৈরি করুন। সেট করার জন্য সাধারণ ফিল্ড এখানে দেওয়া হল।

displayName
প্রয়োজনীয় তালিকার ডিসপ্লে নাম। অ্যাকাউন্টের মালিকানাধীন সব তালিকার মধ্যে নামটি অনন্য হতে হবে।
description
তালিকার সংক্ষিপ্ত বিবরণ।
integrationCode
আপনার সিস্টেম থেকে পাওয়া আইডি।
membershipDuration

তালিকায় যোগ করার পরে অডিয়েন্স মেম্বার কতক্ষণ তালিকায় থাকবেন। ভ্যালু অবশ্যই পুরো দিনের সাথে সম্পর্কিত হতে হবে। সেট করা না থাকলে, ডিফল্ট হিসেবে সর্বাধিক সেট করা হয়।

JSON ব্যবহার করলে, সেকেন্ডের সংখ্যা গণনা করতে, সময়সীমার দিনকে 86400 (প্রতিদিনের সেকেন্ডের সংখ্যা) দিয়ে গুণ করুন। তারপর ভ্যালুটিকে গুণের ফলাফলে সেট করো, তারপরে s। যেমন, আপনি যদি ৯০ দিনের মেম্বারশিপের সময়সীমা চান, তাহলে 7776000s ভ্যালু ব্যবহার করুন, কারণ 90 * 86400 = 7776000।

প্রোটোকল বাফার ফর্ম্যাট ব্যবহার করলে, দিনের সংখ্যার উপর ভিত্তি করে Duration অবজেক্ট তৈরি করার জন্য সুবিধাজনক পদ্ধতি ব্যবহার করুন, যদি এই ধরনের কোনও সুবিধাজনক পদ্ধতি থাকে। যেমন, Java-এর জন্য protobuf-java-util লাইব্রেরিতে একটি fromDays() কনভেনিয়েন্স পদ্ধতি আছে। অন্যথায়, দিনের সংখ্যাকে 86400 (প্রতিদিনের সেকেন্ডের সংখ্যা) দিয়ে গুণ করে সেকেন্ডের সংখ্যা গণনা করুন এবং ফলাফলটি Duration অবজেক্টের seconds ফিল্ড সেট করতে ব্যবহার করুন।

কাস্টমার ম্যাচের জন্য প্রয়োজনীয় ফিল্ড

কাস্টমার ম্যাচ অডিয়েন্সের জন্য ingestedUserListInfo ফিল্ডটি পূরণ করতে হবে।

আপনি যে ধরনের ডেটা ব্যবহার করে তালিকায় অডিয়েন্স মেম্বার যোগ করতে চান, তার উপর ভিত্তি করে IngestedUserListInfo -এ সেট করার জন্য এখানে ফিল্ড দেওয়া হল।

যোগাযোগের তথ্যের তালিকা

আপনার অডিয়েন্স মেম্বারদের সংজ্ঞায়িত করতে যোগাযোগের তথ্য (হ্যাশ করা ইমেল আইডি, ফোন নম্বর বা ঠিকানা) ব্যবহার করতে চাইলে, নিম্নলিখিত ফিল্ড সেট করুন:

uploadKeyTypes

CONTACT_ID আপলোড কী-এর ধরন সহ একটি তালিকায় সেট করুন।

uploadKeyTypes তালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।

contactIdInfo

DataSourceType enum থেকে উপযুক্ত ভ্যালুতে সেট করা dataSourceType সহ ContactIdInfo মেসেজে সেট করুন।

মোবাইল আইডি তালিকা

আপনার অডিয়েন্স মেম্বারদের সংজ্ঞায়িত করার জন্য মোবাইল আইডি ব্যবহার করতে চাইলে, নিম্নলিখিত ফিল্ডগুলি সেট করুন:

uploadKeyTypes

MOBILE_ID আপলোড কী-এর ধরন সহ একটি তালিকায় সেট করুন।

uploadKeyTypes তালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।

mobileIdInfo

একটি MobileIdInfo মেসেজে সেট করুন:

  • dataSourceType-এর ভ্যালু DataSourceType enum থেকে উপযুক্ত ভ্যালুতে সেট করুন।

  • keySpace-কে IOS বা ANDROID-এ সেট করুন।

  • appId-কে সেই স্ট্রিংয়ে সেট করুন যা অনন্যভাবে সেই মোবাইল অ্যাপ্লিকেশনকে শনাক্ত করে যেখান থেকে ডেটা সংগ্রহ করা হয়েছে।

    • iOS-এর ক্ষেত্রে, আইডি স্ট্রিং হল ৯ সংখ্যার স্ট্রিং যা App Store URL-এর শেষে দেখা যায়। যেমন, 476943146 "Flood-It!" অ্যাপের জন্য App Store লিঙ্ক https://apps.apple.com/us/app/flood-it/id476943146।

    • Android-এর ক্ষেত্রে, আইডি স্ট্রিং হল অ্যাপ্লিকেশনের প্যাকেজের নাম। যেমন, "Flood-It!" অ্যাপের জন্য com.labpixies.flood, Google Play লিঙ্ক https://play.google.com/store/apps/details?id=com.labpixies.flood সহ।

ব্যবহারকারীর আইডি তালিকা

আপনার অডিয়েন্স মেম্বারদের সংজ্ঞায়িত করার জন্য ব্যবহারকারীর আইডি ব্যবহার করতে চাইলে, নিম্নলিখিত ফিল্ডগুলি সেট করুন:

uploadKeyTypes

USER_ID আপলোড কী-এর ধরন সহ একটি তালিকায় সেট করুন।

uploadKeyTypes তালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।

অনুরোধ তৈরি করুন

কাস্টমার ম্যাচ অডিয়েন্স তৈরি করতে, UserList রিসোর্সের জন্য create অনুরোধ তৈরি করুন।

  1. parent ফিল্ডটি অ্যাকাউন্টের রিসোর্স নামে সেট করুন। রিসোর্সের নাম অবশ্যই accountTypes/{accountType}/accounts/{account} ফর্ম্যাট অনুযায়ী হতে হবে।

  2. অনুরোধের বডির জন্য আপনার তৈরি করা UserList ব্যবহার করুন।

  3. আপনার ক্রেডেনশিয়াল যদি এমন কোনও Google অ্যাকাউন্টের জন্য না হয় যা parent-এ ব্যবহারকারী হিসেবে আছে, তাহলে গন্তব্য ও হেডার কনফিগার করুন-এ যেভাবে বর্ণনা করা আছে সেইভাবে হেডার সেট করুন।

বিভিন্ন ধরনের ব্যবহারকারীর তথ্যের জন্য JSON-এ স্যাম্পেল অনুরোধ এখানে দেওয়া হল। প্রতিটি অনুরোধ membershipDuration-কে 2592000s-এ সেট করে, যেখানে 2592000 হল ৩০ দিনে সেকেন্ডের সংখ্যা। অনুরোধ করে দেখতে API Explorer-এ খুলুন বোতামে ক্লিক করুন।

যোগাযোগের তথ্য

{
    "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 ফিল্ড পূরণ করা থাকে।

অনুরোধটি ব্যর্থ হলে, ব্যর্থতার কারণ নির্ধারণ করতে সমস্যাগুলি পরীক্ষা করুন, যেকোনও সমস্যা সমাধান করতে অনুরোধ এবং হেডার আপডেট করুন এবং তারপরে আপডেট করা অনুরোধ এবং হেডার পাঠান।