ডেটা ম্যানেজার API ব্যবহার করার সময় নিম্নলিখিত পেশাদার পদ্ধতিগুলি মনে রাখবেন।
সব ইউজার আইডেন্টিফায়ার পাঠান
UserData-এর সাথে অডিয়েন্স মেম্বার বা ইভেন্ট পাঠানোর সময়, যত বেশি সম্ভব
user_identifiers অন্তর্ভুক্ত করুন, যার মধ্যে একই ধরনের একাধিক শনাক্তকারী পাঠানোও অন্তর্ভুক্ত।
যেমন, কোনও ব্যবহারকারীর একাধিক ইমেল আইডি থাকলে, প্রতিটি ইমেল আইডির জন্য আলাদা
UserIdentifier অন্তর্ভুক্ত করুন। একইভাবে, কোনও ব্যবহারকারীর জন্য আপনার কাছে বিভিন্ন ধরনের শনাক্তকারী থাকলে, যেমন ইমেল আইডি, ফোন নম্বর এবং ঠিকানা, প্রতিটি শনাক্তকারীর জন্য আলাদা UserIdentifier যোগ করুন, সর্বাধিক শনাক্তকারী সংখ্যা পর্যন্ত।
অনুরোধ অপ্টিমাইজ করুন
দৈনিক অনুরোধের সীমা অতিক্রম করার সম্ভাবনা কমাতে, প্রতিটি অনুরোধে যতটা সম্ভব আইটেম ব্যাচ করুন, প্রতি-অনুরোধ সীমা পর্যন্ত।
যেমন, আপনি যদি কোনও অডিয়েন্সে ১০,০০০ অডিয়েন্স মেম্বার যোগ করতে চান, তাহলে একটি
IngestAudienceMembersRequest-এ audience_members তালিকায় সব ১০,০০০ মেম্বার যোগ করুন। প্রতিটি অডিয়েন্স মেম্বারকে যোগ করার জন্য আলাদা অনুরোধ পাঠানোর চেয়ে একটি অনুরোধে ১০,০০০ জন মেম্বারকে ব্যাচ করা আরও বেশি কার্যকর।
একই সাথে একাধিক অনুরোধ পাঠান
ডেটা ইনজেস্ট করার জন্য প্রয়োজনীয় মোট সময় কমাতে, IngestionService-এ
একসাথে একাধিক অনুরোধ পাঠান। প্রতি মিনিটে অনুরোধের সীমা অতিক্রম করার সম্ভাবনা কমাতে আমরা একসাথে সর্বাধিক ১০টি
অনুরোধ পাঠানোর সাজেশন দিই।
অনুরোধে একই destinations থাকলেও আপনি কনকারেন্ট অনুরোধ পাঠাতে পারবেন।
ক্লায়েন্ট সাইডে ডেটা যাচাই করা
ডেটা ম্যানেজার API একটি ফাস্ট-ফেল মডেল ব্যবহার করে। অনুরোধের কোনও রেকর্ড যদি সিঙ্ক্রোনাস যাচাইকরণে ব্যর্থ হয়, তাহলে পুরো অনুরোধটি ব্যর্থ হয় এবং কোনও রেকর্ডই প্রসেস করা হয় না। এছাড়াও, API সিকোয়েন্সিয়াল লেয়ারে অনুরোধ যাচাই করে, তাই একটি সমস্যা সমাধান করলে পরবর্তী যাচাইকরণ লেয়ার থেকে কোনও সমস্যা প্রকাশ পেতে পারে।
বারবার যাওয়া আসা এবং বাতিল করা অনুরোধ এড়াতে, আপনার ডেটা পাঠানোর আগে যাচাই এবং স্যানিটাইজ করুন:
হ্যাশিংয়ের আগে খালি ভ্যালু বাদ দিন: SHA-256 হ্যাশ গণনা করার আগে
email_addressএবংphone_number-এর মতো ফিল্ডে খালি বা শুধু হোয়াইটস্পেস-যুক্ত স্ট্রিং আছে কিনা তা চেক করুন। একটি ফাঁকা স্ট্রিং হ্যাশ করলে একটি সঠিক হ্যাশ তৈরি হয় যা সিনট্যাক্স চেক পাস করে কিন্তু ম্যাচ রেট কমিয়ে দেয়।অসম্পূর্ণ কম্পাউন্ড অবজেক্ট বাদ দিন: রেকর্ডে যোগ করার আগে কম্পাউন্ড অবজেক্টে সব প্রয়োজনীয় ফিল্ড আছে কিনা তা নিশ্চিত করুন। যেমন, কোনও
AddressInfoঅবজেক্টের চারটি প্রয়োজনীয় ফিল্ডের (given_name,family_name,region_codeবাpostal_code) মধ্যে কোনও একটি না থাকলে,REQUIRED_FIELD_MISSINGসংক্রান্ত সমস্যা এড়াতে সম্পূর্ণaddressআইডেন্টিফায়ার ড্রপ করুন।এনকোডিং এবং প্লেনটেক্সট ফিল্ড যাচাই করুন: যাচাই করুন যে হ্যাশ করা ফিল্ডগুলি ঘোষিত
encoding-এর সাথে মেলে, কাঁচা প্লেনটেক্সট পাঠানোর পরিবর্তে, এবং নিশ্চিত করুন যে ফিল্ডগুলি অবশ্যই প্লেনটেক্সট থাকতে হবে (যেমনmobile_ids) সেগুলি হ্যাশ করা হয়নি।সীমার বাইরে থাকা টাইমস্ট্যাম্প ফিল্টার করা: টাইমস্ট্যাম্প যেন ভবিষ্যতের না হয় বা গন্তব্যের কনভার্সন লুকব্যাক উইন্ডোর থেকে পুরনো না হয় তা নিশ্চিত করুন।
আপনি JSON ব্যবহার করে অনুরোধ পাঠালে, টাইমস্ট্যাম্প স্ট্রিং যেন টাইমজোন অফসেট সহ RFC 3339 ফর্ম্যাট ব্যবহার করে তা নিশ্চিত করুন।
ফোন নম্বর ক্লিন করা: হ্যাশিং করার আগে ফোন নম্বরে কান্ট্রি কোড আছে কিনা তা যাচাই করুন এবং E.164 ফর্ম্যাট ব্যবহার করুন।
খালি বা অতিরিক্ত সাইজের রেকর্ড বাদ দিন:
user_identifiers-এ প্রতি-রেকর্ড সীমা (১০টি শনাক্তকারী) ক্যাপ করুন, খালি কাস্টম প্যারামিটার বাদ দিন এবং শূন্যটি সঠিক শনাক্তকারী আছে এমন যেকোনও রেকর্ড বাদ দিন।ব্যবহারের ক্ষেত্রে প্রয়োজনীয়তা যাচাই করুন: প্রতিটি ইভেন্টে তার গন্তব্য এবং ব্যবহারের ক্ষেত্রে (যেমন Google Ads অনলাইন কনভার্সনের জন্য
transaction_id) সমস্ত বাধ্যতামূলক ফিল্ড অন্তর্ভুক্ত আছে কিনা তা নিশ্চিত করুন। ব্যবহারের কেস অনুযায়ী প্রয়োজনীয় ফিল্ডের সম্পূর্ণ তালিকা দেখতে, ইভেন্টের ওভারভিউ-এ আপনার গন্তব্যের জন্য ইভেন্ট পাঠানোর নির্দেশিকা দেখুন।অনুরোধ পরীক্ষা করতে
validateOnlyব্যবহার করুন: ডেটা ইনজেস্ট বা না সরিয়ে ফাস্ট-ফেল সমস্যা ধরতেtrue-এ সেট করাvalidateOnlyসহ অনুরোধ পাঠান। শুধুমাত্র যাচাইকরণের অনুরোধ সফলভাবে সম্পূর্ণ হওয়ার অর্থ এই নয় যে অ্যাসিঙ্ক্রোনাস প্রসেসিংয়ের সময় কোনও সমস্যা হবে না, তাই নিয়মিত অনুরোধ পাঠানোর পরে অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করা চালিয়ে যান।
বিস্তারিত নরমালাইজেশন ও হ্যাশিং সংক্রান্ত নিয়মাবলীর জন্য, ব্যবহারকারীর ডেটা ফর্ম্যাট করুন দেখুন।
অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করা
প্রতিটি
IngestAudienceMembersResponse বা
IngestEventsResponse থেকে request_id ক্যাপচার ও সংগ্রহ করুন এবং অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করতে অনুরোধ আইডি ব্যবহার করুন।
কোটা মনিটর করা ও সতর্কতা বিজ্ঞপ্তি পাঠানো
অনুরোধের অপ্রত্যাশিত প্রত্যাখ্যান এড়াতে, Google Cloud কনসোলে কোটা সংক্রান্ত সতর্কতা এবং মনিটরিং সেট-আপ করুন। কোটার ব্যবহার মনিটর করলে, আপনি ব্যবহারের প্যাটার্ন ট্র্যাক করতে এবং আপনার অ্যাপ্লিকেশন দৈনিক বা প্রতি-মিনিটের সীমাতে পৌঁছানোর আগে অনুরোধের ব্যাচিং অপ্টিমাইজ করতে পারবেন।
প্রোডাকশনে ডেপ্লয় করুন
লোকাল টেস্টিং থেকে প্রোডাকশন ওয়ার্কলোডে যাওয়ার সময়, নন-ইন্টার্যাক্টিভ ও সুরক্ষিতভাবে যাচাই করার জন্য, অ্যাটাচ করা সার্ভিস অ্যাকাউন্ট বা Workload Identity Federation-এর সাথে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করুন।
বিভিন্ন প্রোডাকশন এনভায়রনমেন্টের জন্য যাচাইকরণ কনফিগার করার ব্যাপারে বিস্তারিত জানতে, প্রোডাকশনে ডেপ্লয় করুন দেখুন।