인앱 통계

두 가지 메서드는 즉시 전송 인앱 캠페인에 대한 통계를 반환합니다. 하나 이상의 캠페인에 대한 기간 총계는 inapps:totals를 사용하고, 단일 캠페인의 시계열 데이터는 inapps:timeline을 사용합니다. 이 값들은 Control Panel의 인앱 통계 화면과 일치합니다.

지표

필드	유형	설명
`impressions`	number	인앱이 표시된 횟수입니다. Control Panel에서는 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>` 형식의 Server API token입니다.

요청 본문 파라미터

이름	필수	유형	설명
`application`	예	String	Application code입니다.
`date_range`	예	Object	보고 기간입니다. `date_from`과 `date_to`는 `YYYY-MM-DD` 형식을 사용하며 양 끝 날짜를 포함합니다. 기간은 UTC 기준으로 계산되며 366일을 초과할 수 없습니다.
`inapp_codes`	아니요	Array	요청당 최대 100개의 In-app code입니다. 생략하면 애플리케이션의 모든 인앱에 대해 보고합니다. 목록의 코드가 애플리케이션에 속하지 않으면 전체 요청이 `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	Application code입니다.
`inapp_code`	예	String	In-app code입니다.
`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에 포함되지 않습니다.

데이터 보존

통계는 365일 동안 보관되므로, 이보다 일찍 시작되는 기간은 해당되지 않는 날짜에 대한 데이터를 반환하지 않습니다.

응답 코드

코드	의미
200	성공.
400	잘못된 요청: `date_range`가 없거나 형식이 잘못된 경우, 기간이 366일을 초과하는 경우, 시간별 간격이 31일을 초과하는 경우, 또는 `inapp_codes`가 100개를 초과하는 경우.
401	API 토큰이 없거나 유효하지 않습니다.
404	이 애플리케이션에서 인앱 코드를 찾을 수 없습니다.