পেশাদার পদ্ধতি

ডেটা ম্যানেজার 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 ব্যবহার করুন: ডেটা ইনজেস্ট বা না সরিয়ে ফাস্ট-ফেল সমস্যা ধরতে validateOnly true-এ সেট করে অনুরোধ পাঠান। শুধুমাত্র যাচাইকরণের অনুরোধ সফল হলে, অ্যাসিঙ্ক্রোনাস প্রসেসিংয়ের সময় কোনও সমস্যা হবে না, এমন কোনও গ্যারেন্টি নেই। তাই, নিয়মিত অনুরোধ পাঠানোর পরে অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করা চালিয়ে যান।

বিস্তারিত নরমালাইজেশন ও হ্যাশিং সংক্রান্ত নিয়মের জন্য, ব্যবহারকারীর ডেটা ফর্ম্যাট করুন দেখুন।

অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করুন

গুরুত্বপূর্ণ: দর্শক বা ইভেন্ট প্রসেসিং থেকে ত্রুটি এবং সতর্কতা শনাক্ত করতে প্রতিটি ইনজেশন অনুরোধের জন্য অনুরোধের স্ট্যাটাস এবং ডায়াগনস্টিক চেক করুন।

প্রতিটি IngestAudienceMembersResponse বা IngestEventsResponse থেকে request_id ক্যাপচার ও সংগ্রহ করুন এবং অনুরোধের স্ট্যাটাস ও ডায়াগনস্টিক চেক করতে অনুরোধ আইডি ব্যবহার করুন।

কোটা মনিটর করা ও সতর্কতা পাওয়া

অনুরোধের অপ্রত্যাশিত প্রত্যাখ্যান এড়াতে, Google Cloud কনসোলে কোটা সতর্কতা এবং মনিটরিং সেট-আপ করুন। কোটার ব্যবহার মনিটর করলে, আপনার অ্যাপ্লিকেশন দৈনিক বা প্রতি মিনিটের সীমাতে পৌঁছানোর আগে, আপনি খরচের প্যাটার্ন ট্র্যাক করতে এবং অনুরোধের ব্যাচিং অপ্টিমাইজ করতে পারবেন।

প্রোডাকশনে ডেপ্লয় করুন

লোকাল টেস্টিং থেকে প্রোডাকশন ওয়ার্কলোডে যাওয়ার সময়, নন-ইন্টার‍্যাক্টিভ ও সুরক্ষিতভাবে যাচাই করার জন্য, অ্যাটাচ করা সার্ভিস অ্যাকাউন্ট বা Workload Identity Federation-এর সাথে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করুন।

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