기술 자료

지원

Unity Ads UA

캠페인

어트리뷰션

UA 대시보드 열기

Unity Ads UA

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

정확한 어트리뷰션을 위해 커스텀 연동에서 설치 수와 설치 후 이벤트를 리포트하도록 Unity Ads에 서버 간 포스트백 요청을 전송합니다.
읽는 시간 2분최근 업데이트: 2일 전
아래 파라미터를 검토하여 커스텀 연동 포스트백 요청을 올바르게 포맷해야 합니다.

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

커스텀 연동 포스트백 요청에서 다음 식별 파라미터를 릴레이해야 합니다. 
gamer_id

파라미터

설명

예제

참고

advertisingTrackingId
(iOS)		대문자 형식의 광고 식별자(IDFA)
1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다.
advertisingTrackingIdMD5
(iOS)		소문자 형식의 해시된 광고 식별자(IDFA)
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 식별자 
00000000-0000-0000-0000-000000000000
 파라미터의 값은 어트리뷰션을 위해 전송된 노출, 시청, 클릭에서 가져와야 합니다. 
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 광고 식별자(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)		소문자 형식의 MD5 해시 Google 광고 ID
android_id_md5=6fbff11856d5f0200d473af3cabd346d
  • tracking_enabled=
  • tracking_limited=
사용자가 광고 트래킹 제한을 활성화했는지 여부를 나타내는 플래그
  • tracking_enabled=1
  • tracking_limited=0
campaign_id=
Unity Ads 캠페인 식별자
campaign_id=546b9257365339e0031572bd
UA 대시보드의 Campaigns 페이지에서 Campaign ID를 검색할 수 있습니다.
game_id=
Unity Ads Game ID
game_id=500009999
UA 대시보드에서 광고주 게임 ID를 검색할 수 있어야 합니다. SDK 연동에 사용하는 퍼블리셔 게임 ID(Monetization 대시보드)는 사용하지 않습니다.
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 대시보드의 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 통화를 사용하는 경우 
    revenue_usd={amount}
    를 
    value{amount}&currency={currency}
    대신 전송할 수 있습니다.
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