ردیابی 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(12000, "Toman");
AdTrace.trackEvent(adtraceEvent);

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

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

حذف تکراری درآمد

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

AdTraceEvent adtraceEvent = new AdTraceEvent("abc123");

adtraceEvent.setRevenue(12000, "Toman");
adtraceEvent.setTransactionId("transactionId");

AdTrace.trackEvent(adtraceEvent);

پارامترهای Event

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

از پارامترهای Callback برای مقادیر داخلی و از پارامترهای partner برای مقادیری که با شرکای خارجی به اشتراک می‌گذارید استفاده کنید.

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

اگر یک URL Callback برای Event ها در پنل ثبت کرده‌اید، هر بار که Event ردیابی شود یک درخواست GET به آن URL ارسال می‌شود. می‌توانید جفت‌های کلید-مقدار را به شیء ارسال کرده و به متد trackEvent بدهید. سپس این پارامترها به URL Callback شما اضافه خواهند شد.

برای مثال، اگر URL http://www.example.com/callback را ثبت کرده‌اید، یک Event را این‌طور ردیابی می‌کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent("abc123");

adtraceEvent.addCallbackParameter("key", "value");
adtraceEvent.addCallbackParameter("foo", "bar");

AdTrace.trackEvent(adtraceEvent);

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

http://www.example.com/callback?key=value&foo=bar

Adtrace از placeholder های متنوعی مانند {idfa} برای iOS یا {gps_adid} برای Android پشتیبانی می‌کند.

توجه

هیچ‌یک از پارامترهای سفارشی شما را ذخیره نمی‌کنیم. فقط آن‌ها را به Callback های شما اضافه می‌کنیم. اگر Callback برای Event ثبت نکرده‌اید، این پارامترها خوانده نمی‌شوند.

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

می‌توانید Event هایی با مقادیر دلخواه ارسال کنید. این مشابه پارامترهای Callback کار می‌کند؛ با فراخوانی متد addEventParameter روی instance AdTraceEvent اضافه می‌شوند:

AdTraceEvent adtraceEvent = new AdTraceEvent("abc123");

adtraceEvent.addValueParameter("key", "value");
adtraceEvent.addValueParameter("foo", "bar");

AdTrace.trackEvent(adtraceEvent);

شناسه Callback برای Event

می‌توانید شناسه‌های رشته‌ای سفارشی به هر Event اضافه کنید. این شناسه را در Callback های Event گزارش می‌دهیم و به شما می‌گوییم کدام Event با موفقیت ردیابی شده. با فراخوانی متد setCallbackId روی instance AdTraceEvent آن را تنظیم کنید:

AdTraceEvent adtraceEvent = new AdTraceEvent("abc123");

adtraceEvent.setCallbackId("Your-Custom-Id");

AdTrace.trackEvent(adtraceEvent);