커스텀 연동 포스트백 요청 파라미터 참조

커스텀 서버 간 연동 포스트백 요청의 파라미터를 검토합니다.

읽는 시간 2분

최근 업데이트: 한 달 전

아래 파라미터를 검토하여 커스텀 연동 포스트백 요청을 올바르게 포맷해야 합니다.

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

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

LAT(제한적 광고 트래킹)가 'ON'으로 된 사용자를 어트리뷰션하는 데 필수적인 고유 Unity Ads 식별자

gamer_id

이 설치에 Unity Ads가 기여했는지, 비용이 청구될 수 있는지의 여부를 나타내는 플래그

파라미터	설명	예제	참고
`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`	`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`	`attributed=1` `attributed=0`	기본값( `attributed=1` )은 조건이 true임을 나타냅니다. 조건이 false( `attributed=0` )인 경우 미기여 설치이며, 요금이 부과되지 않습니다. 기여한 설치만 Unity에 보내는 것이 아니라 모든 설치에 대한 이벤트 데이터를 보내는 경우에만 이 파라미터를 사용합니다.

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

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

파라미터	설명	예제	참고
`gamer_id=`	설치 사용자의 Unity 고유 게이머 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 캠페인 식별자	`campaign_id=546b9257365339e0031572bd`	UA 대시보드의 Campaigns 페이지에서 Campaign ID를 검색할 수 있습니다.
`game_id=`	Unity 게임 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`

기술 자료

Development

User Acquisition

Monetization

산업 분야

기술 자료

Development

User Acquisition

Monetization

산업 분야

UA

캠페인 목표

어트리뷰션

파트너 연동

UA

커스텀 연동 포스트백 요청 파라미터 참조

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

파라미터

설명

예제

참고

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

파라미터

설명

예제

참고

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

파라미터

설명

예제

참고