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

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

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

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

displayName

প্রয়োজনীয় তালিকার প্রদর্শন নাম। অ্যাকাউন্টের মালিকানাধীন সমস্ত তালিকার মধ্যে নামটি অবশ্যই অনন্য হতে হবে।

description

তালিকার একটি সংক্ষিপ্ত বিবরণ।

integrationCode

আপনার সিস্টেম থেকে একটি আইডি।

membershipDuration

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

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

যদি প্রোটোকল বাফার ফর্ম্যাট ব্যবহার করেন, তাহলে দিনের সংখ্যার উপর ভিত্তি করে একটি Duration অবজেক্ট তৈরি করার জন্য convenience পদ্ধতি ব্যবহার করুন, যদি এমন কোন convenience পদ্ধতি বিদ্যমান থাকে। উদাহরণস্বরূপ, জাভার protobuf-java-util লাইব্রেরিতে fromDays() convenience পদ্ধতি রয়েছে। অন্যথায়, 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 এর ক্ষেত্রে, ID স্ট্রিং হল 9 সংখ্যার স্ট্রিং যা অ্যাপ স্টোর URL এর শেষে প্রদর্শিত হয়। উদাহরণস্বরূপ, "Flood-It!" অ্যাপের জন্য 476943146 , যার অ্যাপ স্টোর লিঙ্ক https://apps.apple.com/us/app/flood-it/id476943146 ।

  • অ্যান্ড্রয়েডের জন্য, আইডি স্ট্রিং হল অ্যাপ্লিকেশনের প্যাকেজের নাম। উদাহরণস্বরূপ, "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_id} ফর্ম্যাট অনুসরণ করবে।

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

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

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

{
    "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 পূরণ করা হবে। এই ক্ষেত্রগুলিতে মানগুলি নোট করুন কারণ দর্শকদের সাথে দর্শকদের যোগ করার অনুরোধে আপনার এগুলি প্রয়োজন।

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