سوالات متداول
سوالات رایج درباره یکپارچه‌سازی 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 برای رویدادهای حساس/بحرانی-تجاری انتخابی استفاده کنید.