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

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

অনুরোধের বডি তৈরি করা

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

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

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

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

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

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

Customer Match অডিয়েন্সের জন্য ingestedUserListInfo ফিল্ডটি প্রয়োজন।

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

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

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

uploadKeyTypes

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

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

contactIdInfo

dataSourceType-এর মান DataSourceType এনাম থেকে উপযুক্ত ভ্যালুতে সেট করা ContactIdInfo মেসেজে সেট করা আছে।

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

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

uploadKeyTypes

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

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

mobileIdInfo

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

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

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

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

    • iOS-এর ক্ষেত্রে, আইডি স্ট্রিং হল ৯ সংখ্যার স্ট্রিং যা App Store URL-এর শেষে দেখা যায়। যেমন, App Store লিঙ্কের সাথে "Flood-It!" অ্যাপের জন্য 476943146 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.

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

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

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

  2. অনুরোধের মূল অংশে আপনি যে UserList তৈরি করেছেন সেটি ব্যবহার করুন।

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

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

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

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

মোবাইল আইডি

API Explorer-এ খুলুন 
{
    "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 পূরণ করা থাকে। এইসব ফিল্ডের ভ্যালুগুলি লিখে রাখুন, কারণ অডিয়েন্সে অডিয়েন্স মেম্বার যোগ করার অনুরোধ করার সময় আপনার এগুলি প্রয়োজন হবে।

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

পূর্ববর্তী
নিরীক্ষণ
পরবর্তী
দর্শকের তালিকায় মেম্বারদের আপলোড করা