একটি গ্রাহক ম্যাচ দর্শক তৈরি করুন

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

অনুরোধের মূল অংশটি তৈরি করুন

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

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

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

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

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

গ্রাহক মিলের জন্য প্রয়োজনীয় ক্ষেত্রসমূহ

কাস্টমার ম্যাচ অডিয়েন্সের জন্য ingestedUserListInfo ফিল্ডটি আবশ্যক।

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

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

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

uploadKeyTypes

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

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

contactIdInfo

DataSourceType enum থেকে উপযুক্ত মান দিয়ে dataSourceType সেট করে এটিকে একটি ContactIdInfo মেসেজে সেট করুন।

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

আপনার দর্শক সদস্যদের চিহ্নিত করতে মোবাইল আইডি ব্যবহার করতে চাইলে নিম্নলিখিত ফিল্ডগুলো সেট করুন:

uploadKeyTypes

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

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

mobileIdInfo

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

  • DataSourceType enum থেকে dataSourceType কে উপযুক্ত মানে সেট করুন।

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

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

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

    • অ্যান্ড্রয়েডের ক্ষেত্রে, আইডি স্ট্রিংটি হলো অ্যাপ্লিকেশনটির প্যাকেজ নেম। উদাহরণস্বরূপ, "Flood-It!" অ্যাপটির জন্য com.labpixies.flood যার গুগল প্লে লিঙ্ক হলো https://play.google.com/store/apps/details?id=com.labpixies.flood ।

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

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

uploadKeyTypes

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

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

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

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

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

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

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

এখানে বিভিন্ন ধরণের ব্যবহারকারীর তথ্যের জন্য JSON ফরম্যাটে নমুনা অনুরোধ দেওয়া হলো। প্রতিটি অনুরোধে membershipDuration কে 2592000s এ সেট করা হয়েছে, যেখানে 2592000 হলো ৩০ দিনের সেকেন্ড সংখ্যা। অনুরোধটি চেষ্টা করার জন্য 'Open in 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"
}

অনুরোধ পাঠান

অনুরোধটি পাঠান এবং প্রয়োজন হলে অনুরোধ হেডারগুলো অন্তর্ভুক্ত করুন।

অনুরোধটি সফল হলে, প্রতিক্রিয়াটিতে তৈরি করা UserList থাকে, যেখানে id এবং name পূরণ করা থাকে। এই ক্ষেত্রগুলির মানগুলি লিখে রাখুন, কারণ দর্শক তালিকায় নতুন সদস্য যুক্ত করার অনুরোধে এগুলি আপনার প্রয়োজন হবে।

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

পূর্ববর্তী
ওভারভিউ
পরবর্তী
সদস্যদের দর্শকদের কাছে আপলোড করুন