측정 URL 권장사항

보기 또는 클릭을 통한 사용자와 측정 URL 간의 상호작용은 MAT(MobileAppTracking)™에서 측정 세션을 시작하는 기본 메커니즘입니다. 연동은 이후의 설치(또는 인앱 이벤트)와 연관되어 있으며 사용자의 모바일 앱 설치에 영향을 미치는 광고 파트너에 기인합니다.

MAT 측정 URL은 다량의 데이터를 MAT으로 가져오기 위한 우아한 솔루션입니다. 측정 URL에는 몇 가지의 필수 파라메터를 비롯해 보고서에 추가 색상과 심도를 추가하는 데 사용할 수 있는 매우 다양한 옵션 파라메터가 포함됩니다. 올바른 파라메터를 사용하고 우수 사례를 준수함으로써 귀하의 요구 사항에 맞게 조정된 URL을 구축하고 보고를 맞춤 설정할 수 있습니다.

 

기본 MAT 측정 URL

기본 MAT 측정 URL은 세 가지의 주요 구성 요소로 이루어지며 모두 다음이 필요합니다.

1. 기본 도메인 URL(필수)

일군의 기본 도메인 이름(api-02api-03 등)이 있으며 정기적으로 새로운 것으로 교체합니다. 기본 URL에는 언제나 URL이 만들어진 해당 MAT 파트너 ID가 포함됩니다.

http://MAT_PARTNER_ID.api-02.com/serve

 

2. 액션 파라메터(필수)

필수, 클릭연결 URL과 노출수 URL 구분에 사용됨. 유효한 값은 다음과 같습니다.

  • ?action=클릭수 – 클릭연결 측정에 사용
  • ?action=노출수조회연결 전환 측정에 사용

3. 앱 및 캠페인 파라메터(필수)

  • &publisher_id=MAT_PUBLISHER_ID – 네트워크 파트너 식별
  • &site_id=MAT_APP_ID – 링크에 해당하는 앱 식별
  • &offer_id=MAT_CAMPAIGN_ID – 링크와 연관된 캠페인 식별

4. 고유 기기 식별자(필수는 아니나 권장됨)

필수는 아니지만 100%의 정확도로 1:1 애트리뷰션을 보장하므로 기본 MAT 측정 URL에 고유 기기 식별자를 포함시킬 것을 강력하게 권장합니다. 아래의 파라메터 값을 제공하는 경우 선택한 광고 네트워크에 의해 지원되는 하드 코딩된 값이나 {} 매크로를 제공해야 합니다.

  • &ios_ifa=Value – 원시 iOS IFA
  • &ios_ifa_md5=Value – IFA의 MD5 해시
  • &ios_ifa_sha1=Value – IFA의 SHA1 해시
  • &device_id=Value – EMEI, Android 기기에서만 가능함.
  • &device_id_md5=값
  • &device_id_sha1=값
  • &device_id_sha256=값
  • &android_id/&os_id=Value – 원시 Android ID 또는 Windows 하드웨어 ID
  • &android_id_md5/&os_id_md5=Value – Android ID 또는 Windows 하드웨어 ID MD5 해시
  • &android_id_sha1&os_id_sha1=Value – Android ID 또는 Windows 하드웨어 ID SHA1 해시
  • &windows_aid=Value – Windows 광고 ID
  • &windows_aid_md5=Value – Windows 광고 ID MD5 해시
  • &windows_aid_sha1=Value – Windows 광고 ID SHA1 해시
  • &user_id=Value – 앱에 의해 사용자에 할당된 맞춤 id. 주로 재참여 캠페인에 유용함
  • &tpid=Value – 사용 중단된 UDID에 대해 개인정보가 보호되는 대안으로 TRUSTe가 만든 지속적 교차 애플리케이션 고유 기기 식별자. 일반적으로 사용되지 않음.
  • &mac_address=Value – 사용 중단됨
  • &mac_address_md5=Value – 사용 중단됨
  • &mac_address_sha1=Value – 사용 중단됨
  • &odin=Value – 사용 중단됨

Partner_Guide_-_Measurement_URLs_-_New_Page.png

캠페인 최적화 파라메터

캠페인은 모바일 앱과 광고 파트너 간의 MAT 관리 계층입니다. MAT의 캠페인은 다수의 광고 관계를 관리하는 것을 도와줍니다. MAT 내의 파트너를 위한 특정 트래픽 출처나 특정 파트너를 위해 캠페인을 설정하지 않습니다. MAT에서 각 파트너에 대해 고유한 캠페인을 만드는 것도 생각해볼 수 있지만 수백 또는 수천 개의 캠페인 범위에 도달하면 관리가 어려워집니다.

그 대신 MAT 자체 내에서 개별적인 켐페인을 파트너와 하위 캠페인으로 생각하는 것이 좋습니다. 그러므로 새 캠페인을 만드는 대신 측정 URL의 “my_campaign” 파라메터를 사용하십시오. 보고를 광고(“my-ads“), 광고그룹("my_adgroups“), 사이트(“my_site“)별로 구분하고자 할 경우에도 마찬가지입니다. 다음 섹션에는 모바일 앱 마케팅 보고서를 구성하기 위해 사용할 수 있는 sub_parameters가 설명되어 있습니다.

광고주와 파트너가 다양한 데이터 및 보고 요구 사항을 갖고 있으므로 MAT는 광고주와 파트너 모두를 위해 측정 URL에 포함되는 유사한 하위 파라메터를 제공합니다(아래 그래픽 참조). 광고주는 하위 파라메터 및 파트너의 하위 파라메터에 대한 액세스를 보유한 한편 파트너는 자신의 하위 파라메터에 대한 액세스만 보유합니다. 하위 파라메터는 액추얼, 통계집단, 로그 보고서에서 사용할 수 있어 실적 분석과 비교가 더 쉬워집니다.

Best_Practices_for_Tracking_Links_2_URL_Params.png
 

파트너 캠페인 최적화 하위 파라메터

파트너는 다음 6가지의 캠페인 하위 파라메터를 사용할 수 있습니다.

  • sub_publisher – 클릭 시 측정 URL에 전달되는 “sub_publisher“의 값. 이 값은 파트너 퍼블리셔의 이름 또는 ID입니다.
  • sub_site – 클릭 시 측정 URL에 전달되는 “sub_site“의 값. 이 값은 파트너 사이트 또는 모바일 앱의 이름 또는 ID입니다.
  • sub_campaign – 클릭 시 측정 URL에 전달되는 “sub_campaign” 의 값. 이 값은 파트너와 광고 중인 캠페인의 이름 또는 ID입니다.
  • sub_adgroup – 클릭 시 측정 URL에 전달되는 “sub_adgroup“의 값. 이 값은 파트너와 광고 중인 광고그룹의 이름 또는 ID입니다.
  • sub_ad – 클릭 시 측정 URL에 전달되는 “sub_ad“의 값. 이 값은 파트너와 광고 중인 광고의 이름 또는 ID입니다.
  • sub_keyword – 클릭 시 측정 URL에 전달되는 “publisher_sub_keyword“의 값. 특히 Googld 애드워즈 연동(및 기타 검색 캠페인)과 관련된 키워드의 이름 또는 ID입니다.

특정 파트너 시스템이 구성된 방식을 토대로 이러한 파라메터를 사용하십시오. 모든 파트너가 6가지의 모든 최적화 파라메터에 대한 데이터를 제공하는 것은 아닙니다.

 

광고주 캠페인 최적화 하위 파라메터

광고주는 파트너 하위 파라메터에서 다음 6가지 하위 파라메터를 개별적 및 독립적으로 사용할 수 있습니다. 이러한 새로운 광고주 파라메터는 파트너가 설정한 것과 다른 값을 설정하는 클라이언트 문제를 해결합니다. 이제 클라이언트(광고주)는 자신들의 2번째 파라메터 집합을 정의할 수 있습니다.

  • my_partner – 클릭 시 측정 URL에 전달되는 “my_publisher“의 값. 광고주 파트너의 이름 또는 ID입니다.
  • advertiser_sub_site – 클릭 시 측정 URL에 전달되는 “my_site“의 값. 광고주 사이트 또는 모바일 앱의 이름 또는 ID입니다.
  • advertiser_sub_campaign – 클릭 시 측정 URL에 전달되는 “my_campaign“의 값. 캠페인의 이름 또는 ID입니다.
  • advertiser_sub_adgroup – 클릭 시 측정 URL에 전달되는 “my_adgroup“의 값. 광고그룹의 이름 또는 ID입니다.
  • advertiser_sub_ad – 클릭 시 측정 URL에 전달되는 “my_ad“의 값. 광고의 이름 또는 ID입니다.
  • advertiser_sub_keyword – 클릭 시 측정 URL에 전달되는 “my_keyword“의 값. 특히 Googld 애드워즈 연동(및 기타 검색 캠페인)과 관련된 키워드의 이름 또는 ID입니다.

특정 광고주 시스템이 구성된 방식을 토대로 이러한 파라메터를 사용하십시오. 모든 광고주가 6가지의 모든 최적화 파라메터에 대한 데이터를 제공하는 것은 아닙니다.

 

sub_publisher / my_partner

광고 네트워크는 다수의 파트너(퍼블리셔)를 광고주와 연결하는 조정 대행사이므로 일반적으로 이들만 “sub_publisher” 정보를 제공합니다. 일부 광고 네트워크는 네트워크에 파트너의 이름 또는 ID를 전달하여 파트너별 실적을 분석 및 최적화할 수 있게 합니다. 대부분의 경우 광고 네트워크는 파트너의 이름 또는 ID를 동적으로 전달해야 하므로 특히 이 기능에 관해 물어야 합니다. 블라인드 네트워크를 보유한 파트너와 광고를 진행하는 경우 파트너 정보(sub_publisher)를 전달할 수 없습니다. 일반적으로 직접적인 파트너 관계(광고 네트워크 파트너 아님)에는 하위 퍼블리셔가 포함되지 않습니다

예를 들어 광고 네트워크는 인터넷 라디오 서비스인 “Pandora” 트래픽에서 수익을 창출합니다. 따라서 “publisher_id” 하위 파라메터는 MAT에서 만들어진 “publisher_id” 파라메터와 관련됩니다. 그러므로 이 예시의 “sub_publisher” 파라메터는 다음 측정 URL 예시에 표시된 대로 Pandora와 동일합니다.

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=100&site_id=1000&my_partner=Pandora
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=100&site_id=1000&sub_publisher=Pandora

 

sub_site / my_site

모바일 웹에서 광고를 한다면 “sub_site” 파라메터가 광고를 표시하는 웹 사이트 또는 속성을 식별합니다(모바일 앱은 “사이트”로도 분류됨). 대형 비디오 게임 파트너와 협력 중이며 그들의 모바일 앱 몇 가지를 광고하고 있다면 각 모바일 앱의 이름 또는 ID에 대하여 “sub_site” 파라메터를 설정합니다. 파트너 모바일 앱에서 특정 광고를 구매할 경우 “sub_site” 값을 동적으로 생성하는 대신 하드 코딩할 수 있는 선택지가 주어집니다. 광고 네트워크 또한 “sub_site” 정보를 전달할 수 있지만 사이트 특정 구매를 하는 것은 광고 네트워크에서 일반적이지 않으므로 동적으로 전달해야 합니다.

예를 들어 여러 개의 앱을 보유한 게임 스튜디오를 위해 앱을 광고하는 경우 다음 측정 URL 예시에서 보듯이 앱 이름을 이용해 “sub_site” 값을 동적으로 설정합니다.

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_site={sub_site}
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_site={sub_site}

 

sub_campaign / my_campaign

캠페인은 모바일 앱을 위한 광고 계획을 수립하며 점차 해당 캠페인의 이름, 도착 URL(방문 페이지), 비용/입찰, 광고그룹, 광고를 포함합니다. 기본적으로 대부분의 광고 네트워크와 파트너는 캠페인 이름 또는 ID를 동적으로 전달하지 않으므로 측정 URL(및 파트너에 따라 광고그룹의 이름 또는 ID)에서 수동으로 캠페인 이름을 하드 코딩해야 합니다.

예를 들어 동일한 파트너와 2건의 캠페인(하나는 장려되며 다른 하나는 아님)을 진행하고 있다면 다음 측정 URL 예시에서 볼 수 있듯이 캠페인을 구별하기 위해 sub_campaign 값 입력 이름을 “Incentivized”로 설정합니다.

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_campaign=Incentivized-US
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_campaign=Incentivized-US

 

sub_adgroup / my_adgroup

광고그룹을 사용하는 파트너는 측정 URL에서 광고그룹 값을 동적으로 지정할 수 있습니다. 광고그룹을 사용하지 않는 파트너는 일반적으로 각 캠페인에서 2계층 관리에 캠페인과 광고를 제공합니다. 광고그룹이 없을 때는 “sub_adgroup” 파라메터는 측정에 대해 유효한 하위 파라메터가 아닙니다.

예를 들어 728×90 배너 광고에 대한 광고그룹을 만들면 측정 URL은 다음 측정 URL 예시와 비슷하게 보이게 됩니다.

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90

 

sub_ad / my_ad

sub_ad” 파라메터를 사용함으로써 파트너와 구성한 특정 광고의 이름 또는 ID를 전달할 수 있습니다. 일반적으로 이 값은 각 광고의 이름 또는 ID로 하드 코딩됩니다. 5가지의 서로 다른 광고를 실행한다면 각 광고에 대해 하드 코딩된 다른 값을 사용하게 됩니다.

예를 들어 728×90 배너 광고그룹에서는, AdwithBlue“라는 이름의 파란색 배너가 있다면 측정 URL가 다음 측정 URL 예시와 유사하게 보이게 됩니다.

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90&my_ad=AdwithBlue
  • advertiser_sub_ad” as a numerical ID:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_adgroup=Banner728x90&my_ad=101
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90&sub_ad=AdwithBlue
  • sub_ad” 숫자형 ID:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_adgroup=Banner728x90&sub_ad=10

 

sub_keyword / my_keyword

sub_keyword” 파라메터를 사용하는 데 Google 애드워즈 연동(및 기타 검색 캠페인)과 관련된 키워드 이름 또는 ID를 전달할 수 있습니다. 예:

  • 광고주 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&my_keyword=MyKeyword
  • 파트너 예시:
    https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub_keyword=PartnerKeyword

 

조정을 위한 추가 파라메터

MAT 또한 로그 및 포스트백 URL 보고서에서 사용할 수 있는 5가지의 추가 파라메터를 지원하며 일반적으로 파트너에 대한 고유한 정보를 저장하지만 교차 채널 분석을 위해 표준화되지 않았기 때문에 보고 수집을 위한 실적 보고서에서 사용될 수 없습니다.

이러한 추가 파라메터에는 다음과 같은 것이 있습니다.

  • 하위1 – 파트너가 지정한 추가 정보 문자열입니다.
  • 하위2 – 파트너가 지정한 추가 정보 문자열입니다.
  • 하위3 – 파트너가 지정한 추가 정보 문자열입니다.
  • 하위4 – 파트너가 지정한 추가 정보 문자열입니다.
  • 하위5 – 파트너가 지정한 추가 정보 문자열입니다.

다음 URL 예시는 “sub1” 파라메터를 포함시키는 측정 URL을 보여줍니다.

https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub1=12345678900001

 

다음 URL 예시는 “sub1“과 “sub2” 파라메터를 모두 포함시키는 측정 URL을 보여줍니다.

https://12345.api-02.com/serve?action=click&publisher_id=200&site_id=1000&sub1=12345678900001&sub2=98765

 

필요에 따라 하나 또는 5가지의 추가 파라메터를 모두 설정할 수 있습니다. 최적화 하위 파라메터가 최대 100자 길이의 문자열 값을 지원하는 반면 이 추가 하위 파라메터는 최대 500자 길이의 값을 지원합니다.

참조 ID 파라메터

참조 ID는 파트너 시스템의 특정 참조 ID(퍼블리셔 트랜잭션 ID, 클릭 ID, 광고 ID, 추적 ID 등으로도 알려짐)에 예약된 추가 파라메터(“sub1“~”sub5“와 유사)입니다. 참조 ID를 사용하는 것에 관해 자세히 알아보려면 참조 ID의 사용 용도를 참조하십시오.

 

국가 코드/기기 IP 사용하기

파트너가 MAT과의 고유한 연동을 갖추고 있으며 서버 측의 클릭수를 측정한다면 이러한 파트너의 모든 클릭수(더 나아가 그 클릭수에 애트리뷰션된 모든 설치)는 서버의 지리적 위치에서 발생하는 것으로 보입니다. 이 문제를 해결하려면 MAT가 원래의 적합한 지리적 위치에 설치를 애트리뷰션할 수 있도록 MAT에 클릭수에 대한 2문자 ISO 국가 코드 또는 기기 IP를 전달합니다.

  • country_code – 클릭이 발생한, 2글자 또는 3글자의 ISO 국가 코드
  • device_ip – 클릭 시 수집된 기기의 IP 주소.

비용 데이터 전달

이제 측정 URL을 통해 동적으로 비용 데이터를 전달할 수 있습니다. 이 기능성은 비용 및 cost_model 파라메터를 바탕으로 하며 비용 데이터 제공하기에 관한 문서에 자세히 설명되어 있습니다.