커스텀 연동 포스트백 요청 참조
정확한 어트리뷰션을 위해 커스텀 연동에서 설치 수와 설치 후 이벤트를 리포트하도록 Unity Ads에 서버 간 포스트백 요청을 전송합니다.
읽는 시간 2분최근 업데이트: 3달 전
아래 파라미터를 검토하여 커스텀 연동 포스트백 요청을 올바르게 포맷해야 합니다.
어트리뷰션 포스트백 파라미터(필수)
커스텀 연동 포스트백 요청에서 다음 식별 파라미터를 릴레이해야 합니다.파라미터 | 설명 | 예제 | 참고 |
|---|---|---|---|
| 대문자 형식의 광고 식별자(IDFA) | | IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. |
| 소문자 형식의 해시된 광고 식별자(IDFA) | | IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. |
| 소문자 형식의 Google 광고 ID | | 광고 ID는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. |
| MD5 해시 형식으로 된 소문자 형태의 Google 광고 ID | | 광고 ID는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. |
|
LAT(제한적 광고 트래킹)가 'ON'으로 된 사용자를 어트리뷰션하는 데 필수적인 고유 Unity Ads 식별자 | |
파라미터의 값은 어트리뷰션을 위해 전송된 노출, 시청, 클릭에서 가져와야 합니다. |
| 설치 시간(epoch 초) | | 이 파라미터는 일부 캠페인 목표에서 필수적입니다. |
| 원래의 소문자 형식으로 된 Android ID | | Android 디바이스에 연동된 Google Play 서비스가 있으며 Google Play가 설치된 경우 필수는 아니므로 |
| MD5 해시 형식으로 된 Android ID | | Google Play 서비스가 올바르게 연동되고 Google Play가 제대로 설치된 Android 디바이스인 경우 필수는 아니므로 사용하지 않는 것이 좋습니다. 단, Google 광고 ID가 없는 모든 Android 설치에는 필수적입니다. |
| 이 설치에 Unity Ads가 기여했는지, 비용이 청구될 수 있는지의 여부를 나타내는 플래그 |
| 기본값( |
설치 후 이벤트 포스트백 파라미터(필수)
커스텀 연동 포스트백 요청에서 다음 식별 파라미터를 릴레이합니다.파라미터 | 설명 | 예제 | 참고 |
|---|---|---|---|
| 설치 사용자의 Unity Ads 고유 게이머 ID | | |
| 디바이스용 대문자 형식의 Apple 광고 식별자(IDFA) | | IDFA는 모든 설치에 필수적입니다. ID의 raw 형식이나 해시 형식을 사용할 수 있습니다. |
| 소문자 형식의 Google Play 광고 ID | | |
| 소문자 형식의 MD5 해시 Google 광고 ID | | |
| 사용자가 광고 트래킹 제한을 활성화했는지 여부를 나타내는 플래그 |
| |
| Unity Ads 캠페인 식별자 | | UA 대시보드의 Campaigns 페이지에서 Campaign ID를 검색할 수 있습니다. |
| Unity Ads Game ID | | UA 대시보드에서 광고주 게임 ID를 검색할 수 있어야 합니다. SDK 연동에 사용하는 퍼블리셔 게임 ID(Monetization 대시보드)는 사용하지 않습니다. |
| 플랫폼 및 스토어 ID |
| iOS에는 다음과 같은 값을 사용할 수 있습니다.
|
| 플랫폼 및 번들 ID | | Android에는 다음 값을 사용할 수 있습니다.
|
| 플랫폼 및 Unity 프로젝트 ID | | Unity 대시보드의 Projects에서 Settings 탭을 통해 Project ID를 검색할 수 있습니다. |
| Unix 형식의 원래 설치 타임스탬프 | | 밀리초 사용이 타임스탬프에 권장됩니다. |
| 사용자가 게임플레이 세션을 시작했음을 나타내는 세션 이벤트 플래그 | | |
| 사용자의 인앱 결제 완료와 거래 금액을 나타내는 결제 이벤트 플래그 | | USD 통화 사용이 권장됩니다. |
| 사용자가 광고 수익을 창출했는지와 수익 금액을 나타내는 광고 수익 이벤트 플래그 |
|
|
| 원래 설치가 Unity에 기여되었는지 여부를 나타내는 플래그 | |
|
보조 포스트백 파라미터(선택 사항)
다음 설치 후 이벤트 파라미터는 필수는 아닙니다. GET 요청에서 다음 파라미터를 사용하여 앱의 설치 후 이벤트에 대한 추가 정보를 가져옵니다.파라미터 | 설명 | 예제 | 참고 |
|---|---|---|---|
| Unix 형식 설치 후 이벤트의 타임스탬프 | | 모든 타임스탬프에는 Unix 형식을 사용합니다. 권장되는 성공 사례는 밀리초이지만 Unity는 초 단위의 타임스탬프도 지원합니다. |
| 사용자의 IP 주소 | | |
| 광고 네트워크 이름 | | |
| 사용자의 ISO 3166-1 alpha-2 국가 코드 | | |
| 앱 버전 번호 | | |
| 디바이스 모델 이름 | | |
| 디바이스 OS 버전 | | |
| 사용자의 ISO 639-1 언어 코드 | | |
| 표시되는 광고 유형. 예: 인터스티셜 광고, 보상형 광고, 플레이어블 광고 또는 배너 | | 이 파라미터는
|
| |
| 지원되는 다음 이벤트 이름 중 하나를
|
| 트래킹 서비스 또는 MMP(모바일 측정 파트너) 이름 | | |
| 앱 이름 | | |
| 광고주 이름 | | |
| 광고 노출이 발생한 시점의 타임스탬프(Unix 형식) | | 모든 타임스탬프에는 Unix 형식을 사용합니다. 밀리초 단위 사용을 권장하지만, Unity는 초 단위의 타임스탬프도 지원합니다. |
| 광고 클릭이 발생한 시점의 타임스탬프(Unix 형식) | | 모든 타임스탬프에는 Unix 형식을 사용합니다. 밀리초 단위 사용을 권장하지만, Unity는 초 단위의 타임스탬프도 지원합니다. |
| 최종 사용자의 실제 이벤트로 집계되지 않는 서버의 테스트 포스트백 | |