গুগল অ্যাডস এপিআই ব্যবহার করে অফলাইন ডেটা ডায়াগনস্টিকস সংগ্রহ করুন, যেটিতে আপনার কনভার্সন ইম্পোর্ট এবং অ্যাডজাস্টমেন্ট প্রসেসগুলোর সার্বিক অবস্থা সম্পর্কে তথ্য থাকে।
আপনার অ্যাকাউন্টের সর্বশেষ অফলাইন ডেটা ডায়াগনস্টিকস পেতে, নিম্নলিখিত উৎসগুলোর মধ্যে একটি ব্যবহার করুন:
-
offline_conversion_upload_client_summaryঅ্যাকাউন্ট স্তরে ইম্পোর্ট ডায়াগনস্টিকস একত্রিত করে। -
offline_conversion_upload_conversion_action_summaryরূপান্তর ক্রিয়া স্তরে আমদানি ডায়াগনস্টিকস একত্রিত করে।
অ্যাকাউন্ট স্তরের ডায়াগনস্টিকস
অ্যাকাউন্ট স্তরের রূপান্তর আপলোড ডায়াগনস্টিকস পুনরুদ্ধার করতে, নিম্নলিখিত GAQL কোয়েরিটি ব্যবহার করুন:
SELECT
customer.id,
offline_conversion_upload_client_summary.alerts,
offline_conversion_upload_client_summary.client,
offline_conversion_upload_client_summary.daily_summaries,
offline_conversion_upload_client_summary.job_summaries,
offline_conversion_upload_client_summary.last_upload_date_time,
offline_conversion_upload_client_summary.pending_event_count,
offline_conversion_upload_client_summary.pending_rate,
offline_conversion_upload_client_summary.status,
offline_conversion_upload_client_summary.success_rate,
offline_conversion_upload_client_summary.successful_event_count,
offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary
এই কোয়েরিটি সাম্প্রতিক ইম্পোর্টগুলিতে ব্যবহৃত প্রতিটি ক্লায়েন্টের ধরনের জন্য আলাদা OfflineConversionUploadClientSummary সারি ফেরত দেয়। উদাহরণস্বরূপ, আপনি যদি সম্প্রতি Google Ads API এবং Google Ads UI উভয় ব্যবহার করে ইম্পোর্ট করে থাকেন, তাহলে ফলাফলে GOOGLE_ADS_API এবং GOOGLE_ADS_WEB_CLIENT client ভ্যালুগুলোর জন্য আলাদা এন্ট্রি থাকবে।
রূপান্তর ক্রিয়া স্তরের ডায়াগনস্টিকস
কনভার্সন অ্যাকশন লেভেলে কনভার্সন আপলোড ডায়াগনস্টিকস পুনরুদ্ধার করতে, নিম্নলিখিত GAQL কোয়েরিটি ব্যবহার করুন:
SELECT
offline_conversion_upload_conversion_action_summary.conversion_action_name,
offline_conversion_upload_conversion_action_summary.alerts,
offline_conversion_upload_conversion_action_summary.client,
offline_conversion_upload_conversion_action_summary.daily_summaries,
offline_conversion_upload_conversion_action_summary.job_summaries,
offline_conversion_upload_conversion_action_summary.last_upload_date_time,
offline_conversion_upload_conversion_action_summary.pending_event_count,
offline_conversion_upload_conversion_action_summary.status,
offline_conversion_upload_conversion_action_summary.successful_event_count,
offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >
অ্যাকাউন্ট লেভেল ডায়াগনস্টিকসের মতোই, এই কোয়েরিটি সাম্প্রতিক ইম্পোর্টগুলোতে ব্যবহৃত প্রতিটি ক্লায়েন্টের ধরনের জন্য আলাদা OfflineConversionUploadConversionActionSummary রো রিটার্ন করে। উদাহরণস্বরূপ, আপনি যদি সম্প্রতি Google Ads API এবং Google Ads UI উভয় ব্যবহার করে ইম্পোর্ট করে থাকেন, তাহলে ফলাফলে GOOGLE_ADS_API এবং GOOGLE_ADS_WEB_CLIENT client ভ্যালুগুলোর জন্য আলাদা এন্ট্রি থাকবে।
এই সারাংশগুলি কীভাবে ব্যাখ্যা করবেন
প্রতিটি OfflineConversionUploadClientSummary বা OfflineConversionUploadConversionActionSummary তে একটি status ফিল্ড থাকে, যা client জন্য ইম্পোর্টগুলোর সামগ্রিক অবস্থা প্রতিফলিত করে। এতে নিম্নলিখিত তথ্যগুলোও থাকে:
- প্রাপ্ত মোট ইভেন্টের সংখ্যা।
- সফলভাবে প্রক্রিয়াকৃত ইভেন্টগুলোর সংখ্যা।
- অপেক্ষমান ইভেন্টের সংখ্যা (যে ইভেন্টগুলো এখনও প্রক্রিয়াধীন রয়েছে)।
- একটি
alertsফিল্ড, যাOfflineConversionErrorঅনুযায়ী গ্রুপ করা ত্রুটিগুলির একটি সারাংশ প্রদান করে।
এই সমস্ত ফিল্ডে সর্বশেষ পূর্ণ ক্যালেন্ডার দিনের আমদানির তথ্য থাকে। আপনার আমদানির বর্তমান অবস্থা মূল্যায়ন করতে এই তথ্য ব্যবহার করুন।
এছাড়াও, প্রতিটি OfflineConversionUploadClientSummary বা OfflineConversionUploadConversionActionSummary তে দুই ধরনের রিপোর্ট থাকে:
-
daily_summaries - গত ৭ দিনের
successful_count,failed_countএবংpending_countআমদানি অনুরোধের সংখ্যা, যা আমদানিরdateঅনুসারে বিন্যস্ত। -
job_summaries job_idঅনুযায়ী গ্রুপ করা, সাম্প্রতিকতম ৭টি ইম্পোর্ট রিকোয়েস্টেরsuccessful_count,failed_countএবংpending_count।job_idহলোUploadClickConversionsRequestএবংUploadConversionAdjustmentsRequestএর একটি ঐচ্ছিক ফিল্ড। আপনিjob_id2^31এর চেয়ে কম একটি অঋণাত্মক সংখ্যা হিসেবে সেট করতে পারেন অথবা Google Ads API-কে আপনার রিকোয়েস্টের জন্য একটি সিস্টেম-জেনারেটেড জব আইডি নির্ধারণ করতে দিতে পারেন। আপনি যে বিকল্পই বেছে নিন না কেন,UploadClickConversionsResponseবাUploadConversionAdjustmentsResponsejob_idটি রিটার্ন করে।আপনার নিজস্ব
job_idনির্ধারণ করার একটি কার্যকর ক্ষেত্র হলো যখন আপনার এমন একটিমাত্র জব বা প্রসেস থাকে যা একাধিক রিকোয়েস্ট ব্যবহার করে প্রচুর সংখ্যক কনভার্সন সম্পন্ন করে। যদি আপনি সেই প্রতিটি রিকোয়েস্টেরjob_idএকই মানে সেট করেন, তাহলে আপনিjob_summariesথেকে জবটির জন্য একটিমাত্র এন্ট্রি পেতে পারেন। এর পরিবর্তে, যদি আপনি Google Ads API-কে প্রতিটি রিকোয়েস্টেরjob_idতে একটি সিস্টেম-জেনারেটেড মান নির্ধারণ করতে দেন, তাহলেjob_summariesএ প্রতিটি রিকোয়েস্টের জন্য একটি আলাদা এন্ট্রি থাকে, যা আপনার জবের সামগ্রিক অবস্থা বিশ্লেষণ করাকে আরও কঠিন করে তুলতে পারে।
সারাংশ কীভাবে ব্যবহার করবেন
আপনার ইম্পোর্ট প্রক্রিয়াগুলো প্রত্যাশা অনুযায়ী কনভার্সন এবং এনহ্যান্সমেন্ট রেকর্ড করছে কিনা তা নিশ্চিত করতে, পর্যায়ক্রমে আপনার প্রতিটি অ্যাকাউন্টের সামারিগুলো সংগ্রহ করুন। যদি কোনো সামারির status EXCELLENT না হয়, তবে সেই ত্রুটিগুলো কমাতে বা দূর করতে আপনার ইম্পোর্ট প্রক্রিয়াটি সংশোধনের জন্য alerts অধীনে থাকা ত্রুটির তালিকাটি ব্যবহার করুন।
উদাহরণস্বরূপ:
যদি স্ট্যাটাস
NEEDS_ATTENTIONহয়, তাহলে আপনার ইম্পোর্ট অপারেশনের একটি উল্লেখযোগ্য অংশ ব্যর্থ হয়েছে।alertsঅধীনে থাকা ত্রুটিগুলো পর্যালোচনা করুন এবং সেই ত্রুটিগুলো কমাতে বা দূর করতে আপনার ইম্পোর্ট প্রক্রিয়াটি সংশোধন করুন।যদি স্ট্যাটাসটি
NO_RECENT_UPLOADSহয়, তাহলে Google Adsclientজন্য সাম্প্রতিক কোনো ইম্পোর্ট পায়নি। যদি এটি অপ্রত্যাশিত হয়, তাহলে সেই ক্লায়েন্ট ব্যবহার করে ইম্পোর্ট সম্পাদনকারী প্রসেসগুলো পর্যালোচনা করুন।উদাহরণস্বরূপ, যদি
GOOGLE_ADS_APIএরstatusNO_RECENT_UPLOADSহয়, তাহলে এটি নির্দেশ করতে পারে যে আপনার গুগল অ্যাডস এপিআই ব্যবহারকারী ইম্পোর্ট প্রক্রিয়াটি সম্প্রতি বন্ধ হয়ে গেছে।কোনো নির্দিষ্ট ইম্পোর্ট তারিখ বা জবের কারণে পাঠানো বিপুল সংখ্যক ইভেন্ট প্রসেস হতে ব্যর্থ হয়েছে কিনা তা নির্ধারণ করতে,
daily_summariesএবংjob_summariesএরsuccessful_count,failed_countএবংpending_countপরীক্ষা করুন। পেন্ডিং অবস্থায় থাকা যেকোনো ইভেন্ট সম্পূর্ণ হতে ২৪ ঘণ্টা পর্যন্ত সময় লাগতে পারে।
অফলাইন ডেটা ডায়াগনস্টিকস কীভাবে উন্নত করা যায় সে সম্পর্কে আরও তথ্য হেল্প সেন্টারে পাওয়া যাবে।
বিধিনিষেধ
ইম্পোর্ট সারাংশ পুনরুদ্ধার করার সময় নিম্নলিখিত বিষয়গুলি মনে রাখবেন:
Google Ads API শুধুমাত্র তখনই অফলাইন ডেটা ডায়াগনস্টিকস ফেরত দেয়, যদি
searchStreamবাsearchরিকোয়েস্টেরcustomer_idসেই একই গ্রাহক হয়, যাকে আপনি সম্প্রতি কনভার্সন ইম্পোর্ট করার জন্য ব্যবহার করেছেন।উদাহরণস্বরূপ, ক্রস-অ্যাকাউন্ট কনভার্সন ট্র্যাকিং ব্যবহারকারী একটি ক্লায়েন্ট অ্যাকাউন্টে কোনো ডায়াগনস্টিকস নাও থাকতে পারে। তবে, আপনি ইম্পোর্টে ব্যবহৃত ম্যানেজার অ্যাকাউন্টের
customer_idএর সাথেcustomer_idটি মিলিয়ে একটি রিকোয়েস্ট পাঠিয়ে ডায়াগনস্টিকস পুনরুদ্ধার করতে পারেন।গুগল অ্যাডস লিড ইম্পোর্টের এনহ্যান্সড কনভার্সন থেকে আসা
CLICK_NOT_FOUNDত্রুটিগুলোকে সতর্কবার্তা হিসেবে গণ্য করে। ফলে, যদিalertsএই ত্রুটির কোনো এন্ট্রি থাকে, তবুও সংশ্লিষ্ট অপারেশনগুলো সফল বলে বিবেচিত হয় এবংsuccessful_event_countএর মধ্যে অন্তর্ভুক্ত থাকে।