কারণ নির্ণয়

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

  1. ইভেন্ট পাঠাতে বা শ্রোতা সদস্যদের পাঠাতে বা সরানোর জন্য অনুরোধ জারি করুন।
  2. প্রতিটি IngestEventsResponse , IngestAudienceMembersResponse বা RemoveAudienceMembersResponse থেকে request_id ক্যাপচার করুন।
  3. প্রতিটি request_id এর জন্য একটি RetrieveRequestStatus অনুরোধ পাঠান।
  4. প্রতিটি RetrieveRequestStatusResponse পর্যালোচনা করে নিশ্চিত করুন যে আপনার আপলোডগুলি সঠিকভাবে কাজ করছে এবং আপনার ডেটার সাথে কোনো সমস্যা চিহ্নিত করুন৷
  5. সঠিক তথ্য সমস্যা.
  6. ধাপ 1 এ ফিরে যান এবং যতক্ষণ না আপনি আপনার আপলোডের সমস্ত সমস্যার সমাধান না করেন ততক্ষণ পুনরাবৃত্তি করুন।

অনুরোধ গঠন

একটি RetrieveRequestStatusRequest একটি একক request_id ক্ষেত্র আছে। ইনজেশন অনুরোধ পাঠানোর সময় আপনি ক্যাপচার করা প্রতিটি অনুরোধ আইডির জন্য একটি অনুরোধ পাঠান।

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

RetrieveRequestStatusResponse এর request_status_per_destination সংশ্লিষ্ট ইনজেশন অনুরোধে প্রতিটি গন্তব্যের জন্য একটি পৃথক এন্ট্রি রয়েছে।

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

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

প্রথম পদক্ষেপ হিসাবে, RequestStatusPerDestination এর destination জন্য ডেটা ম্যানেজার API ডেটা প্রক্রিয়াকরণ শেষ করেছে কিনা তা নির্ধারণ করতে 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 আইডিগুলির সংখ্যা নিশ্চিত করতে pair_id_count পরীক্ষা করুন৷

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

audience_members_removal_status ক্ষেত্রটি পপুলেট করা হয় যদি অনুরোধটি একটি RemoveAudienceMembersRequest হয়। প্রতিটি ধরনের দর্শকের ডেটা পরীক্ষা করার জন্য এখানে 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 ডেটা এবং AdIdentifiers যেমন gclid থাকে এবং UserIdentifier ডেটা ডিক্রিপ্ট করা না যায়, তবে ডেটা ম্যানেজার 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 নির্দেশ করে যে সেই ধরনের ত্রুটির কারণে ব্যর্থ হওয়া রেকর্ডের সংখ্যা।