This document is about: QUANTUM 2
SWITCH TO

데이터 리포팅


Available in the Gaming Circle and Industries Circle
Circle

토너먼트 데이터 보고서 조회

사용자 지정 분석을 위해 과거 토너먼트 데이터를 쿼리 할 수 있습니다.

HTTP 호출은 POST이며 형식은 application/x-www-form-urlencoded이여야 합니다.

서버 전용이며 게임 클라이언트에 포함되지 않아야 하는 전용 SERVER ACCESS TOKEN을 요청해야 합니다

토너먼트

특정 날짜 범위에서 완료된 토너먼트를 쿼리 합니다.

엔드포인트 URL:

https://backbone-client-api.azurewebsites.net/api/v1/dataReportGetTournaments

헤더:

BACKBONE_APP_ID: YOUR-TSDK-GAME-CLIENT-ID
Accept-Encoding: gzip
Content-Type: application/x-www-form-urlencoded

application/x-www-form-urlencoded 파라미터:

accessToken
sinceDate
untilDate
  • accessToken 값은 SERVER ACCESS TOKEN 이어야 합니다.
  • sinceDate 값은 UTC 날짜 시간 형식 2022-10-29T00:00:00 (포괄적)
  • untilDate 값은 UTC 날짜 시간 형식 2022-10-30T00:00:00 (포괄적)

응답:

JavaScript

[
    {
        // 64 bit number as string
        "tournamentId": "63809769643125123",
        // 64 bit number as string
        "templateId": "63009307313241234",
        // UTC datetime when tournament was created
        "createdAt": "2022-10-27T19:32:26.063Z",
        // Default name of the tournament
        "name": "NameOfTheTournament 2v2",
        // Type of the tournament 
        // 0 - public
        // 1 - premium
        // 2 - private
        // 3 - testing
        "type": 1,
        // UTC datetime of tournament start
        "startedAt": "2022-10-29T23:00:00.000Z",
        // UTC datetime of tournament end
        "finishedAt": "2022-10-30T04:15:49.420Z",
        // User sign up count
        // NOTE: excludes players who fail to form a team
        "signedUpCount": 24563,
        // Maximum number of users
        "maxSignedUpCount": 30000,
        // Required size of team/party
        "partySize": 1,
        // Count of tournament phases
        "phaseCount": 4,
        // Count of all tournament rounds across all phases
        "roundCount": 34
    }
]

토너먼트 참가자

특정 토너먼트의 참여자 조회

엔드포인트 URL:

https://backbone-client-api.azurewebsites.net/api/v1/dataReportGetTournamentUsers

헤더:

BACKBONE_APP_ID: YOUR-TSDK-GAME-CLIENT-ID
Accept-Encoding: gzip
Content-Type: application/x-www-form-urlencoded

application/x-www-form-urlencoded 파라미터:

accessToken
tournamentId
  • accessToken 값은 SERVER ACCESS TOKEN 이어야 합니다.
  • tournamentId 값은 특정 토너먼트의 ID입니다.

응답:

JavaScript

[
    {
        // UTC datetime when user was added (ticket created)
        "createdAt": "2022-10-25T15:00:35.447Z",
        // 64 bit number as string
        "tournamentId": "63592122754314523",
        // 64 bit number as string
        "ticketId": "63730450823452345234",
        // 64 bit number as string
        "userId": "410158954303241234",
        // External system ID as string
        "userExternalId": "XXXXXX",
        // Playfab ID as string
        "userPlayfabId": "XXXXXX",
        // 64 bit number as string
        "partyId": "6373045088123412432",
        // Status of user's ticket
        // 0 - invited
        // 1 - confirmed (can play)
        // 2 - declined
        // 3 - incomplete party
        // 4 - processing signup
        // 5 - signup fail
        // 6 - processign signout
        // 7 - signout fail
        "status": 1,
        // Flag indicating user's attendance
        "checkIn": false,
        // User's final placement
        "userPlace": 0,
        // User's total playtime (in minutes)
        "totalPlayTime": null,
        // User's total match count
        "matchCount": null,
        // User's total game count
        "gameCount": null,
        // User's reached phase (>=1)
        "maxPhase": null
    }
]

토너먼트 템플릿 통계

특정 날짜 범위의 템플릿 일일 성능 통계를 쿼리 합니다.

엔드포인트 URL:

https://backbone-client-api.azurewebsites.net/api/v1/dataReportGetTournamentTemplates

헤더:

BACKBONE_APP_ID: YOUR-TSDK-GAME-CLIENT-ID
Accept-Encoding: gzip
Content-Type: application/x-www-form-urlencoded

application/x-www-form-urlencoded 파라미터:

accessToken
sinceDate
untilDate
  • accessToken 값은 SERVER ACCESS TOKEN 이어야 합니다.
  • sinceDate 값은 UTC 날짜 시간 형식 2022-10-29T00:00:00 (포괄적)
  • untilDate 값은 UTC 날짜 시간 형식 2022-10-30T00:00:00 (포괄적)

응답:

JavaScript

[
    {
        // UTC datetime of day stats account for
        "recordedAt": "2022-10-26T00:00:00.000Z",
        // 64 bit number as string
        "templateId": "60208317421341234",
        // Name of tournament template
        "name": "Battlecup",
        // Type of the tournament 
        // 0 - public
        // 1 - premium
        // 2 - private
        // 3 - testing
        "type": 2,
        // Count of tournaments for a day
        "tournamentCount": 1,
        // Daily tournament attendance.
        // Average percentage of users who checked in and played the tournament. 
        // Example 100 successful signups, 75 users played would result in 75% attendance. 
        "dtaAvg": 88.89,
        // Sum of checked in users who played all template tournaments this day.
        "dtaSum": 8,
        // Sum of unique checked in users who played all template tournament this day.
        "dtaUSum": 8,
        // Monthly tournament attendance.
        // Same as daily stat above but aggregated over past 30 days.
        "mtaAvg": 79.46,
        // Same as daily stat above but aggregated over past 30 days.
        "mtaSum": 465,
        // Same as daily stat above but aggregated over past 30 days.
        "mtaUSum": 47,
        // Weekly retention over past month (week 1)
        "wtr1": 47,
        // Weekly retention over past month (week 2)
        "wtr2": 31,
        // Weekly retention over past month (week 3)
        "wtr3": 16,
        // Weekly retention over past month (week 4)
        "wtr4": 14
    }
]
Back to top