একটি 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 DataSourceTypeenum থেকে উপযুক্ত মানের সাথেdataSourceTypeসেট করে একটিContactIdInfoবার্তায় সেট করুন।
মোবাইল আইডি তালিকা
আপনার দর্শকদের সংজ্ঞায়িত করার জন্য মোবাইল আইডি ব্যবহার করতে চাইলে নিম্নলিখিত ক্ষেত্রগুলি সেট করুন:
-
uploadKeyTypes MOBILE_IDআপলোড কী টাইপ ধারণকারী একটি তালিকায় সেট করুন।uploadKeyTypesতালিকায় শুধুমাত্র একটি এন্ট্রি থাকতে হবে।-
mobileIdInfo একটি
MobileIdInfoবার্তায় সেট করুন:DataSourceTypeenum থেকে উপযুক্ত মানেdataSourceTypeসেট করুন।keySpaceIOSঅথবা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 অনুরোধ তৈরি করুন।
parentক্ষেত্রটি অ্যাকাউন্টের রিসোর্স নামে সেট করুন। রিসোর্সের নামটি অবশ্যইaccountTypes/{accountType}/accounts/{account_id}ফর্ম্যাট অনুসরণ করবে।অনুরোধের মূল অংশের জন্য আপনার তৈরি করা
UserListব্যবহার করুন।যদি আপনার শংসাপত্রগুলি এমন কোনও 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 পূরণ করা হবে। এই ক্ষেত্রগুলিতে মানগুলি নোট করুন কারণ দর্শকদের সাথে দর্শকদের যোগ করার অনুরোধে আপনার এগুলি প্রয়োজন।
যদি অনুরোধটি ব্যর্থ হয়, তাহলে ব্যর্থতার কারণ নির্ধারণের জন্য ত্রুটিগুলি পরীক্ষা করুন , যেকোনো সমস্যা সমাধানের জন্য অনুরোধ এবং হেডার আপডেট করুন এবং তারপর আপডেট করা অনুরোধ এবং হেডারগুলি পাঠান।