پرش به مطلب اصلی
نسخه: 2.6.0

ردیابی Event

توجه

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

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

var adtraceEvent = new AdTraceEvent("abc123");
AdTrace.trackEvent(adtraceEvent);

ردیابی درآمد​

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

var adtraceEvent = new AdTraceEvent("abc123");

adtraceEvent.setRevenue(2000, "Toman");

AdTrace.trackEvent(adtraceEvent);

پارامترهای Callback​

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

برای مثال، فرض کنید URL https://www.adtrace.io/callback را برای Event با توکن abc123 ثبت کرده‌اید و این خطوط را اجرا می‌کنید:

var adtraceEvent = new AdTraceEvent("abc123");

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

AdTrace.trackEvent(adtraceEvent);

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

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

لازم به ذکر است که از placeholder های متنوعی مانند {idfa} برای iOS یا {gps_adid} برای Android پشتیبانی می‌کنیم. در Callback نتیجه‌نهایی، {idfa} با ID for Advertisers دستگاه جاری برای iOS و {gps_adid} با Google Advertising ID دستگاه جاری برای Android جایگزین خواهد شد. توجه کنید که هیچ‌یک از پارامترهای سفارشی شما را ذخیره نمی‌کنیم.

می‌توانید اطلاعات بیشتری درباره URL Callback در Callback ها بخوانید.

یادداشت

هر دو پارامتر در این متد باید رشته باشند. اگر یکی از پارامترهای ارسال‌شده رشته نباشد، جفت کلید-مقدار به لیست پارامترها اضافه نمی‌شود.

پارامترهای Event​

به‌طور مشابه با پارامترهای Callback، می‌توانید پارامترهایی اضافه کنید که Adtrace به backend Adtrace شما ارسال می‌کند. می‌توانید این مقادیر را در پنل export کنید.

این مشابه پارامترهای Callback کار می‌کند، اما با فراخوانی متد addEventParameter روی instance AdTraceEvent اضافه می‌شود:

var adtraceEvent = new AdTraceEvent("abc123");

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

AdTrace.trackEvent(adtraceEvent);
هشدار

هر دو پارامتر در این متد باید رشته باشند. اگر یکی از پارامترهای ارسال‌شده رشته نباشد، جفت کلید-مقدار به لیست پارامترها اضافه نمی‌شود.

شناسه Callback​

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

var adtraceEvent = new AdTraceEvent("abc123");

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

AdTrace.trackEvent(adtraceEvent);