آمار فروش بلیت
هدف در آوردن تعداد فروش بلیت بر اساس یه سری ورودی هست.
ممکنه کمپینی اجرا شده باشه، که در نهایت لینک رویدادی که دارای utm و موارد این چنینی در لینک گنجانده شده است به دست کاربر می رسد. از این طریق ممکنه فروشی رخ بده و کاربر مورد نظر اقدام به خرید بلیتی کند.
هدف در آوردن تعداد این گروه از شرکت کنندگان است.
برای دریافت تعداد فروش به این شکل عمل می کنیم:
GET https://api.evand.com/statistics/total-sold-tickets
{
"total": 0,
"since_last_x_days": 30
}
در این مثال هیچ پارامتری به ریسور مورد نظر داده نشده است و اتفاقی که می افته اینه که بصورت پیش فرض کل فروش ۳۰ روز گذشته رو بر می گردونه.
البته توجه کنید که یه سری فیلتر هایی روی داده های مورد نظر انجام می شه. به عنوان مثال کاربر قبل از خرید حتما باید از صفحه رویداد بازدید کرده باشه. که البته طبیعتا همه بازدید می کنن مگر اینکه دیتاش به هر دلیلی تو سیستم ثبت نشده باشه.
فید total تعداد کل فروش بلیت رو می گه.
فید since_last_x_days هم تعداد روزهای گذشته که از دیتاهاشون استفاده می شه. روزهای قبلترش لحاظ نمی شن.
پارامتر های ورود که این ریسورس می گیره به این شرح است:
- پارامتر query که هم می تونه متن باشه و یا آرایه ای از متن ها. مقدار query هم اگه لیستی از متن باشه، چک می شه این مقادیر در لینک ها باشن. ولی بدین صورت نیست که حتما همه ی متن ها در لینک مورد نظر باشه. فقط یکی از متن ها هم در لینک وجود داشته باشه، باعث می شه فروش مورد نظر حساب بشه.
- پارامتر since_last_x_days که عددی از روزهایی گذشته است که می خواهید دیتاهای آن روزها لحاظ بشن. در صورتی که مقداری برای پارامتر since_last_x_days تعیین نکنید، مقدار پیش فرض ۳۰ روز استفاده خواهد شد.
تعیین یک کوئری برای محدود کردن نتایج:
GET https://api.evand.com/statistics/total-sold-tickets?query=utm=xyz
{
"total": 0,
"since_last_x_days": 30
}
تعیین دسته ای از کوئری ها برای محدود کردن نتایج:
GET https://api.evand.com/statistics/total-sold-tickets?query[]=utm=xyz&query[]=utm=abc
{
"total": 0,
"since_last_x_days": 30
}
محدود کردن نتایج به ۱۰ روز گذشته:
GET https://api.evand.com/statistics/total-sold-tickets?since_last_x_days=10
{
"total": 0,
"since_last_x_days": 10
}
نمونه مثالی که همه‌ی پارامتر ها رو با هم ارسال می کنه:
GET https://api.evand.com/statistics/total-sold-tickets?since_last_x_days=5&query[]=utm=xyz&query[]=utm=abc
و یا
GET https://api.evand.com/statistics/total-sold-tickets?since_last_x_days=5&query=utm=xyz
توکن اهراز هویت
برای استفاده از ریسورس فوق نیاز به اثبات هویتتان دارید.
برای این منظور نیاز است پارامتر token رو از طریق کوئری استرینگ به ریسورس ها ارسال نمایید.
برای دریافت مقدار توکن لطفا با ما تماس بگیرید.
به عنوان مثال:
GET https://api.evand.com/statistics/total-sold-tickets?token=TOKEN_GOES_HERE
نظرات