Steam 게임 측정 설정

본 가이드는 성공적인 어트리뷰션 측정을 위해 Steam 게임 앱을 설정하고, 안전한 서버 간(S2S) API 연결을 설정하고, 링크를 효과적으로 관리하는 과정을 안내합니다. 사용자는 Steam 스토어 또는 Windows 및 Mac의 커스텀 스토어를 통해 게임을 다운로드할 수 있습니다.

Steam 게임에 대한 측정을 설정하려면 다음을 수행해야 합니다.

  1. AppView 에서 새 앱을 설정합니다.
  2. Adjust의 S2S API를 설정하여 세션 기록을 시작합니다.
  3. Campaign Lab에서 링크를 설정합니다.

Steam 앱 설정

PC 앱 추가 및 설정을 시작하려면 다음의 단계를 수행하시기 바랍니다.

  1. AppView 에서 모든 앱 을 선택합니다.

  2. 신규 앱 을 선택합니다.

  3. 앱 세부 정보 입력( Enter your app details )에 앱 이름을 입력하고, 리포트 통화를 선택한 뒤, 게임이 다음을 준수해야 하는지 확인합니다.

    • COPPA 준수 . 미국 소재 기업에만 해당. 여기에서 COPPA 준수에 대해 자세히 알아보세요.
    • Google DMA . 사용자 기반이 유럽 경제 지역(EEA) 외 지역에 있는 앱에만 적용됩니다. 여기에서 Google DMA에 대해 자세히 알아보세요.
  4. 앱 추가 를 선택합니다.

  5. 플랫폼 추가 를 선택하여 플랫폼을 게임에 연결합니다.

    1. PC > Steam 을 선택합니다. Windows 및 Mac Steam 스토어에서 작동합니다.
    2. 앱 ID 를 입력하거나 , 아직 앱 ID가 없음 을 선택한 후 추후 입력합니다.
    3. (선택 사항) 사용자를 Steam의 앱 스토어 대신 커스텀 웹사이트로 이동시키고자 하는 경우, 모든 클릭을 '맞춤 URL로 리디렉션'을 활성화하고 맞춤 URL 을 입력합니다. 이는 앱이 앱 ID를 가지고 있지 않은 경우에 사용하는 것을 권장합니다.
    4. 저장 을 선택합니다.
  1. 이벤트 탭에서 인앱 이벤트 이름을 추가하여 게임에서의 사용자 활동을 측정합니다.

  2. 어트리뷰션 설정 탭에서 어트리뷰션 설정(디바이스 매칭, 확률론적 모델링, 임시 어트리뷰션)과 리어트리뷰션 설정을 구성합니다.

    • 클릭과 노출 모두에 대해 확률론적 모델링이 활성화되어 있는지 확인합니다. 확률론적 모델링의 경우 어트리뷰션 윈도우를 24시간으로 설정하는 것을 적극 권장하지만, 최대 90일까지 설정할 수도 있습니다. 90일 어트리뷰션 윈도우는 PC 및 콘솔 플랫폼에서만 이용 가능합니다.
  3. 데이터 관리 탭에서 서버 콜백또는 클라우드 스토리지 업로드를 설정하여 사용자 수준의 로데이터를 수신하거나, 테스트용 콘솔을 사용하여 테스트 기기 데이터를 확인합니다.

  4. 보호 탭에서 S2S 보안 을 설정합니다. S2S API 설정에 토큰이 필요합니다.

Adjust S2S API 설정

앱 코드 변경 없이 Adjust S2S API를 사용하여 앱을 Adjust에 연결하면 사용자의 세션과 이벤트 측정을 시작할 수 있습니다.

다음의 session 엔드포인트를 사용하여 설정을 계속하시기 바랍니다.

시작에 앞서

Adjust 서버는 엄격한 일관성 확인 절차를 통해 시스템 남용 또는 과부하를 방지합니다. 서버 간(S2S) 어트리뷰션은 Adjust SDK와 중복하여 사용할 수 없는 배타적 연동입니다.

  • S2S 어트리뷰션 체크리스트 를 통해 SDK 연동 대신 S2S 설정을 사용하는 것의 제약에 대해 반드시 이해하시기 바랍니다.
  • 반드시 기기에서 발생한 것과 동일한 순서로 Adjust의 서버에 요청해야 합니다.

인증

S2S 보안을 설정하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.

엔드포인트

session 엔드포인트를 사용하면 사용자가 게임을 실행할 때 세션을 기록할 수 있습니다. 세션은 사용자가 백그라운드에서 게임을 재개하거나, 게임을 시작하는 경우(예: 게임을 계속 진행하는 중에 다른 앱을 실행하거나 이전 종료 후 게임을 시작)합니다. Adjust 서버는 불필요한 리소스 사용을 방지하기 위해 30분마다 새로운 세션을 수신합니다.

https://s2s.adjust.com/session

POST header

인증 : Adjust API 호출 시, 인증 유형을 Bearer로 설정하여 Adjust 인증 토큰 값을 전송합니다.

예: Bearer authentication_token.

POST Payload

참고:

***** 로 표시된 파라미터는 필수 항목입니다.

파라미터데이터 유형In설명
s2s*StringQuery서버간 파라미터: Adjust 서버가 서버 측 활동을 인식하도록 허용. 항상 `1`로 전송되어야 합니다.
app_token*StringQuery앱에 대한 고유한 인증 토큰
os_name*StringQuery앱의 OS에 따라 이용 가능한 파라미터 중 하나를 사용합니다.
  • windows 
  • macos
  • steamos
ip_address*StringQuery기기 IP 주소
created_at*TimestampQuery로컬 기기의 타임스탬프. 시간대를 포함하는 패키지 생성.
external_device_id*StringQuery고유한 사용자(예: 사용자의 account_id 또는 암호화된 이메일 주소)
:

external_device_id 파라미터를 사용하여 사용자의 steam_id 를 Adjust에 전달할 수 있습니다.

요청 예시

cURL
curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46_device_id=288Z-03-23T09:46_device_id=490a_a_a_a=4 -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

S2S API를 사용하여 이벤트를 기록하는 방법은 서버 간(S2S 이벤트.

링크 설정

앱 서버와 Adjust 간에 S2S API 연동을 설정하고 테스트한 후에는 캠페인을 진행하는 광고 네트워크에 Adjust를 연결해야 합니다.

링크를 사용하면 사용자가 다른 기기에서 광고를 보았을 때 어트리뷰션을 기록할 수 있습니다. 다음은 웹 캠페인을 위한 네트워크의 두 가지 예입니다.

Campaign Lab 에서 다음의 설정 단계를 수행하시기 바랍니다.

  1. Campaign Labs 에서 파트너 를 선택합니다.

  2. 새 파트너 를 선택합니다.

  3. 파트너 선택 화면에서 설정하고자 하는 광고 네트워크를 선택합니다.

  4. 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택합니다.

  5. (선택 사항) 데이터 공유 화면에서 네트워크와 Adjust 간의 연동을 구성하고, 데이터 공유 옵션을 선택합니다.

  6. 링크 구조 화면에서 네트워크가 제공한 기본 링크 구조 파라미터를 확인하고, 필요한 경우 값을 업데이트합니다.

  7. (선택 사항) 사용자 이동 위치 화면에서 딥링크를 구성하거나, 링크에 리다이렉트 및 폴백을 추가합니다.

    • 특정 게임 스토어로 리다이렉트하고자 하는 경우, 추가 리다이렉트에 URL 을 포함해야 합니다.
  8. (선택 사항) 어트리뷰션 설정 화면에서 신규 및 기존 사용자에 대해 커스텀 어트리뷰션 설정을 선택할 수 있습니다. 어트리뷰션 설정은 클릭과 노출에 적용됩니다. 별도의 설정을 하지 않을 경우, 앱 설정 시 선택한 어트리뷰션 설정이 적용됩니다.

    • 클릭과 노출 모두에 대해 확률론적 모델링이 활성화되어 있는지 확인합니다. 확률론적 모델링의 경우 어트리뷰션 윈도우를 24시간으로 설정하는 것을 적극 권장하지만, 최대 90일까지 설정할 수도 있습니다. 90일 어트리뷰션 윈도우는 PC 및 콘솔 플랫폼에서만 이용 가능합니다.
  9. 설정 검토 화면에서 선택한 내용을 재확인하고, 필요한 경우 추가 변경을 수행합니다.

  10. 링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드와 링크 토큰을 생성합니다. 이미 데이터 공유가 설정된 경우, 데이터 공유 옵션을 활성화합니다.