কারণ নির্ণয়

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

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

2. প্রতিটি অনুরোধের সামগ্রিক অবস্থা পরীক্ষা করুন। একটি সফল অনুরোধের একটি Status থাকে যার code 0 এর সমান (enum value OK , HTTP response 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 এ ৩টি এন্ট্রি থাকবে (প্রতি দর্শকের জন্য একটি এন্ট্রি)।

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

প্রথম ধাপ হিসেবে, ডেটা ম্যানেজার API RequestStatusPerDestination এর destination জন্য ডেটা প্রক্রিয়াকরণ সম্পন্ন করেছে কিনা তা নির্ধারণ করতে request_status ক্ষেত্রটি পরীক্ষা করুন। request_status এর সম্ভাব্য মানগুলি এখানে দেওয়া হল:

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

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

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

• events_ingestion_status
• audience_members_ingestion_status
• audience_members_removal_status

ইভেন্ট ইনজেশনের অবস্থা

যদি অনুরোধটি একটি 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 চেক করুন।

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

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

user_data_removal_status

ব্যবহারকারীর ডেটা অপসারণের অবস্থা।

mobile_data_removal_status

মোবাইল ডেটা অপসারণের অবস্থা।

pair_data_removal_status

PAIR ডেটা অপসারণের অবস্থা।

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

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

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

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

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

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

তবে, যদি Event AdIdentifiers না থাকে এবং UserIdentifier ডেটা ডিক্রিপ্ট করা না যায়, তাহলে Data Manager 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 থাকে যা সেই ধরণের ত্রুটির কারণে ব্যর্থ রেকর্ডের সংখ্যা নির্দেশ করে।