इन-ऐप आँकड़े

दो तरीके तत्काल इन-ऐप अभियानों के लिए आँकड़े लौटाते हैं। एक या अधिक अभियानों के लिए अवधि के कुल योग के लिए inapps:totals का उपयोग करें, और एक एकल अभियान की समय श्रृंखला के लिए inapps:timeline का उपयोग करें। ये मान कंट्रोल पैनल में इन-ऐप आँकड़े स्क्रीन से मेल खाते हैं।

मेट्रिक्स

फ़ील्ड	प्रकार	विवरण
`impressions`	number	इन-ऐप कितनी बार प्रदर्शित किया गया था। कंट्रोल पैनल में इंप्रेशन के रूप में लेबल किया गया।
`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`	हाँ	सर्वर API टोकन `Authorization: Api <Server Key>` प्रारूप में।

अनुरोध बॉडी पैरामीटर

नाम	आवश्यक	प्रकार	विवरण
`application`	हाँ	String	एप्लिकेशन कोड।
`date_range`	हाँ	Object	रिपोर्टिंग अवधि। `date_from` और `date_to` `YYYY-MM-DD` प्रारूप का उपयोग करते हैं और समावेशी हैं। अवधि UTC में गिनी जाती है और 366 दिनों से अधिक नहीं होनी चाहिए।
`inapp_codes`	नहीं	Array	इन-ऐप कोड, प्रति अनुरोध 100 तक। एप्लिकेशन के सभी इन-ऐप्स पर रिपोर्ट करने के लिए छोड़ दें। यदि सूची में कोई कोड एप्लिकेशन से संबंधित नहीं है, तो पूरा अनुरोध `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 में गिनी जाती है और 366 दिनों से अधिक नहीं होनी चाहिए। वैकल्पिक `interval`: `"HOUR"`, `"DAY"` (डिफ़ॉल्ट), `"WEEK"` या `"MONTH"`। `"HOUR"` 31 दिनों तक की अवधि के लिए उपलब्ध है।
`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 है, जिसका अर्थ है “30 सेकंड और उससे अधिक”।

फ़्रीक्वेंसी कैपिंग

frequency_capping ब्लॉक उन इन-ऐप डिस्प्ले की रिपोर्ट करता है जिन्हें फ़्रीक्वेंसी कैपिंग ने रोका था, और प्रभावित अद्वितीय उपयोगकर्ताओं की संख्या। सप्रेशन को impressions में नहीं गिना जाता है।

उस तारीख से पहले सप्रेशन दर्ज नहीं किए गए थे। एक अवधि के लिए जो पहले समाप्त होती है, frequency_capping ब्लॉक शून्य के बजाय null के रूप में वापस आता है, इसलिए डेटा की कमी को कभी भी कैपिंग के लिए गलत नहीं माना जाता है जिसने कुछ भी नहीं दबाया। प्रतिक्रिया में data_available_from पहले कवर किए गए दिन को बताता है। फ़्रीक्वेंसी कैपिंग में कोई प्रति-प्लेटफ़ॉर्म ब्रेकडाउन नहीं है।

डेटा प्रतिधारण

आँकड़े 365 दिनों के लिए रखे जाते हैं, इसलिए एक अवधि जो पहले शुरू होती है, वह अनकवर दिनों के लिए कोई डेटा नहीं लौटाती है।

प्रतिक्रिया कोड

कोड	अर्थ
200	सफलता।
400	अमान्य अनुरोध: एक अनुपलब्ध या विकृत `date_range`, 366 दिनों से अधिक की अवधि, 31 दिनों से अधिक का प्रति घंटा अंतराल, या 100 से अधिक `inapp_codes`।
401	अनुपलब्ध या अमान्य API टोकन।
404	इस एप्लिकेशन में एक इन-ऐप कोड नहीं मिला।