ردیابی Event

توجه

قبل از ارسال هر Event، مطمئن شوید "install" با موفقیت ثبت شده. اگر "install" برای اپلیکیشن روی دستگاه ثبت نشده باشد، Adtrace Event های شما را دریافت و ذخیره می‌کند، اما در آمار پنل نمایش داده نخواهند شد.

ردیابی Event

می‌توانید از Adtrace برای ردیابی هر Event در اپلیکیشن خود استفاده کنید. فرض کنید می‌خواهید هر بار که روی یک دکمه ضربه می‌زنند را ردیابی کنید. باید یک توکن Event جدید در پنل ایجاد کنید. فرض کنید توکن Event abc123 است. در متد کنترل‌کننه کلیک دکمه می‌توانید خطوط زیر را اضافه کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent('abc123');
AdTrace.trackEvent(adtraceEvent);

ردیابی درآمد

اگر کاربران شما می‌توانند با کلیک روی تبلیغات یا خرید درون‌برنامه‌ای درآمد ایجاد کنند، می‌توانید این درآمدها را با Event ها ردیابی کنید. فرض کنید یک ضربه ارزش یک سنت اروپایی دارد. می‌توانید Event درآمد را این‌طور ردیابی کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent('abc123');
adtraceEvent.setRevenue(6, 'Toman');
AdTrace.trackEvent(adtraceEvent);

البته می‌توان این را با پارامترهای Callback ترکیب کرد.

هنگامی که یک توکن ارز تنظیم می‌کنید، Adtrace به‌طور خودکار درآمدهای دریافتی را به واحد گزارش‌دهی مورد نظر شما تبدیل می‌کند.

پارامترهای سفارشی

علاوه بر داده‌هایی که Adtrace SDK به‌طور پیش‌فرض جمع‌آوری می‌کند، می‌توانید از Adtrace SDK برای ردیابی و اضافه کردن هر تعداد مقدار سفارشی مورد نیاز (شناسه کاربر، شناسه محصول و غیره) به Event/Session استفاده کنید. پارامترهای سفارشی فقط به‌صورت داده خام در دسترس هستند (یعنی در پنل Adtrace نمایش داده نخواهند شد).

باید از پارامترهای Callback برای مقادیری که برای استفاده داخلی جمع‌آوری می‌کنید و از پارامترهای partner برای مقادیری که می‌خواهید با شرکای خارجی به اشتراک بگذارید استفاده کنید. اگر مقداری (مثل شناسه محصول) هم برای استفاده داخلی و هم برای ارسال به شرکا ردیابی می‌شود، بهترین رویه این است که آن را هم به‌عنوان پارامتر Callback و هم partner ردیابی کنید.

پارامترهای Callback برای Event

می‌توانید یک URL Callback برای Event های خود در پنل ثبت کنید. هر بار که Event ردیابی شود، یک درخواست GET به آن URL ارسال می‌شود. می‌توانید با فراخوانی addCallbackParameter روی instance Event قبل از ردیابی آن، پارامترهای Callback اضافه کنید. سپس این پارامترها به URL Callback شما اضافه خواهند شد.

برای مثال، فرض کنید URL https://www.adtrace.com/callback را ثبت کرده‌اید، سپس یک Event را این‌طور ردیابی می‌کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent('abc123');
adtraceEvent.addCallbackParameter('key', 'value');
adtraceEvent.addCallbackParameter('foo', 'bar');
AdTrace.trackEvent(adtraceEvent);

در این صورت، Event را ردیابی کرده و درخواستی به این آدرس ارسال می‌کنیم:

https://www.adtrace.com/callback?key=value&foo=bar

لازم به ذکر است که از placeholder های متنوعی مثل {gps_adid} پشتیبانی می‌کنیم که می‌توانند به‌عنوان مقادیر پارامتر استفاده شوند. در Callback نتیجه‌نهایی، این placeholder با Google Play Services ID دستگاه جاری جایگزین خواهد شد. همچنین توجه کنید که هیچ‌یک از پارامترهای سفارشی شما را ذخیره نمی‌کنیم، بلکه فقط آن‌ها را به Callback های شما اضافه می‌کنیم. اگر Callback برای Event ثبت نکرده‌اید، این پارامترها اصلاً خوانده نخواهند شد.

می‌توانید اطلاعات بیشتری درباره استفاده از URL Callback، از جمله فهرست کامل مقادیر موجود، در راهنمای Callback ها بخوانید.

پارامترهای مقدار Event

همچنین می‌توانید پارامترهایی اضافه کنید که با Event ارسال شوند و در پنل Adtrace فعال‌سازی شده باشند.

AdTraceEvent adtraceEvent = new AdTraceEvent('abc123');
adtraceEvent.addEventParameter('key', 'value');
adtraceEvent.addEventParameter('foo', 'bar');
AdTrace.trackEvent(adtraceEvent);

شناسه Callback برای Event

همچنین می‌توانید به هر Event که می‌خواهید ردیابی کنید یک شناسه رشته‌ای سفارشی اضافه کنید. این شناسه بعداً در Success callbacks و/یا Failure callbacks مربوط به Event گزارش می‌شود تا بدانید کدام Event با موفقیت ردیابی شده. می‌توانید این شناسه را با تنظیم عضو callbackId روی instance Event تنظیم کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent('abc123');
adtraceEvent.callbackId = '{CallbackId}';
AdTrace.trackEvent(adtraceEvent);