تشخیص

در اینجا گردش کار توصیه شده برای تأیید صحت بارگذاری‌های رویداد و مخاطبان و شناسایی مشکلات داده‌های شما آمده است.

  1. درخواست هایی برای ارسال رویدادها یا ارسال یا حذف اعضای مخاطب صادر کنید.
  2. request_id از هر IngestEventsResponse ، IngestAudienceMembersResponse ، یا RemoveAudienceMembersResponse بگیرید.
  3. برای هر request_id یک درخواست RetrieveRequestStatus ارسال کنید.
  4. هر RetrieveRequestStatusResponse را بررسی کنید تا تأیید کنید که آپلودهای شما به درستی کار می کنند و هرگونه مشکلی را در مورد داده های خود شناسایی کنید.
  5. مشکلات داده را تصحیح کنید.
  6. به مرحله 1 برگردید و تکرار کنید تا زمانی که همه مشکلات مربوط به آپلودهای خود را برطرف کنید.

ساخت درخواست ها

یک RetrieveRequestStatusRequest دارای یک فیلد request_id است. برای هر شناسه درخواستی که هنگام ارسال درخواست‌های انتقال دریافت کرده‌اید، یک درخواست ارسال کنید.

بررسی پاسخ ها

request_status_per_destination در یک RetrieveRequestStatusResponse حاوی یک ورودی جداگانه برای هر مقصد در درخواست جذب مربوطه است.

به عنوان مثال، اگر IngestAudienceMembersRequest شما حاوی 3 ورودی در لیست destinations برای ارسال داده به 3 مخاطب مختلف باشد، پاسخ وضعیت شامل 3 ورودی در request_status_per_destination (یک ورودی برای هر مخاطب) خواهد بود.

وضعیت کلی مقصد را بررسی کنید

در مرحله اول، فیلد request_status را بررسی کنید تا مشخص شود آیا API مدیر داده پردازش داده‌ها را برای destination RequestStatusPerDestination به پایان رسانده است. در اینجا مقادیر احتمالی request_status آمده است:

  • PROCESSING : داده های مقصد هنوز در حال پردازش است.
  • SUCCESS : پردازش درخواست برای مقصد بدون هیچ خطایی تکمیل شد.
  • FAILURE : همه رکوردهای مقصد به دلیل خطا ناموفق بود.
  • PARTIAL_SUCCESS : برخی از رکوردهای مقصد موفق شدند، اما برخی دیگر به دلیل اشتباهات ناموفق بودند.

وضعیت رویداد یا مخاطب را در هر مقصد بررسی کنید

فیلد وضعیت مربوط به نوع درخواست انتقال را بررسی کنید. فقط یکی از فیلدهای زیر در هر RequestStatusPerDestination تنظیم شده است:

وضعیت بلع رویدادها

اگر درخواست IngestEventsRequest باشد، فیلد events_ingestion_status پر می‌شود.

record_count IngestEventStatus را بررسی کنید تا تأیید کنید که تعداد کل رکوردهای دریافت شده مطابق با انتظارات شما است. record_count شامل رکوردهای موفق و ناموفق می شود.

وضعیت جذب اعضای مخاطب

اگر درخواست IngestAudienceMembersRequest باشد، فیلد audience_members_ingestion_status پر می شود. در اینجا فیلد IngestAudienceMembersStatus برای بررسی هر نوع داده مخاطب وجود دارد. فقط یکی از این فیلدها تنظیم شده است.

user_data_ingestion_status

record_count از IngestUserDataStatus را بررسی کنید تا تأیید کنید که تعداد کل رکوردهای دریافت شده مطابق با انتظارات شما است. record_count شامل رکوردهای موفق و ناموفق می شود.

user_identifier_count را بررسی کنید تا تأیید کنید که تعداد شناسه‌های کاربر دریافتی مطابق با انتظارات شما است.

اگر درخواست دارای تعداد کافی رکورد بود، محدوده upload_match_rate_range شامل محدوده نرخ تطابق برای رکوردهای موجود در درخواست است.

mobile_data_ingestion_status

record_count IngestMobileDataStatus را بررسی کنید تا تأیید کنید که تعداد کل رکوردهای دریافت شده مطابق با انتظارات شما است. record_count شامل رکوردهای موفق و ناموفق می شود.

mobile_id_count را بررسی کنید تا تأیید کنید که تعداد شناسه‌های تلفن همراه دریافتی مطابق با انتظارات شما است.

pair_data_ingestion_status

record_count از IngestPairDataStatus را بررسی کنید تا تأیید کنید که تعداد کل رکوردهای دریافت شده مطابق با انتظارات شما است. record_count شامل رکوردهای موفق و ناموفق می شود.

pair_id_count را بررسی کنید تا تأیید کنید تعداد شناسه‌های PAIR دریافت شده مطابق با انتظارات شما است.

وضعیت حذف اعضای مخاطب

اگر درخواست 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 را بررسی کنید تا تعداد کل شناسه‌های کاربر، شناسه‌های تلفن همراه، یا شناسه‌های PAIR دریافت شده را تأیید کنید.

هشدارها و خطاها را بررسی کنید

علاوه بر فیلدهای وضعیت مقصد و نوع درخواست، RetrieveRequestStatusResponse حاوی تفکیک هشدارها و خطاهای درخواست است.

  • یک خطا نشان می دهد که API به طور کامل رکورد را رد کرده است.
  • یک هشدار نشان می‌دهد که API رکورد را رد نکرده است، اما باید بخش‌هایی از داده‌های رکورد را نادیده می‌گیرد.

برای مثال، اگر یک Event حاوی داده‌های UserIdentifier رمزگذاری‌شده و AdIdentifiers مانند gclid باشد، و داده‌های UserIdentifier قابل رمزگشایی نباشد، 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 است که تعداد رکوردهایی را نشان می دهد که به دلیل آن نوع خطا شکست خورده اند.