CreateUserListRequest পাঠিয়ে
কাস্টমার ম্যাচ অডিয়েন্স তৈরি করুন।
অনুরোধের প্রধান অংশ তৈরি করুন
UserList
রিসোর্স তৈরি করুন। সেট করার জন্য সাধারণ ফিল্ড এখানে দেওয়া হল।
displayName- প্রয়োজনীয় তালিকার ডিসপ্লে নাম। অ্যাকাউন্টের মালিকানাধীন সব তালিকার মধ্যে নামটি অনন্য হতে হবে।
description- তালিকার সংক্ষিপ্ত বিবরণ।
integrationCode- আপনার সিস্টেম থেকে পাওয়া আইডি।
membershipDurationতালিকায় যোগ করার পরে অডিয়েন্স মেম্বার কতক্ষণ তালিকায় থাকবেন। ভ্যালু অবশ্যই পুরো দিনের সাথে সম্পর্কিত হতে হবে। সেট করা না থাকলে, ডিফল্ট হিসেবে সর্বাধিক সেট করা হয়।
JSON ব্যবহার করলে, সেকেন্ডের সংখ্যা গণনা করতে, সময়সীমার দিনকে
86400(প্রতিদিনের সেকেন্ডের সংখ্যা) দিয়ে গুণ করুন। তারপর ভ্যালুটিকে গুণের ফলাফলে সেট করো, তারপরেs। যেমন, আপনি যদি ৯০ দিনের মেম্বারশিপের সময়সীমা চান, তাহলে7776000sভ্যালু ব্যবহার করুন, কারণ90 * 86400 = 7776000।প্রোটোকল বাফার ফর্ম্যাট ব্যবহার করলে, দিনের সংখ্যার উপর ভিত্তি করে
Durationঅবজেক্ট তৈরি করার জন্য সুবিধাজনক পদ্ধতি ব্যবহার করুন, যদি এই ধরনের কোনও সুবিধাজনক পদ্ধতি থাকে। যেমন, Java-এর জন্যprotobuf-java-utilলাইব্রেরিতে একটিfromDays()কনভেনিয়েন্স পদ্ধতি আছে। অন্যথায়, দিনের সংখ্যাকে86400(প্রতিদিনের সেকেন্ডের সংখ্যা) দিয়ে গুণ করে সেকেন্ডের সংখ্যা গণনা করুন এবং ফলাফলটিDurationঅবজেক্টেরsecondsফিল্ড সেট করতে ব্যবহার করুন।
কাস্টমার ম্যাচের জন্য প্রয়োজনীয় ফিল্ড
কাস্টমার ম্যাচ অডিয়েন্সের জন্য ingestedUserListInfo ফিল্ডটি পূরণ করতে হবে।
আপনি যে ধরনের ডেটা ব্যবহার করে তালিকায় অডিয়েন্স মেম্বার যোগ করতে চান, তার উপর ভিত্তি করে
IngestedUserListInfo
-এ সেট করার জন্য এখানে ফিল্ড দেওয়া হল।
যোগাযোগের তথ্যের তালিকা
আপনার অডিয়েন্স মেম্বারদের সংজ্ঞায়িত করতে যোগাযোগের তথ্য (হ্যাশ করা ইমেল আইডি, ফোন নম্বর বা ঠিকানা) ব্যবহার করতে চাইলে, নিম্নলিখিত ফিল্ড সেট করুন:
uploadKeyTypesCONTACT_IDআপলোড কী-এর ধরন সহ একটি তালিকায় সেট করুন।uploadKeyTypesতালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।contactIdInfoDataSourceTypeenum থেকে উপযুক্ত ভ্যালুতে সেট করাdataSourceTypeসহContactIdInfoমেসেজে সেট করুন।
মোবাইল আইডি তালিকা
আপনার অডিয়েন্স মেম্বারদের সংজ্ঞায়িত করার জন্য মোবাইল আইডি ব্যবহার করতে চাইলে, নিম্নলিখিত ফিল্ডগুলি সেট করুন:
uploadKeyTypesMOBILE_IDআপলোড কী-এর ধরন সহ একটি তালিকায় সেট করুন।uploadKeyTypesতালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।mobileIdInfoএকটি
MobileIdInfoমেসেজে সেট করুন:dataSourceType-এর ভ্যালুDataSourceTypeenum থেকে উপযুক্ত ভ্যালুতে সেট করুন।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 সহ।
অনুরোধ তৈরি করুন
কাস্টমার ম্যাচ অডিয়েন্স তৈরি করতে, UserList রিসোর্সের জন্য
create অনুরোধ তৈরি করুন।
parentফিল্ডটি অ্যাকাউন্টের রিসোর্স নামে সেট করুন। রিসোর্সের নাম অবশ্যইaccountTypes/{accountType}/accounts/{account}ফর্ম্যাট অনুযায়ী হতে হবে।অনুরোধের বডির জন্য আপনার তৈরি করা
UserListব্যবহার করুন।আপনার ক্রেডেনশিয়াল যদি এমন কোনও 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" }
অনুরোধ পাঠান
অনুরোধ পাঠান এবং প্রয়োজন হলে, অনুরোধের হেডার
যোগ করুন, যেমন login-account বা linked-account।
অনুরোধ সফল হলে, উত্তরে তৈরি করা
UserList থাকে, যার সাথে
শুধুমাত্র-আউটপুট id এবং name ফিল্ড পূরণ করা থাকে।
অনুরোধটি ব্যর্থ হলে, ব্যর্থতার কারণ নির্ধারণ করতে সমস্যাগুলি পরীক্ষা করুন, যেকোনও সমস্যা সমাধান করতে অনুরোধ এবং হেডার আপডেট করুন এবং তারপরে আপডেট করা অনুরোধ এবং হেডার পাঠান।