커스텀 연동으로 보조 포스트백 전송

각 앱 이벤트에 대해 필요한 사용자, 캠페인, 게임, 이벤트, 어트리뷰션 파라미터를 포함한 요청을 구성하고, 커스텀 서버 간 포스트백을 사용하여 설치 후 이벤트 데이터를 Unity Ads에 전송합니다.

읽는 시간 2분

최근 업데이트: 11일 전

커스텀 서버 간 연동을 사용하여 Unity에 설치 후 이벤트 데이터를 전달하려면 서버 요청을 사용하여 포스트백을 생성합니다. 서버에서 가져올 수 있는 포스트백 예제는 이 문서를 참고하십시오.

기본 URL

다음 기본 URL을 사용하여 설치 후 이벤트 포스트백을 Unity로 보냅니다.


https://ads-secondary-conversion.unityads.unity3d.com/v1/events

필수 이벤트 파라미터

이벤트 쿼리에 다음 컴포넌트를 포함하여 설치 후 이벤트 데이터를 Unity에 전달합니다.

사용자 ID

보조 포스트백 URL에는 다음 사용자 ID 파라미터가 필요합니다.

파라미터	설명	예시	참고
`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`

광고 트래킹 설정

보조 포스트백 URL에는 다음 광고 트래킹 파라미터가 필요합니다.

파라미터	설명	예시	참고
`tracking_enabled=` `tracking_limited=`	사용자가 광고 트래킹 제한을 활성화했는지 여부를 나타내는 플래그	`tracking_enabled=1` `tracking_limited=0`

캠페인 ID

보조 포스트백 URL에는 다음 캠페인 ID 파라미터가 필요합니다.

파라미터	설명	예시	참고
`campaign_id`	Unity Ads 캠페인 ID	`546b9257365339e0031572bd`	UA 대시보드의 Campaign 페이지에서 Campaign ID를 가져올 수 있습니다.

게임 ID

보조 포스트백 URL에는 다음 게임 ID 파라미터가 필요합니다.

기본 게임 ID

URL에 다음 게임 ID 파라미터를 포함합니다.

파라미터	설명	예시	참고
`game_id`	Unity Ads 게임 ID	`500009999`	UA 대시보드의 Apps 페이지에서 Game ID를 가져올 수 있습니다.

플랫폼 ID

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 Dashboard의 모든 Projects의 Settings 탭에서 Project 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를 가져올 수 있습니다.

타임스탬프 설치

보조 포스트백 URL에는 다음 타임스탬프 파라미터가 필요합니다.

파라미터	설명	예시	참고
`install_ts={unix time in seconds or milliseconds}`	Unix 형식의 원래 설치 타임스탬프	`install_ts=1466637800175`	밀리초는 타임스탬프에 권장되는 성공 사례입니다.

이벤트 ID

보조 포스트백 URL에 다음 이벤트 파라미터 중 하나를 포함합니다.

파라미터	설명	예시	참고
`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}` 를 보낼 수 있습니다.

전환 어트리뷰션

보조 포스트백 URL에는 다음 전환 어트리뷰션 파라미터가 필요합니다.

파라미터	설명	예시	참고
`was_conversion_attributed=`	원래 설치가 Unity에 기여했는지 여부를 나타내는 플래그	`was_conversion_attributed=1`	`1` 을 사용하여 원래 설치가 Unity에 기여했음을 나타냅니다. `0` 을 사용하여 원래 설치가 Unity에 기여되지 않았음을 나타냅니다.

쿼리 예제

설치 후 이벤트 데이터를 Unity로 전송할 때는 다음 보조 포스트백 문자열 예제를 참고하십시오.

세션 이벤트

세션 이벤트 데이터를 전달하기 위한 포스트백 문자열의 예로 이 레퍼런스를 사용하십시오.


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

구매 이벤트

구매 이벤트 데이터를 전달하기 위한 포스트백 문자열의 예로 이 레퍼런스를 사용하십시오.


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

광고 수익 이벤트

광고 수익 데이터를 전달하기 위한 포스트백 문자열의 예제로 이 레퍼런스를 사용하십시오.


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