어트리뷰션 링크 파라미터 참조

Read time 4 minutes

어트리뷰션 링크를 사용하면 앱 서버의 참여 데이터를 Unity Ads UA 캠페인으로 전달할 수 있습니다. 이러한 어트리뷰션 트래킹 링크는 다음 요구 사항을 참고하십시오.

어트리뷰션 링크를 검색하는 방법에 대한 자세한 내용은 선호하는 파트너 연동 기술 자료 또는 커스텀 연동 기술 자료를 참고하시기 바랍니다.

URL 요구 사항

어트리뷰션 트래킹 링크가 다음 요구 사항을 충족해야 합니다.

  • URL과 리디렉션에 HTTPS를 사용합니다.
  • {ifa} 동적 커스텀 토큰을 포함합니다. 자세한 내용은 동적 커스텀 토큰을 참고하십시오.
  • HTTP 3XX 리디렉션 코드를 사용합니다. HTML 또는 JavaScript 리디렉션을 사용해서는 안 됩니다.
  • URL을 Apple App Store 또는 Google Play 스토어로 리디렉트해서는 안 됩니다.

MMP에서 HTTPS를 지원하지 않는 경우, 유니티에 문의하여 도움을 받으십시오.

동적 커스텀 URL 토큰

Unity는 어트리뷰션 트래킹 URL에서 다음과 같이 동적으로 대체된 토큰을 지원합니다.

토큰설명예시참고

{ifa}(iOS)

원래의 대문자 형식의 플레인 텍스트로 된 iOS IDFA(광고주 식별자)입니다.
1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F

{ifa}(Android)

원래의 소문자 형식으로 된 Google 광고 ID입니다. 이는 Android에서 주 식별 수단으로 Android ID를 대체합니다. 전환 단계 중에 두 ID는 모두 표시되어야 합니다.

1234abcd-1234-5678-abcd-1a2b3c4d5e6f

{ifa_md5}(iOS)

원래의 대문자 형식의 MD5 해시가 지정된 iOS IDFA(광고주 식별자)입니다.
9dd6df49d764d6ada0b250a6376d7b44

{ifa_md5}(Android)

원래의 소문자 형식의 MD5 해시가 지정된 Google 광고 ID입니다.

9a6a0a84bd8003a97a2109f6c4
{android_id_md5}

MD5 해시 양식으로 MD5 해시가 지정된 Android 디바이스의 Android ID입니다. 이는 Google Play 서비스가 Android 디바이스에 인스톨되어 있지 않는 등, Google 광고 ID {ifa}를 사용할 수 없을 때만 사용되어야 합니다.

MD5 12345678ABCDEFGH = 5756ae9022b2ea1e47d84fead75220c8

{mmp}
모바일 측정 파트너의 이름입니다.
  • appsflyer
  • adjust
  • branch
  • tenjin
  • singular
{platform}
인스톨이 발생한 플랫폼입니다.
  • ios
  • android
{ip}
최종 사용자의 IP 주소입니다.
123.123.123.123
이는 정보 제공 목적으로만 제공되어 인스톨 트래킹을 위한 사용자 ID로는 적합하지 않습니다.
{organic}

이 인스톨이 유기적 트래픽으로 인해 발생한 것인지 여부를 나타내는 플래그입니다. 플래그는 다음 값을 참고하십시오.

  • organic=1은 광고 네트워크, Unity Ads 또는 기타 광고가 인스톨에 기여하지 않았음을 나타냅니다.
  • organic=0은 광고 네트워크가 인스톨에 기여했음을 나타냅니다.

  • organic=1(true)
  • organic=0(false)
{country_code}
사용자의 ISO 3166-1 alpha-2 국가 코드입니다(대문자).
GB

GB는 영국 및 북아일랜드를 나타냅니다.

{campaign_id}
Unity Ads 캠페인 ID입니다.
12345678abcdefgh9012ijkl
{campaign_name}
Unity Ads 캠페인 이름입니다.
my_ad_campaign
{game_id}
광고 대상 게임의 Unity Ads 게임 ID입니다.
1234567
{gamer_id}

LAT(제한적 광고 트래킹)가 'ON'으로 된 사용자를 트래킹하는 데 필수적인 고유 Unity Ads ID입니다. 이 경우 광고 ID의 값은 00000000-0000-0000-0000-000000000000입니다. 게이머 ID를 찾을 수 없는 경우 malformed 오류(응답 코드 400)가 발생합니다.

Malformed 또는 missing input data

{source_app_id}
광고를 표시하는 앱의 범용 소스 ID입니다. 이는 대소문자를 구분하는 영숫자 문자열입니다.
9g74cAw7WM1L

2020년 5월에 마이그레이션되기 전에는 이 토큰을 source_game_id라고 했습니다.

{source_game_id}

이 필드는 2020년 5월부터 지원 중단되었습니다.

{source_app_id} 토큰이 {source_game_id}를 대체합니다.

7654321

{source_app_id}가 이 토큰을 대체합니다.

{os}
최종 사용자 디바이스의 운영체제입니다.
  • 9.2.1(iOS)
  • 4.4.0(Android)
{device_type}
최종 사용자의 디바이스 유형입니다.
  • iPad4,1
  • motorola XT1254
  • samsung SM-G900F
{creative_pack}
광고에 사용되는 소재 팩의 이름입니다.
Video Creatives Pack - EN - 15s
{creative_pack_id}
광고에 사용되는 소재 팩의 고유 ID입니다.
5beafbce74ed83001acb258c
{language}
최종 사용자의 디바이스 언어입니다.
en-GB
{user_agent}
최종 사용자의 디바이스 사용자 에이전트입니다.
  • Mozilla/5.0(iPhone, Mac OS X와 같은 CPU iPhone OS 9_3_5)
  • AppleWebKit/601.1.46(Gecko와 같은 KHTML)
  • Mobile/13G36(iOS)
  • Mozilla/5.0(Linux, Android 6.0.1, SM-G920V Build/MMB29K)
  • AppleWebKit/537.36(Gecko와 같은 KHTML)
  • Chrome/52.0.2743.98 Mobile Safari/537.36(Android)
{device_make}
최종 사용자의 디바이스 제조사입니다.
  • Apple(iOS)
  • samsung(Android)
{device_model}
최종 사용자의 디바이스 모델입니다.
  • iPhone7,2(iOS)
  • SM-G900F(Android)
{is_skadnetwork_supported}

SKAdNetwork 지원 상태입니다.

true 또는 비어 있어야 함

이 필드는 iOS 디바이스만 지원합니다.
{video_orientation}
광고에 표시되는 소재의 방향입니다.
  • portrait
  • landscape
{screen_size}

화면 크기는 디바이스 타게팅을 따릅니다.

  • small
  • normal
  • large
  • xlarge
이 필드는 Android 디바이스만 지원합니다.
{screen_density}

화면 밀도는 디바이스 타게팅을 따릅니다.

  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
이 필드는 Android 디바이스만 지원합니다.