مدیریت کال‌بک‌ها

اگر بخواهم نصب‌ها یا رخدادها را به صورت سیستماتیک دریافت کنم، چه ‌کاری باید انجام دهم؟

شما از طریق داشبورد متریکس می‌توانید داده‌های خام خود را به چند طریق در اختیار داشته باشید و استفاده‌های شخصی‌سازی‌شده خود را پیش ببرید.

یکی از این روش‌های کاربردی از طریق کالبک لحظه‌ای یا همان realtime callback فراهم می‌شود.

کالبک لحظه‌ای این امکان را برای شما فراهم می‌کند که داده‌های هر مدل ایونت سیستمی (شامل نصب، نصب مجدد، تقلب، ...) و شخصی سازی شده (شامل هر ایونت دلخواهی که در داشبورد تعریف کرده‌اید) به صورت لحظه‌ای سمت سرور خود داشته باشید.

به طور مثال به عنوان واحد مارکتینگ یک کسب و کار برای تحلیل و دسته بندی کاربران خود به تمامی داده‌های مربوط به کاربران مخصوصا منبع نصب در یک پایگاه داده یکپارچه نیاز خواهم داشت، که به صورت لحظه‌ای این تحلیل و دسته‌بندی انجام شود و اکشن‌های مربوطه صورت بگیرد که متریکس این داده‌ها را به صورت لحظه‌ای در اختیار شما قرار می‌دهد.

realtime-callback

چگونه می‌توانم برای نصب‌ها و رخدادها کالبک تعریف کنم؟

در داشبورد، پس از ورود به صفحه سازمان‌ها، روی علامت تنظیمات اپلیکیشن مورد نظر خود کلیک کرده و وارد قسمت Callbacks شوید. در این قسمت می‌توانید برای هر نصب، نصب مجدد، حدف اپلیکیشن، تقلب و یا هر رخدادی که تعریف می‌کنید، url کالبک خود را به همراه پارامترهای مورد نیاز ثبت کنید.

چه پارامترهایی را می‌توانم به تعریف URL کالبک اضافه کنم؟

این پارامترها در جدول زیر قابل مشاهده هستند. هر کدام از این پارامترها را می‌توانید به دلخواه خودتان انتخاب کنید و آنها را به صورت ماکرو، در url خود اضافه کنید تا متریکس بتواند در کالبک، آنها را به سرور شما ارسال کند:

پارامتر	نوع پارامتر	توضیح پارامتر	مثال	نصب	نصب مجدد	حذف	تقلب	رخداد	کلیک
tracker_code	String	شناسه ترکر	bdjulq	✔	✔	✔	✔	✖	✔
network_name	String	نام شبکه تبلیغاتی	AdNetwork1	✔	✔	✔	✔	✔	✔
campaign_name	String	نام کمپین	Black Friday	✔	✔	✔	✔	✔	✔
adgroup_name	String	نام گروه تبلیغاتی	Video Banner	✔	✔	✔	✔	✔	✔
creative_name	String	نام خلاقه	Product Features	✔	✔	✔	✔	✔	✔
sub_id	String	ساب آیدی	83407c9a-392d-4f6b-b689-eadfe557ff18, abcdefg	✔	✔	✔	✔	✔	✔
action_name	String	نوع نصب یا ایونت یا کلیک	fraud	✔	✔	✔	✔	✔	✔
reinstalled	Boolean	آیا نصب مجدد است؟	true, false	✔	✔	✖	✖	✖	✖
rejection_reason	String	علت تقلب	anonymousIP, tooManyEngagements, clickInjection, sdkSpoofing, distributionOutlier	✖	✖	✖	✔	✖	✖
event_slug	String	شناسه ایونت	uimgx	✖	✖	✖	✖	✔	✖
app_name	String	نام packagename پیاده سازی کننده sdk	com.example.test	✔	✔	✔	✔	✔	✖
app_version	String	ورژن اپلیکیشن	1.1.2.Beta	✔	✔	✔	✔	✔	✖
device_name	String	مدل دستگاه	sm-a505f	✔	✔	✔	✔	✔	✖
device_brand	String	برند دستگاه	xiaomi	✔	✔	✔	✔	✔	✖
device_manufacturer	String	سازنده دستگاه	xiaomi	✔	✔	✔	✔	✔	✖
android_id	String	شناسه دستگاه اندروید	b9da30111528c740	✔	✔	✔	✔	✔	✖
gps_adid	String	شناسه تبلیغاتی گوگل پلی سرویس	38400000-8cf0-11bd-b23e-10b96e40000d	✔	✔	✔	✔	✔	✖
ip_address	String	آی‌پی کاربر	91.251.150.188	✔	✔	✔	✔	✔	✔
user_agent	String	یوزر ایجنت	Dalvik/2.1.0 (Linux; U; Android 10; JSN-L22 Build/HONORJSN-L22)	✔	✔	✔	✔	✔	✔
metrix_user_id	String	شناسه کاربر در متریکس	c0bcf71e-a027-4cfa-974a-e90e040e5c3a	✔	✔	✔	✔	✔	✔
created_at	Timestamp	زمان ایجاد با دقت میلی ثانیه	1403674212	✔	✔	✔	✔	✔	✖
clicked_at	Timestamp	زمان کلیک با دقت میلی ثانیه	1403568849	✔	✔	✔	✔	✖	✔
installed_at	Timestamp	زمان نصب با دقت میلی ثانیه	1404214634	✔	✔	✔	✔	✔	✖
city	String	شهر کاربر	Tehran	✔	✔	✔	✔	✔	✔
country	String	کشور کاربر	IRN	✔	✔	✔	✔	✔	✔

توجه: متریکس پارامترها را هم به صورت camelCase و هم به صورت snake_case پشتیبانی می کند.

همچنین اگر پارامتر دلخواهی دارید که هنگام کلیک توسط شما پر می‌شود و نیاز دارید تا زمان نصب یا کلیک به شما برگردد، می‌توانید آن را به صورت placeholder در لینک کالبک خود وارد کنید.

یک نمونه از کالبک نصب می‌تواند به صورت زیر باشد:

http://callbacks.myserver.com/path?clickId={clickId}&tracker_name={tracker_name}&ip_address={ip_address}

همچنین پارامترهای ست شده توسط شما درون sdk، قابلیت ارسال به سرور شما را خواهند داشت.

در صورت بروز اختلال در دریافت کالبک‌ها، آیا امکان دریافت مجدد کالبک‌های دریافت نشده وجود دارد؟

سیستم کالبک متریکس این قابلیت را دارد تا در صورتی که از سرور شما پاسخ مناسبی مبنی بر دریافت صحیح داده‌ها دریافت نکند، تا مدت نهایتا یک روز و در بازه های زمانی ۴ ساعته، کالبک ازدست‌رفته را مجددا ارسال کند. بنابراین با توجه به احتمالی که برای ارسال مجدد کالبک‌های ناموفق وجود دارد، امکان دریافت چندین باره‌‌ی یک کالبک وجود دارد. به همین علت، برای پرهیز از ناسازگاری آمار و شمارش اضافی، نیاز است که حتما یک پارامتر یکتاکننده سمت سرور شما در نظر گرفته شود.