پرش به مطلب اصلی

سوالات متداول

سوالات رایج درباره یکپارچه‌سازی server-to-server Adtrace.

اگر gps_adid برابر null، خالی یا نامعتبر باشد چه باید کنم؟​

فقط به خاطر نبودن gps_adid ارسال رویداد S2S را مسدود نکنید. به جای آن adtrace_adid را ارسال کنید.

دلایل رایج عدم دسترسی به gps_adid:

  • کاربر شخصی‌سازی تبلیغات را غیرفعال کرده است.
  • دستگاه Google Play Services ندارد.
  • پیاده‌سازی SDK/دستگاه Advertising ID را به درستی برنگردانده است.

ترتیب fallback توصیه‌شده در Android:

۱. از adtrace_adid استفاده کنید (شناسه اصلی توصیه‌شده). ۲. از gps_adid فقط هنگامی که در دسترس و معتبر است استفاده کنید.

اگر هر دو موجود نیستند، ابتدا ردیابی نصب و لاگ‌های SDK را تأیید کنید، سپس پس از دریافت یک شناسه معتبر دوباره ارسال کنید.

آیا می‌توانیم رویدادهای S2S را فقط با googleAdId و بدون یکپارچه‌سازی Adtrace SDK ارسال کنیم؟​

خیر. S2S جایگزین یکپارچه‌سازی SDK نمی‌شود.

قبل از پذیرش هر رویداد S2S، Adtrace باید یک نصب موفق برای آن دستگاه داشته باشد. در عمل، ردیابی قابل اطمینان نصب/session نیاز به یکپارچه‌سازی SDK در اپ یا صفحه وب دارد.

از این مدل استفاده کنید:

  • نصب/session و رویدادهای معمول را از SDK ارسال کنید.
  • رویدادهای حساس یا اعتبارسنجی‌شده سمت سرور (مثلاً خریدها) را از طریق S2S ارسال کنید.

این رویکرد بار backend را کاهش می‌دهد و تضمین‌های retry/queue سمت کلاینت از SDK را حفظ می‌کند.

باید از adtrace_adid یا شناسه‌های پلتفرم مثل gps_adid/idfa/web_uuid استفاده کنم؟​

هر زمان که ممکن است از adtrace_adid استفاده کنید.

چرا adtrace_adid ارجح است:

  • توسط Adtrace به ازای هر دستگاه پس از نصب موفق تولید می‌شود.
  • در تمام پلتفرم‌ها به طور یکسان کار می‌کند.
  • از مشکلات دسترسی خاص پلتفرم اجتناب می‌کند.

از شناسه‌های پلتفرم به عنوان fallback استفاده کنید:

  • Android: gps_adid
  • iOS: idfa
  • Web: web_uuid

S2S را با موفقیت فراخوانی کردم. معنای پاسخ چیست؟​

پاسخ‌های S2S وضعیت پردازش درخواست را تأیید می‌کنند (پذیرفته‌شده/رد‌شده). آن‌ها یک endpoint گزارش کامل رویداد نیستند.

  • موفقیت نشان می‌دهد Adtrace payload را پذیرفته و پردازش کرده است.
  • خطاها نشان می‌دهند چه چیزی باید اصلاح شود (احراز هویت، allowlist، نصب گم‌شده، IDهای گم‌شده و غیره).

برای اعتبارسنجی رویداد از موارد زیر استفاده کنید:

۱. لاگ‌های SDK (نصب/session/رویداد) ۲. Testing Console در پنل ۳. گزارش‌دهی Dashboard پس از پردازش

خطای Authorization failed دریافت می‌کنم. چه چیزی را بررسی کنم؟​

به ترتیب موارد زیر را بررسی کنید:

۱. تأیید کنید فرمت header دقیقاً این است: Authorization: Token YOUR_S2S_API_KEY ۲. تأیید کنید کلید API صحیح را از تنظیمات پنل کپی کرده‌اید. ۳. تأیید کنید هیچ فضای اضافی/خط جدیدی هنگام کپی کردن وارد نشده است. ۴. تأیید کنید IP خروجی سرور شما در IP allowlist پنل است. ۵. با مثال دقیق curl از رویدادهای server-to-server دوباره تست کنید.

اگر هنوز شکست می‌خورد، درخواست دقیق curl (با اطلاعات محرمانه ماسک‌شده) و جزئیات پاسخ را با مخاطب پشتیبانی Adtrace خود در میان بگذارید.

آیا Adtrace می‌تواند درخواست S2S شکست‌خورده من را ردیابی کند؟​

پشتیبانی می‌تواند کمک کند، اما به یک نمونه درخواست قابل بازتولید نیاز دارند.

موارد زیر را به اشتراک بگذارید:

  • دستور کامل curl (مقادیر API key/token را ماسک کنید)
  • بدنه کامل پاسخ و کد وضعیت
  • Timestamp و منطقه زمانی درخواست
  • IP عمومی سرور منبع

بدون این ورودی‌ها، تحلیل علت ریشه‌ای معمولاً حدسی است.

آیا یکپارچه‌سازی‌های iOS می‌توانند فقط با REST APIها (بدون SDK) پیاده‌سازی شوند؟​

از نظر فنی می‌توانید انواع رویداد زیادی را از طریق S2S ارسال کنید، اما جایگزینی کامل SDK توصیه نمی‌شود.

دلیل: Adtrace دستگاه‌ها را بر اساس داده‌های موفق نصب/session ابتدا شناسایی می‌کند. اگر SDK را نادیده بگیرید، باید منطق جمع‌آوری نصب/session را خودتان بازسازی کنید (context دستگاه/شبکه، زمان‌بندی lifecycle، retry‌ها و غیره) که پیچیدگی موبایل و backend را افزایش می‌دهد.

رویکرد توصیه‌شده:

۱. از iOS SDK برای نصب/session و اندازه‌گیری پایه استفاده کنید. ۲. از S2S برای رویدادهای حساس/بحرانی-تجاری انتخابی استفاده کنید.