কারণ নির্ণয়

আপনার ইভেন্ট ও দর্শক আপলোডের অবস্থা যাচাই করতে এবং ডেটার সমস্যা শনাক্ত করতে, এই হলো প্রস্তাবিত কার্যপ্রক্রিয়া।

  1. ইভেন্ট পাঠাতে অথবা দর্শক যুক্ত করতে বা অপসারণ করতে অনুরোধ জারি করুন।

  2. প্রতিটি অনুরোধের সামগ্রিক অবস্থা পরীক্ষা করুন। একটি সফল অনুরোধের Status code 0 (enum ভ্যালু OK , HTTP রেসপন্স 200 OK ) থাকে এবং এটি একটি IngestEventsResponse , IngestAudienceMembersResponse , বা RemoveAudienceMembersResponse রিটার্ন করে।

    যদি কোনো অনুরোধ সফল না হয়, তাহলে ত্রুটিটি সমাধান করার জন্য অনুরোধটি সংশোধন করুন এবং পুনরায় পাঠান।

    অনুরোধটি সফল হলে, প্রতিক্রিয়ার request_id সংগ্রহ করুন, যাতে আপনি পরবর্তী ধাপে ডায়াগনস্টিকস পুনরুদ্ধার করতে এটি ব্যবহার করতে পারেন।

  3. প্রতিটি সফল request_id জন্য একটি RetrieveRequestStatus অনুরোধ পাঠান।

  4. আপনার আপলোডগুলি সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে এবং আপনার ডেটাতে কোনও সমস্যা আছে কিনা তা শনাক্ত করতে প্রতিটি RetrieveRequestStatusResponse পর্যালোচনা করুন।

  5. ডেটা সংক্রান্ত সমস্যাগুলো সংশোধন করুন।

  6. ধাপ ১-এ ফিরে যান এবং আপনার আপলোডগুলির সমস্ত সমস্যা সমাধান না হওয়া পর্যন্ত পুনরাবৃত্তি করুন।

অনুরোধ পাঠান

একটি RetrieveRequestStatusRequest একটিমাত্র request_id ফিল্ড থাকে। ইনজেশন রিকোয়েস্ট পাঠানোর সময় আপনার সংগ্রহ করা প্রতিটি সফল রিকোয়েস্ট আইডির জন্য একটি করে রিকোয়েস্ট পাঠান।

আপনার ব্রাউজারে এপিআই এক্সপ্লোরার ব্যবহার করে একটি অনুরোধ পাঠিয়ে দেখুন ।

প্রতিক্রিয়া পর্যালোচনা করুন

একটি RetrieveRequestStatusResponse এর request_status_per_destination অংশে সংশ্লিষ্ট ইনজেশন রিকোয়েস্টের প্রতিটি ডেস্টিনেশনের জন্য একটি পৃথক এন্ট্রি থাকে।

উদাহরণস্বরূপ, যদি আপনার IngestAudienceMembersRequest destinations তালিকায় ৩টি ভিন্ন অডিয়েন্সে ডেটা পাঠানোর জন্য ৩টি এন্ট্রি থাকে, তাহলে স্ট্যাটাস রেসপন্সে request_status_per_destination এ ৩টি এন্ট্রি থাকবে (প্রতিটি অডিয়েন্সের জন্য একটি করে এন্ট্রি)।

সামগ্রিক গন্তব্যের অবস্থা পরীক্ষা করুন

প্রথম ধাপ হিসেবে, ` RequestStatusPerDestination এর destination জন্য ডেটা ম্যানেজার এপিআই ডেটা প্রসেসিং শেষ করেছে কিনা তা জানতে request_status ফিল্ডটি পরীক্ষা করুন। request_status এর সম্ভাব্য মানগুলো হলো:

  • PROCESSING : গন্তব্যের ডেটা এখনও প্রক্রিয়াকরণ করা হচ্ছে।
  • SUCCESS : গন্তব্যের জন্য অনুরোধ প্রক্রিয়াকরণ কোনো ত্রুটি ছাড়াই সম্পন্ন হয়েছে।
  • FAILURE : ত্রুটির কারণে গন্তব্যস্থলের সমস্ত রেকর্ড ব্যর্থ হয়েছে।
  • PARTIAL_SUCCESS : গন্তব্যের জন্য কিছু রেকর্ড সফল হয়েছে, কিন্তু ত্রুটির কারণে অন্যগুলো ব্যর্থ হয়েছে।

গন্তব্য অনুযায়ী ইভেন্ট বা দর্শকের অবস্থা যাচাই করুন

ইনজেশন অনুরোধের ধরনের সাথে সঙ্গতিপূর্ণ স্ট্যাটাস ফিল্ডটি পরীক্ষা করুন। প্রতিটি RequestStatusPerDestination এ নিম্নলিখিত ফিল্ডগুলির মধ্যে কেবল একটি সেট করা থাকে:

ইভেন্ট গ্রহণের অবস্থা

অনুরোধটি যদি একটি IngestEventsRequest হয়, তাহলে events_ingestion_status ফিল্ডটি পূরণ করা হয়।

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestEventStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

শ্রোতাদের গ্রহণের অবস্থা

অনুরোধটি যদি একটি IngestAudienceMembersRequest হয়, তাহলে audience_members_ingestion_status ফিল্ডটি পূরণ করা হয়। প্রতিটি ধরণের অডিয়েন্স ডেটার জন্য পরীক্ষা করার জন্য এখানে IngestAudienceMembersStatus ফিল্ডটি দেওয়া হলো। এই ফিল্ডগুলোর মধ্যে শুধুমাত্র একটি সেট করা থাকে।

user_data_ingestion_status

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestUserDataStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

প্রাপ্ত ইউজার আইডেন্টিফায়ারের সংখ্যা আপনার প্রত্যাশার সাথে মেলে কিনা তা নিশ্চিত করতে user_identifier_count পরীক্ষা করুন।

অনুরোধটিতে পর্যাপ্ত সংখ্যক রেকর্ড থাকলে, upload_match_rate_range এ অনুরোধের রেকর্ডগুলির জন্য ম্যাচ রেট পরিসীমাটি থাকে।

mobile_data_ingestion_status

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestMobileDataStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

প্রাপ্ত মোবাইল আইডির সংখ্যা আপনার প্রত্যাশার সাথে মেলে কিনা তা নিশ্চিত করতে mobile_id_count পরীক্ষা করুন।

pair_data_ingestion_status

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestPairDataStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

প্রাপ্ত PAIR ID-এর সংখ্যা আপনার প্রত্যাশার সাথে মেলে কিনা তা নিশ্চিত করতে pair_id_count পরীক্ষা করুন।

ppid_data_ingestion_status

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestPpidDataStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

প্রাপ্ত PPID-এর সংখ্যা আপনার প্রত্যাশার সাথে মেলে কিনা তা নিশ্চিত করতে ppid_count পরীক্ষা করুন।

user_id_data_ingestion_status

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে IngestUserIdDataStatus এর record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

প্রাপ্ত ইউজার আইডির সংখ্যা আপনার প্রত্যাশার সাথে মেলে কিনা তা নিশ্চিত করতে user_id_count পরীক্ষা করুন।

দর্শক সদস্যদের অপসারণের অবস্থা

অনুরোধটি যদি একটি RemoveAudienceMembersRequest হয়, তাহলে audience_members_removal_status ফিল্ডটি পূরণ করা হয়। প্রতিটি ধরণের অডিয়েন্স ডেটার জন্য যাচাই করার জন্য এখানে RemoveAudienceMembersStatus ফিল্ডটি দেওয়া হলো। এই ফিল্ডগুলোর মধ্যে শুধুমাত্র একটি সেট করা থাকে।

user_data_removal_status
ব্যবহারকারীর ডেটা অপসারণের অবস্থা।
mobile_data_removal_status
মোবাইল ডেটা অপসারণের অবস্থা।
pair_data_removal_status
PAIR ডেটার অপসারণের অবস্থা।
ppid_data_removal_status
PPID ডেটা অপসারণের অবস্থা।
user_id_data_removal_status
ব্যবহারকারী আইডি ডেটার অপসারণের অবস্থা

প্রাপ্ত মোট রেকর্ডের সংখ্যা আপনার প্রত্যাশার সাথে মিলছে কিনা তা নিশ্চিত করতে record_count পরীক্ষা করুন। record_count মধ্যে সফল এবং ব্যর্থ উভয় রেকর্ডই অন্তর্ভুক্ত থাকে।

এছাড়াও, প্রাপ্ত ইউজার আইডেন্টিফায়ার, মোবাইল আইডি বা পেয়ার আইডির মোট সংখ্যা নিশ্চিত করতে user_identifier_count , mobile_id_count বা pair_id_count যাচাই করুন।

সতর্কতা এবং ত্রুটিগুলি পরীক্ষা করুন

গন্তব্য এবং অনুরোধের ধরনের স্ট্যাটাস ফিল্ডগুলো ছাড়াও, RetrieveRequestStatusResponse এ অনুরোধটির জন্য সতর্কতা এবং ত্রুটিগুলোর একটি বিশদ বিবরণ থাকে।

  • একটি ত্রুটি নির্দেশ করে যে এপিআই রেকর্ডটি সম্পূর্ণরূপে প্রত্যাখ্যান করেছে।
  • একটি সতর্কবার্তা নির্দেশ করে যে এপিআই রেকর্ডটি প্রত্যাখ্যান করেনি, কিন্তু রেকর্ডটির ডেটার কিছু অংশ উপেক্ষা করতে হয়েছে।

উদাহরণস্বরূপ, যদি কোনো Event এনক্রিপ্টেড UserIdentifier ডেটা এবং gclid মতো AdIdentifiers থাকে, এবং UserIdentifier ডেটা ডিক্রিপ্ট করা না যায়, তাহলে Data Manager API AdIdentifiers ব্যবহার করে রেকর্ডটি প্রসেস করলেও PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR এই ওয়ার্নিংটি রিটার্ন করে।

তবে, যদি Event AdIdentifiers না থাকে এবং UserIdentifier ডেটা ডিক্রিপ্ট করা না যায়, তাহলে ডেটা ম্যানেজার API পুরো রেকর্ডটি প্রত্যাখ্যান করে এবং PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR ত্রুটিটি রিপোর্ট করে, কারণ একটি বৈধ Event অবশ্যই ad_identifiers অথবা user_data মধ্যে অন্তত একটি থাকতে হবে।

এখানে সেই প্রতিক্রিয়া ক্ষেত্রগুলি রয়েছে যেগুলিতে সতর্কতা এবং ত্রুটির তথ্য থাকে।

warning_info
WarningCount অবজেক্টের একটি তালিকা। প্রতিটি WarningCount সতর্কতার ধরনসহ একটি reason এবং সেই ধরনের সতর্কতা থাকা রেকর্ডের সংখ্যা নির্দেশকারী একটি record_count থাকে।
error_info
ErrorCount অবজেক্টের একটি তালিকা। প্রতিটি ErrorCount ত্রুটির ধরনসহ একটি reason এবং সেই ধরনের ত্রুটির কারণে ব্যর্থ হওয়া রেকর্ডের সংখ্যা নির্দেশকারী একটি record_count থাকে।