기술 자료

지원

Unity Ads UA

캠페인

어트리뷰션

UA 대시보드 열기

Unity Ads UA

커스텀 연동 포스트백 요청 참조

정확한 어트리뷰션을 위해 커스텀 연동에서 설치 수와 설치 후 이벤트를 리포트하도록 Unity Ads에 서버 간 포스트백 요청을 전송합니다.
읽는 시간 3분최근 업데이트: 5일 전
앱의 서버에서 커스텀 연동을 사용하여 포스트백을 전송할 때 요청 형식이 올바른지 확인하려면 다음 파라미터를 검토합니다.

어트리뷰션 포스트백 파라미터(필수)

커스텀 연동 포스트백 요청에 다음 식별 파라미터가 전달되어야 합니다.

파라미터

설명

예시

참고

advertisingTrackingId
(iOS)		대문자 형식의 IDFA(광고주 ID)입니다.
1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
IDFA는 모든 설치에 필수적입니다. ID의 raw 형식 또는 해시 형식을 사용할 수 있습니다.
advertisingTrackingIdMD5
(iOS)		해시가 지정된 소문자 형식의 IDFA(광고주 ID)입니다.
fce1e02f2ca0498021ec67f2f22dfcea
IDFA는 모든 설치에 필수적입니다. ID의 raw 형식 또는 해시 형식을 사용할 수 있습니다.
advertisingTrackingId
(Android)		소문자로 된 Google 광고 ID입니다.
a1b2-c3d4-e5f6-g7h8
광고 ID는 모든 설치에 필수입니다. ID의 raw 형식 또는 해시 형식을 사용할 수 있습니다.
advertisingTrackingIdMD5
(Android)		MD5 해시 형식으로 된 소문자 형식의 Google 광고 ID입니다.
6fbff11856d5f0200d473af3cabd346d
광고 ID는 모든 설치에 필수입니다. ID의 raw 형식 또는 해시 형식을 사용할 수 있습니다.
gamerId
LAT(제한적 광고 트래킹)가 ‘ON’으로 된 사용자를 트래킹하는 데 필수적인 고유 Unity Ads ID입니다.
00000000-0000-0000-0000-000000000000
gamer_id
파라미터의 값은 어트리뷰션을 위해 전송된 노출, 시청, 클릭에서 가져와야 합니다. 이 
gamerID
형식이 올바르지 않으면 응답 코드 400: 
Malformed or missing input data
와 함께 
malformed
오류가 나타납니다.
installTimeEpoch
설치 시간(epoch 초)입니다.
1615973128
이 파라미터는 일부 캠페인 유형에 필수적입니다.
rawAndroidId
원래의 소문자 형식으로 된 Android ID입니다.
3f4a92b6c1d8e90f
Android 디바이스에 연동된 Google Play 서비스가 있으며 Google Play가 설치된 경우 필수는 아니므로 
rawAndroidID
파라미터를 사용하지 않는 것이 좋습니다. 단, Google 광고 ID가 없는 모든 Android 설치에는 필수입니다.
androidId
MD5 해시 형식으로 된 Android ID입니다.
4a969d593d2a3e1d602fefe8e75a4d80
Google Play 서비스가 올바르게 연동되고 Google Play가 제대로 설치된 Android 디바이스인 경우 필수는 아니므로 권장되지 않습니다. 단, Google 광고 ID가 없는 모든 Android 설치에는 필수입니다.
attributed
이 설치에 Unity Ads가 기여했는지, 그리고 비용이 청구될 수 있는지의 여부를 나타내는 플래그입니다.
  • attributed=1
  • attributed=0
기본값(
attributed=1
)은 조건이 true임을 나타냅니다. 조건이 false(
attributed=0
)인 경우 미기여 설치이며, 요금이 부과되지 않습니다. 기여한 설치만 Unity에 보내는 것이 아니라 모든 설치에 대한 이벤트 데이터를 보내는 경우에만 이 파라미터를 사용합니다.

설치 후 이벤트 포스트백 파라미터(필수)

설치 후 이벤트 포스트백에 대한 커스텀 연동 포스트백 요청에 다음 식별 파라미터가 전달되어야 합니다.

파라미터

설명

예시

참고

gamer_id=
설치 사용자의 Unity Ads 고유 게이머 ID
gamer_id=00000000-0000-0000-0000-000000000000
  • ifa=
    (iOS)
  • idfa=
디바이스용 대문자 형식의 Apple 광고 ID(IDFA)
ifa=1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
IDFA는 모든 설치에 필수적입니다. ID의 raw 형식 또는 해시 형식을 사용할 수 있습니다.
aid=
(Android)		소문자 형식의 Google Play 광고 ID
aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9
android_id_md5=
(Android)		소문자 형식의 Google 광고 ID의 MD5 해시
android_id_md5=6fbff11856d5f0200d473af3cabd346d
  • tracking_enabled=
  • tracking_limited=
사용자가 광고 트래킹 제한을 활성화했는지 여부를 나타내는 플래그
  • tracking_enabled=1
  • tracking_limited=0
campaign_id=
Unity Ads 캠페인 ID
campaign_id=546b9257365339e0031572bd
UA 대시보드의 Campaigns 페이지에서 Campaign ID를 가져올 수 있습니다.
gameId=
Unity Ads 게임 ID
gameId=500009999
UA 대시보드의 Apps 페이지에서 Game ID를 가져올 수 있습니다.
platform={ios or android}&store_id={itunes id or googleplay id}
플랫폼+스토어 ID
  • platform=ios&store_id=123456789
  • platform=android&store_id=com.example.store
iOS에는 다음과 같은 값을 사용할 수 있습니다. 
  • ios
  • itunes
  • iOS
  • iTunes
platform={ios or android}&bundle_id={bundle id}
플랫폼+번들 ID
platform=ios&bundle_id=com.example.myapp
Android에는 다음 값을 사용할 수 있습니다. 
  • android
  • google
  • Android
  • Google
  • gplay
  • GooglePlay
platform={ios or android}&project_id={Unity Project ID}
플랫폼+Unity 프로젝트 ID
platform=android&project_id=2ff453g1-8d49-2p06-n22f-9m833592113f2
Unity Dashboard의 모든 Projects의 Settings 탭에서 Project ID를 가져올 수 있습니다.
install_ts={unix time in seconds or milliseconds}
Unix 형식의 원래 설치 타임스탬프
install_ts=1466637800175
밀리초는 타임스탬프에 권장되는 성공 사례입니다.
event=session
사용자가 게임플레이 세션을 시작했음을 나타내는 세션 이벤트 플래그
event=session
event=purchase&value{amount}&currency={currency}
사용자가 인앱 결제를 완료했음을 나타내는 구매 이벤트 플래그+거래 금액
event=purchase&value=1.0&currency=USD
권장되는 성공 사례는 통화에 USD를 사용하는 것입니다.
event=ad_revenue&value{amount}&currency={currency}
사용자가 광고 수익을 창출했는지+수익 금액을 나타내는 광고 수익 이벤트 플래그
  • event=ad_revenue&value=1.23&currency=EUR
  • event=ad_revenue&revenue_usd=1.23
  • 수익 값의 형식은 소수로 지정합니다. 예: 
    1.05
  • 통화로 USD를 사용하는 경우 
    value{amount}&currency={currency}
    대신 
    revenue_usd={amount}
    를 보낼 수 있습니다.
was_conversion_attributed=
원래 설치가 Unity에 기여했는지 여부를 나타내는 플래그
was_conversion_attributed=1
  • 1
    을 사용하여 원래 설치가 Unity에 기여했음을 나타냅니다.
  • 0
    을 사용하여 원래 설치가 Unity에 기여되지 않았음을 나타냅니다.

보조 포스트백 파라미터(선택 사항)

다음 설치 후 이벤트 파라미터는 필수는 아닙니다. GET 요청에서 다음 파라미터를 사용하여 앱의 설치 후 이벤트에 대한 추가 정보를 가져옵니다.

파라미터

설명

예시

참고

ts=
Unix 형식 설치 후 이벤트의 타임스탬프
ts=1466637800123
모든 타임스탬프에는 Unix 형식을 사용합니다. 권장되는 성공 사례는 밀리초이지만 Unity는 초 단위의 타임스탬프도 지원합니다.
ip=
사용자의 IP 주소
ip=123.456.78.90
ad_network=
광고 네트워크 이름
ad_network=UnityAds
country=
사용자의 ISO 3166-1 alpha-2 국가 코드
country=US
app_version=
앱 버전 번호
app_version=1.2.3
device_type=
디바이스 모델 이름
device_type=iPhone6,2 device_type=samsung+GT-S7582
os_version=
디바이스 OS 버전
os_version=14.4.2
language=
사용자의 ISO 639-1 언어 코드
language=en_US
ad_format=
표시되는 광고 타입. 예: 인터스티셜, 보상형, 플레이어블, 배너
ad_format=interstitial
이 파라미터는 
ad_revenue
이벤트에만 관련되며 표시되는 광고의 형식을 설명합니다. 다음은 가장 일반적인 광고 형식 중 일부입니다. 
  • interstitial
  • rewarded
  • playable
  • video banner
event=
session
, 
purchase
또는 
ad_revenue
이외의 설치 후 이벤트에 대한 이벤트 이름
  • event=ad_view
  • event=registration
  • event=spent_credits
  • event=invite
  • event=share
  • event=level_complete
  • event=tutorial_complete
  • event=achievement_unlocked
  • event=custom_event
지원되는 다음 이벤트 이름 중 하나를 
event={event name}
과 함께 사용하십시오. 
  • registration
    : 앱에 등록된 사용자입니다.
  • spent_credits
    : 사용자는 게임 내 아이템을 구매하기 위해 가상 재화를 사용했습니다. 다음과 같은 
    spent_credits
    파라미터(선택 사항)를 지정할 수도 있습니다.
    • value={how many credits}
    • type={what type credits}
  • invite
    : 사용자가 친구를 게임에 초대했습니다.
  • share
    : 사용자가 게임을 친구와 공유했습니다.
  • level_complete
    : 사용자가 레벨을 완료했습니다. 다음과 같은 
    level complete
    파라미터(선택 사항)를 지정할 수도 있습니다.
    • value={level name}
  • tutorial_complete
    : 사용자가 튜토리얼을 완료했습니다.
  • achievement_unlocked
    : 사용자가 목표를 잠금 해제했습니다.
  • custom
    : 커스텀 이벤트가 발생했습니다. 다음과 같은 
    custom
    이벤트 파라미터(선택 사항)를 지정할 수도 있습니다.
    • custom_event={custom_event_name}
    • value={value}&type={type}
tracking_partner=
트래킹 서비스 또는 MMP(모바일 측정 파트너) 이름
tracking_partner=AppsFlyer
app_name=
앱 이름
app_name=Game+Name
advertiser_name=
광고주 이름
advertiser_name=Advertiser+Name+In+Here
impression_ts=
광고 노출이 발생한 시점의 타임스탬프(Unix 형식)
impression_ts=1466637800123
모든 타임스탬프에는 Unix 형식을 사용합니다. 권장되는 성공 사례는 밀리초이지만 Unity는 초 단위의 타임스탬프도 지원합니다.
click_ts=
광고 클릭이 발생한 시점의 타임스탬프(Unix 형식)
click_ts=1466637800456
모든 타임스탬프에는 Unix 형식을 사용합니다. 권장되는 성공 사례는 밀리초이지만 Unity는 초 단위의 타임스탬프도 지원합니다.
test=
최종 사용자의 실제 이벤트로 집계되지 않는 서버의 테스트 포스트백
test=1