آمار بازدید رویداد، کمپین

بعد از اجرای کمپین ای، برای دریافت آمار بازدید مربوط به کمپین اجرا شده، می شه به طریق ای که در زیر توضیح داده می شه، بدست آورد:

قابلیتی که این ریسورس داره اینه که می شه در لینک مربوط به رویداد جست و جو کرد. در اصل وقتی کمپین ای اجرا می شه، موارد یکتایی در لینک رویداد مثل utm و امثالش اضافه می شه.
که با جست و جوی این موارد می شه به تعداد بازدید مربوطه دست پیدا کرد.

برای دریافت تعداد بازدید به این شکل عمل می کنیم:

GET https://api.evand.com/statistics/total-event-page-visits

{

"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-event-page-visits?query=utm=xyz

{

"total": 0,

"since_last_x_days": 30

}

تعیین دسته ای از کوئری ها برای محدود کردن نتایج:

GET https://api.evand.com/statistics/total-event-page-visits?query[]=utm=xyz&query[]=utm=abc

{

"total": 0,

"since_last_x_days": 30

}

محدود کردن نتایج به ۱۰ روز گذشته:

GET https://api.evand.com/statistics/total-event-page-visits?since_last_x_days=10

{

"total": 0,

"since_last_x_days": 10

}

نمونه مثالی که همه‌ی پارامتر ها رو با هم ارسال می کنه:

GET https://api.evand.com/statistics/total-event-page-visits?since_last_x_days=5&query[]=utm=xyz&query[]=utm=abc

و یا

GET https://api.evand.com/statistics/total-event-page-visits?since_last_x_days=5&query=utm=xyz

توکن اهراز هویت

برای استفاده از ریسورس فوق نیاز به اثبات هویتتان دارید.

برای این منظور نیاز است پارامتر token رو از طریق کوئری استرینگ به ریسورس ها ارسال نمایید.

برای دریافت مقدار توکن  لطفا با ما تماس بگیرید.

به عنوان مثال:

GET https://api.evand.com/statistics/total-event-page-visits?token=TOKEN_GOES_HERE