ইন-অ্যাপ পরিসংখ্যান

দুটি মেথড তাত্ক্ষণিক ইন-অ্যাপ ক্যাম্পেইন এর জন্য পরিসংখ্যান প্রদান করে। এক বা একাধিক ক্যাম্পেইনের জন্য মোট সময়কালের জন্য inapps:totals ব্যবহার করুন, এবং একটি একক ক্যাম্পেইনের টাইম সিরিজের জন্য inapps:timeline ব্যবহার করুন। এই মানগুলি কন্ট্রোল প্যানেলের ইন-অ্যাপ পরিসংখ্যান স্ক্রিন এর সাথে মিলে যায়।

মেট্রিক্স

ক্ষেত্র	টাইপ	বিবরণ
`impressions`	number	ইন-অ্যাপটি কতবার প্রদর্শিত হয়েছে। কন্ট্রোল প্যানেলে Impressions হিসাবে লেবেলযুক্ত।
`unique_impressions`	number	ইন-অ্যাপটি যতগুলি ইউনিক ডিভাইসে প্রদর্শিত হয়েছে তার সংখ্যা।
`interactions`	number	ইন-অ্যাপ কন্টেন্টের সাথে ইন্টারঅ্যাকশন: বোতাম ক্লিক, লিঙ্ক ক্লিক এবং ফর্ম জমা।
`unique_interactions`	number	ইন-অ্যাপের সাথে ইন্টারঅ্যাক্ট করা ইউনিক ডিভাইসের সংখ্যা।
`skips`	number	ব্যবহারকারীরা ইন্টারঅ্যাক্ট না করে কতবার ইন-অ্যাপটি বাতিল করেছেন।
`audience`	number	নির্দিষ্ট সময়কালে কোনো ইন-অ্যাপ ইভেন্ট তৈরি করা ইউনিক ডিভাইসের সংখ্যা।

inapps:totals

সময়কালের জন্য মোট ফলাফল প্রদান করে। নির্দিষ্ট ক্যাম্পেইনের উপর রিপোর্ট করার জন্য inapp_codes পাস করুন, অথবা অ্যাপ্লিকেশনটির প্রতিটি ইন-অ্যাপ পৃষ্ঠা অনুসারে দেখার জন্য এটি বাদ দিন। একটি নির্ধারিত এক্সপোর্টের জন্য এটি ব্যবহার করার পদ্ধতি।

POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals

হেডার

নাম	প্রয়োজনীয়	বিবরণ
`Authorization`	হ্যাঁ	`Authorization: Api <Server Key>` ফরম্যাটে সার্ভার API টোকেন।

রিকোয়েস্ট বডি প্যারামিটার

নাম	প্রয়োজনীয়	টাইপ	বিবরণ
`application`	হ্যাঁ	String	অ্যাপ্লিকেশন কোড।
`date_range`	হ্যাঁ	Object	রিপোর্টিং সময়কাল। `date_from` এবং `date_to` `YYYY-MM-DD` ফরম্যাট ব্যবহার করে এবং অন্তর্ভুক্ত। সময়কাল UTC-তে গণনা করা হয় এবং ৩৬৬ দিনের বেশি হওয়া উচিত নয়।
`inapp_codes`	না	Array	ইন-অ্যাপ কোড, প্রতি রিকোয়েস্টে ১০০ পর্যন্ত। অ্যাপ্লিকেশনের সমস্ত ইন-অ্যাপে রিপোর্ট করার জন্য বাদ দিন। তালিকার কোনো কোড অ্যাপ্লিকেশনের অন্তর্গত না হলে, পুরো রিকোয়েস্টটি `404` দিয়ে ব্যর্থ হয়।
`platforms`	না	Array	এই প্ল্যাটফর্মগুলিতে মেট্রিক্স সীমাবদ্ধ করুন। সম্ভাব্য মান: `"IOS"`, `"ANDROID"`, `"HUAWEI_ANDROID"`, `"AMAZON"`, `"OSX"`, `"WINDOWS"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"WEB"`।
`with_platforms`	না	Boolean	প্রতিটি আইটেমে একটি প্রতি-প্ল্যাটফর্ম ব্রেকডাউন যোগ করুন।
`page`	না	Integer	পৃষ্ঠা নম্বর, `0` থেকে শুরু। যখন `inapp_codes` বাদ দেওয়া হয় তখন প্রযোজ্য।
`per_page`	না	Integer	প্রতি পৃষ্ঠায় আইটেম, ডিফল্টভাবে `20`, সর্বোচ্চ `100`।

উদাহরণ রিকোয়েস্ট

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-31"
    },
    "inapp_codes": ["AAAAA-BBBBB"],
    "with_platforms": true
  }'

রেসপন্স ক্ষেত্র

total হল রিকোয়েস্টের সাথে মিলে যাওয়া ইন-অ্যাপের সংখ্যা। যখন inapp_codes বাদ দেওয়া হয়, তখন এটি অ্যাপ্লিকেশনের সমস্ত ইন-অ্যাপ, তাই পেজিনেশন এটি অতিক্রম করতে পারে। items বর্তমান পৃষ্ঠা ধারণ করে। page 0 থেকে গণনা করা হয়।

উদাহরণ রেসপন্স

{
  "total": 1,
  "page": 0,
  "per_page": 20,
  "items": [{
    "inapp": {
      "code": "AAAAA-BBBBB",
      "name": "Summer sale",
      "status": "active",
      "rich_media_code": "CCCCC-DDDDD"
    },
    "metrics": {
      "impressions": 15230,
      "unique_impressions": 9120,
      "interactions": 2311,
      "unique_interactions": 1980,
      "skips": 640,
      "audience": 9120
    },
    "platforms": [{
      "platform": "IOS",
      "metrics": {
        "impressions": 8100,
        "unique_impressions": 4900,
        "interactions": 1300,
        "unique_interactions": 1120,
        "skips": 310,
        "audience": 4900
      }
    }],
    "frequency_capping": {
      "suppressions": 45,
      "affected_users": 30,
      "data_available_from": "2026-07-17"
    }
  }]
}

inapps:timeline

একটি ইন-অ্যাপ ক্যাম্পেইনের জন্য সময়কালের মোট এবং একটি টাইম সিরিজ প্রদান করে।

POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline

রিকোয়েস্ট বডি প্যারামিটার

নাম	প্রয়োজনীয়	টাইপ	বিবরণ
`application`	হ্যাঁ	String	অ্যাপ্লিকেশন কোড।
`inapp_code`	হ্যাঁ	String	ইন-অ্যাপ কোড।
`date_range`	হ্যাঁ	Object	রিপোর্টিং সময়কাল। `date_from` এবং `date_to` `YYYY-MM-DD` ফরম্যাট ব্যবহার করে এবং অন্তর্ভুক্ত। সময়কাল UTC-তে গণনা করা হয় এবং ৩৬৬ দিনের বেশি হওয়া উচিত নয়। ঐচ্ছিক `interval`: `"HOUR"`, `"DAY"` (ডিফল্ট), `"WEEK"` বা `"MONTH"`। `"HOUR"` ৩১ দিন পর্যন্ত সময়কালের জন্য উপলব্ধ।
`platforms`	না	Array	এই প্ল্যাটফর্মগুলিতে মেট্রিক্স সীমাবদ্ধ করুন।
`with_platforms`	না	Boolean	মোট এবং প্রতিটি সারিতে একটি প্রতি-প্ল্যাটফর্ম ব্রেকডাউন যোগ করুন।

উদাহরণ রিকোয়েস্ট

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "inapp_code": "AAAAA-BBBBB",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-07",
      "interval": "DAY"
    }
  }'

উদাহরণ রেসপন্স

{
  "inapp": {
    "code": "AAAAA-BBBBB",
    "name": "Summer sale",
    "status": "active",
    "rich_media_code": "CCCCC-DDDDD"
  },
  "totals": {
    "impressions": 15230,
    "unique_impressions": 9120,
    "interactions": 2311,
    "unique_interactions": 1980,
    "skips": 640,
    "audience": 9120
  },
  "frequency_capping": {
    "suppressions": 45,
    "affected_users": 30,
    "data_available_from": "2026-07-17"
  },
  "rows": [{
    "timestamp": "2026-07-01T00:00:00Z",
    "metrics": {
      "impressions": 2140,
      "unique_impressions": 1700,
      "interactions": 320,
      "unique_interactions": 290,
      "skips": 95,
      "audience": 1700
    }
  }],
  "impression_duration": [
    { "from_seconds": 0, "to_seconds": 5, "count": 3200 },
    { "from_seconds": 5, "to_seconds": 15, "count": 5400 },
    { "from_seconds": 15, "to_seconds": 30, "count": 4100 },
    { "from_seconds": 30, "to_seconds": 0, "count": 2530 }
  ]
}

impression_duration ইন-অ্যাপটি স্ক্রিনে কতক্ষণ ছিল তা ভাগ করে। শেষ বাকেটে to_seconds হল 0, যার অর্থ “৩০ সেকেন্ড এবং তার বেশি”।

ফ্রিকোয়েন্সি ক্যাপিং

frequency_capping ব্লকটি ফ্রিকোয়েন্সি ক্যাপিং দ্বারা প্রতিরোধ করা ইন-অ্যাপ প্রদর্শন এবং প্রভাবিত ইউনিক ব্যবহারকারীর সংখ্যা রিপোর্ট করে। সাপ্রেশনগুলি impressions-এ গণনা করা হয় না।

সেই তারিখের আগে সাপ্রেশন রেকর্ড করা হয়নি। একটি সময়কালের জন্য যা আগে শেষ হয়, frequency_capping ব্লকটি শূন্যের পরিবর্তে null হিসাবে ফিরে আসে, তাই ডেটার অভাবকে কখনই এমন ক্যাপিং হিসাবে ভুল করা হয় না যা কিছুই সাপ্রেস করেনি। রেসপন্সে data_available_from প্রথম কভার করা দিনটি উল্লেখ করে। ফ্রিকোয়েন্সি ক্যাপিং-এর কোনো প্রতি-প্ল্যাটফর্ম ব্রেকডাউন নেই।

ডেটা রিটেনশন

পরিসংখ্যান ৩৬৫ দিনের জন্য রাখা হয়, তাই একটি সময়কাল যা আগে শুরু হয় তা কভার না করা দিনগুলির জন্য কোনো ডেটা প্রদান করে না।

রেসপন্স কোড

কোড	অর্থ
200	সফল।
400	অবৈধ রিকোয়েস্ট: একটি অনুপস্থিত বা ভুল `date_range`, ৩৬৬ দিনের বেশি সময়কাল, ৩১ দিনের বেশি সময় ধরে একটি ঘণ্টায় ব্যবধান, অথবা ১০০-এর বেশি `inapp_codes`।
401	অনুপস্থিত বা অবৈধ API টোকেন।
404	এই অ্যাপ্লিকেশনে একটি ইন-অ্যাপ কোড পাওয়া যায়নি।