# 커스텀 통합 보조 포스트백 > 커스텀 서버 간 연동 보조 포스트백의 포맷과 파라미터를 검토합니다. 커스텀 서버 간 연동을 사용하여 Unity에 [설치 후 이벤트 데이터를](/user-acquisition/data-sharing/post-install-event-data-sharing.md) 전달하려면 서버 요청을 사용하여 포스트백을 생성합니다. 서버에서 가져올 수 있는 포스트백 예제는 이 문서를 참고하십시오. ## 기본 URL##base-url 다음 기본 URL을 사용하여 설치 후 이벤트 포스트백을 Unity로 보냅니다. ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events ``` ## 필수 이벤트 파라미터##required-event-parameters 이벤트 쿼리에 다음 컴포넌트를 포함하여 설치 후 이벤트 데이터를 Unity에 전달합니다. ### 사용자 ID##user-identification 보조 포스트백 URL에 다음 사용자 식별 파라미터를 포함해야 합니다. | `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](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` | | ### 광고 트래킹 설정##ad-tracking-setting 보조 포스트백 URL에 다음 광고 트래킹 파라미터를 포함해야 합니다. | * `tracking_enabled=` * `tracking_limited=` | 사용자가 광고 트래킹 제한을 활성화했는지 여부를 나타내는 플래그 | - `tracking_enabled=1` - `tracking_limited=0` | | | ------------------------------------------- | ----------------------------------- | --------------------------------------------- | - | ### 캠페인 ID##campaign-identification 보조 포스트백 URL에 다음 캠페인 식별 파라미터를 포함해야 합니다. | `campaign_id` | Unity 캠페인 식별자 | `546b9257365339e0031572bd` | UA 대시보드의 **Campaigns** 페이지에서 **Campaign ID**를 검색할 수 있습니다. | | ------------- | ------------- | -------------------------- | --------------------------------------------------------- | ### 게임 ID##game-identification 보조 포스트백 URL에 다음 게임 식별 파라미터를 포함해야 합니다. #### 기본 게임 ID##base-game-identification URL에 다음 게임 ID 파라미터를 포함합니다. | `game_id` | Unity 광고주 [게임 ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id) | `500009999` | [UA 대시보드](https://cloud.unity.com/acquire)에서 광고주 **게임 ID**를 검색할 수 있어야 합니다. SDK 연동에 사용하는 퍼블리셔 **게임 ID**(Monetization 대시보드)는 사용하지 않습니다. | | --------- | --------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------- | #### 플랫폼 ID##platform-identification URL에 게임 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 대시보드의 **Projects**에서 **Settings** 탭을 통해 **Project ID**를 검색할 수 있습니다. | ### 타임스탬프 설치##install-timestamp 보조 포스트백 URL에 다음 타임스탬프 파라미터를 포함해야 합니다. | `install_ts={unix time in seconds or milliseconds}` | Unix 형식의 원래 설치 타임스탬프 | `install_ts=1466637800175` | 밀리초 사용이 타임스탬프에 권장됩니다. | | --------------------------------------------------- | -------------------- | -------------------------- | --------------------- | ### 이벤트 ID##event-identification 보조 포스트백 URL에 다음 이벤트 파라미터 중 하나를 포함합니다. | `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}` 대신 전송할 수 있습니다. | ### 전환 어트리뷰션##conversion-attribution 보조 포스트백 URL에 다음 전환 어트리뷰션 파라미터를 포함해야 합니다. | `was_conversion_attributed=` | 원래 설치가 Unity에 기여되었는지 여부를 나타내는 플래그 | `was_conversion_attributed=1` | `1`을 사용하여 원래 설치가 Unity에 기여했음을 나타냅니다. `0`을 사용하여 원래 설치가 미기여(Unity에 기여되지 않았음)임을 나타냅니다. | | ---------------------------- | --------------------------------- | ----------------------------- | ----------------------------------------------------------------------------------- | ## 쿼리 예제##example-queries 설치 후 이벤트 데이터를 Unity로 전송할 때는 다음 보조 포스트백 문자열 예제를 참고하십시오. ### 세션 이벤트##session-event 세션 이벤트 데이터를 전달하는 포스트백 문자열 예시로 아래 레퍼런스를 사용하십시오. 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` ### 결제 이벤트##purchase-event 결제 이벤트 데이터를 전달하는 포스트백 문자열 예시로 아래 레퍼런스를 사용하십시오. 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` ### 광고 수익 이벤트##ad-revenue-event 광고 수익 데이터를 전달할 때 사용할 포스트백 문자열 예시로 아래 레퍼런스를 사용하십시오. 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=ad_revenue&revenue_usd=1.23&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=ad_revenue&value=1.23&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ```