# 커스텀 연동 포스트백 요청 참조 > 정확한 어트리뷰션을 위해 커스텀 연동에서 설치 수와 설치 후 이벤트를 리포트하도록 Unity Ads에 서버 간 포스트백 요청을 전송합니다. 아래 파라미터를 검토하여 커스텀 연동 포스트백 요청을 올바르게 포맷해야 합니다. ## 어트리뷰션 포스트백 파라미터(필수)##required-attribution-postback-parameters 커스텀 연동 [포스트백 요청](/grow/acquire/partner-integration/custom/send-attribution-links.md)에서 다음 식별 파라미터를 릴레이해야 합니다. | `advertisingTrackingId`(iOS) | 대문자 형식의 IDFA(광고주 ID)입니다. | `1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P` | IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `advertisingTrackingIdMD5`(iOS) | 소문자 형식의 해시된 광고 식별자(IDFA) | `fce1e02f2ca0498021ec67f2f22dfcea` | IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. | | `advertisingTrackingId`(Android) | 소문자 형식의 Google [광고 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `a1b2-c3d4-e5f6-g7h8` | 광고 ID는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. | | `advertisingTrackingIdMD5`(Android) | MD5 해시 형식으로 된 소문자 형태의 Google [광고 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `6fbff11856d5f0200d473af3cabd346d` | 광고 ID는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. | | `gamerId` | LAT(제한적 광고 트래킹)가 'ON'으로 된 사용자를 어트리뷰션하는 데 필수적인 고유 Unity Ads 식별자 | `00000000-0000-0000-0000-000000000000` | `gamer_id` 파라미터의 값은 어트리뷰션을 위해 전송된 노출, 시청, 클릭에서 가져와야 합니다. `gamerID` 형식이 올바르지 않으면 응답 코드 400: `Malformed or missing input data`와 함께 `malformed` 오류가 나타납니다. | | `installTimeEpoch` | 설치 시간(epoch 초) | `1615973128` | 이 파라미터는 일부 캠페인 목표에서 필수적입니다. | | `rawAndroidId` | 원래의 소문자 형식으로 된 [Android ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#a-n-d-r-o-i-d_-i-d) | `3f4a92b6c1d8e90f` | Android 디바이스에 연동된 Google Play 서비스가 있으며 Google Play가 설치된 경우 필수는 아니므로 `rawAndroidID` 파라미터를 사용하지 않는 것이 좋습니다. 단, Google 광고 ID가 없는 모든 Android 설치에는 필수적입니다. | | `androidId` | MD5 해시 형식으로 된 [Android ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#a-n-d-r-o-i-d_-i-d) | `4a969d593d2a3e1d602fefe8e75a4d80` | Google Play 서비스가 올바르게 연동되고 Google Play가 제대로 설치된 Android 디바이스인 경우 필수는 아니므로 사용하지 않는 것이 좋습니다. 단, Google 광고 ID가 없는 모든 Android 설치에는 필수적입니다. | | `attributed` | 이 설치에 Unity Ads가 기여했는지, 비용이 청구될 수 있는지의 여부를 나타내는 플래그 | * `attributed=1` * `attributed=0` | 기본값(`attributed=1`)은 조건이 true임을 나타냅니다. 조건이 false(`attributed=0`)인 경우 미기여 설치이며, 요금이 부과되지 않습니다. 기여한 설치만 Unity에 보내는 것이 아니라 모든 설치에 대한 이벤트 데이터를 보내는 경우에만 이 파라미터를 사용합니다. | ## 설치 후 이벤트 포스트백 파라미터(필수)##required-post-install-event-postback-parameters 커스텀 연동 [포스트백 요청](/grow/acquire/partner-integration/custom/send-postbacks.md)에서 다음 식별 파라미터를 릴레이합니다. | `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](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9` | | | `android_id_md5=` (Android) | 소문자 형식의 MD5 해시 Google [광고 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `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 [게임 ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md) | `game_id=500009999` | [UA 대시보드](https://cloud.unity.com/acquire)에서 광고주 **게임 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}¤cy={currency}` | 사용자의 인앱 결제 완료와 거래 금액을 나타내는 결제 이벤트 플래그 | `event=purchase&value=1.0¤cy=USD` | USD 통화 사용이 권장됩니다. | | `event=ad_revenue&value{amount}¤cy={currency}` | 사용자가 광고 수익을 창출했는지와 수익 금액을 나타내는 광고 수익 이벤트 플래그 | * `event=ad_revenue&value=1.23¤cy=EUR` * `event=ad_revenue&revenue_usd=1.23` | - 수익 값의 형식은 소수로 지정합니다. 예: `1.05` - USD 통화를 사용하는 경우 `revenue_usd={amount}`를 `value{amount}¤cy={currency}` 대신 전송할 수 있습니다. | | `was_conversion_attributed=` | 원래 설치가 Unity에 기여되었는지 여부를 나타내는 플래그 | `was_conversion_attributed=1` | * `1`을 사용하여 원래 설치가 Unity에 기여되었음을 나타냅니다. * `0`을 사용하여 원래 설치가 미기여(Unity에 기여되지 않았음)임을 나타냅니다. | ## 보조 포스트백 파라미터(선택 사항)##optional-secondary-postback-parameters 다음 설치 후 이벤트 파라미터는 필수는 아닙니다. 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` | |