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

요약: 어트리뷰션 링크는 클릭이나 모바일 광고 노출 관련 유저 활동을 앱스플라이어에 리포트 합니다. 어트리뷰션 링크가 클릭되면, 사용자가 앱을 다운로드 할 수 있도록 리디렉션하고, 클릭된 URL 사본을 앱스플라이어에게 전송합니다. 앱스플라이어에서는 링크의 일부가 로데이터 리포트를 작성하는데 사용됩니다. 

앱스플라이어의 기본 어트리뷰션 링크

기본 어트리뷰션 링크는 클릭을 기록하고 사용자가 앱을 다운로드 할 수 있도록 리디렉션 하는 최소 정보를 포함합니다. 추가 파라미터는 추가 정보를 기록하기 위해 링크 뒤에 ? 부호를 붙이고, 더해질 수 있습니다.

http://app.appsflyer.com/{app_id}?pid={media_source}


기본 어트리뷰션 링크는 {App_id} 를 포함하고 있습니다. 이것은 애플 아이튠즈/앱스토어의 경우 앱 ID, 구글 플레이와 유료 채널(미디어 소스)의 경우 패키지 이름입니다. 이는 어트리뷰션 링크에 대한 최소 요구사항입니다.

참고: 아마존 앱의 경우 bundle/package name을 사용하십시오. (ASIN에 비해서).

 

com.greatapp 앱를 위한 다음의 어트리뷰션 링크는 퍼플리셔 ID(pid), 캠페인 이름(c), 광고 세트 ID(af_adset_id)와 같은 몇몇 파라미터들을 사용하고 있습니다. 지원되는 어트리뷰션 링크 파라미터의 전체 목록과 설명은 아래 표를 참고하십시오.
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822

어트리뷰션 링크 파라미터

다음 파라미터들은 생성된 트래킹 링크에서 사용 가능합니다.

필드 유형 열의 숫자는 파라미터 값 문자 제한입니다. 파라미터 값 길이 제한 사항에 대한 상세 내용은 여기를 참고하십시오.

파라미터 표시 이름 설명

필드 유형

pid 미디어 소스 연동 파트너에게 앱스플라이어가 제공한 것이며, 변경되면 안됩니다. 더 보기.

String 50

c 캠페인 광고주/퍼블리셔가 제공한 캠페인 이름. 캠페인 이름이 100자를 초과하면 "c_name_exceeded_max_length"라고 대시보드에 표시됩니다.

String 100

af_prt

에이전시

  • 에이전시 계정 이름으로, 앱 설치를 에이전시로 어트리뷰션 할 수 있도록 합니다.
  • 주의: 에이전시 권한이 활성화 되기 전에 이 파라미터를 사용하지 마십시오.

String 50

af_mp

마케팅 파트너

  • 퍼블리셔 마케팅 파트너로 인스톨 별 포스트백을 보낼 수 있게합니다.
  • 참고: 현재 이 파라미터는 핀터레스트 마케팅 파트너만 연관됩니다.

 

clickid

N/A

애드 네트워크 고유의 클릭 식별자

 

af_siteid

Site ID

광고 네트워크 퍼블리셔 ID

String 24

af_sub_siteid

하위 사이트 ID

광고 하위 네트워크와 퍼블리셔 ID

String 50

af_c_id

캠페인 ID

광고주/퍼블리셔 제공.

String 24

af_adset

광고세트

  • 광고주/퍼블리셔 제공.
  • 광고 세트는 중간 체계 수준으로, 캠페인과 광고 사이입니다. 더 보기

String 100

af_adset_id

광고세트 ID

광고주/퍼블리셔 제공.

String 24

af_ad

광고

광고주/퍼블리셔가 제공하는 광고 이름 (더 보기)

String 100

af_ad_id

광고 아이디 광고주/퍼블리셔 제공.

String 24

af_ad_type*

광고 타입

광고 유형은 다음과 같은 이름 지정 규칙을 사용합니다.

  • text: 오직 문자만 포함하는 광고 유닛, 예: 검색 결과
  • banner: 디바이스 화면 상단이나 하단에 표시되는 기본 유형
  • interstitial: 현재의 유저 경험 중 쉬는 시간에 표시되는 전면 광고
  • video: 일반 비디오. 즉, 비보상형
  • rewarded_video: 비디오를 시청함으로써 인앱 보상을 제공하는 광고 유닛
  • playable: 상호적인 앱 경험 미리보기를 포함하는 광고 유닛
  • sponsored_content: 광고 기사와 같이, 스폰서된 컨텐츠를 포함하는 링크
  • audio: 오디오 광고

String 24

af_click_lookback

클릭 어트리뷰션을 위한 룩백 윈도우. 이 윈도우의 기간은 새로운 유저가 광고/링크가 게재된 미디어 소스에 어트리뷰션 될 수 있는 최대 CTIT(Click To Install Time, 클릭에서 앱 설치까지 소요시간)입니다.

설정 가능한

클릭 룩백 어트리뷰션 기간. 이용 가능한 파라미터 값: 1d~30d(일) 또는 1h-23h(시간). 기본 값은 7d 입니다.

참고: 오직 클릭 URL에만 영향을 주며 impression URL과는 무관합니다.

3 char max

af_viewthrough_lookback

View-through어트리뷰션을 위한 기여 기간

설정 가능한 뷰-쓰루 어트리뷰션 룩백 윈도우 기간. 이용 가능한 파라미터 값: 1h - 48h (시간) 또는 1d - 7d (일) 기본 값은 1d입니다.

참고: 오직 impression URL에만 영향을 주며 클릭 URL과는 무관합니다.

3 char max

is_retargeting

Is Retargeting Campaign?

모든 리타겟팅 캠페인의 클릭 URL은 &is_retargeting=true를 반드시 포함해야 합니다.
이 파라미터가 포함되지 않았거나 값이 "false"이면 캠페인은 일반 유저 유입 캠페인으로 간주됩니다.

Enum 5 char

af_reengagement_window

리인게이지먼트 기간

이 파라미터를 어트리뷰션 링크에 추가하여 리인게이지먼트 윈도우 기간을 변경합니다.

가능한 윈도우 범위 옵션은 다음과 같습니다.

  • 일: 1-90 또는 시간 1-36
  • 라이프타임: 리인게이지먼트 윈도우가 무제한임을 의미합니다. 예시: &af_reengagement_window=lifetime

기본 값: 30 일

예를 들어, &af_reengagement_window=30d 는 리인게이지먼트 기간을 30일로 설정합니다.

3 char max

af_channel

채널

광고가 배포되는 미디어 소스 채널. 예시: UAC_Search, UAC_Display, Instagram, Facebook Audience Network 등.

Dynamic Enum. String 20

af_keywords

키워드

텍스트 타겟팅 캠페인을 위한 키워드 리스트

String 100

af_cost_model

비용 모델

  • 클릭에 의해 비용이 리포트될 때의 비용 모델로서 앱스플라이어 통합 데이터 리포트의 비용 값을 제공합니다. 현재 유일하게 지원되는 모델은 CPI (기본 값).
  • API로 비용 리포트를 할 수 있는 곳. 링크 상으로도, API로도 비용이 리포트된 경우, API가 우선합니다.  

String 20

af_cost_currency

비용 통화

  • ISO-4217을 따르는 3 글자 통화 코드. 예시, USD, KRW, EUR
  • 기본 값: USD

Enum. 3 char 

af_cost_value

비용 값

  • 비용 통화를 이용한 비용 값.  
  • 소수점 이하 4자리까지 가능.
  • 오짓 숫자로만 설정하십시오. (필요한 경우, 소수점 사용) 예: "56", "2.85"

String 20

af_sub[n] 

(n=1-5) 예시: af_sub1

Sub Param [n]

광고주에 의해 지정된 선택적 커스텀 파라미터. 이러한 파라미터의 사용법에 대한 더 많은 정보는 자주 묻는 질문 부분을 참고하십시오.

String 100

af_r N/A 안드로이드와 iOS 두 플랫폼 모두 유저를 지정된 URL로 리디렉션 합니다.  
af_web_dp N/A 데스크톱 사용자를 원링크 템플릿에서 설정된 것과 다른 웹 페이지로 리디렉션합니다. 이 파라미터를 사용하여 데스크톱 사용자의 어트리뷰션 데이터를 다른 플랫폼 환경에서 유지합니다. (예: 구글 애널리틱스 또는 Omniture)  
af_dp N/A 사용자가 딥링킹 된 앱에서 내부 활동을 위한 경로 입니다. 딥링킹과 리타겟팅을 위해 사용하세요.  
af_force_deeplink N/A af_dp 밸류에 지정된 액티비티로 강제 딥링킹 합니다.  
af_ref N/A
S2S 클릭을 이용하는 애드 네트워크는 고유 리퍼러 값을 다음 파라미터를 사용하여 전송할 수 있습니다: &af_ref=ReferrerValue
 
이 af_ref value 값은 반드시 고유한 값으로 다음과 같이 구성되어야 합니다.:
NetworkName_UniqueClickValueForEachClick
 
예시: af_ref=networkname_123456789ABCDEF
 
네트워크 이름은 아무런 유효 문자열이면 가능합니다. networkname_int 또는 그냥 networkname 도 가능합니다.
 
앱스플라이어는 이 파라미터를 안드로이드 디바이스 어트리뷰션에 사용할 수 있습니다. 앱스플라이어는 이 파라미터를 iOS나 윈도우즈 디바이스 어트리뷰션에 사용하지는 않습니다.
 
 
is_incentivized true/false
인센티브를 받을 수 있는지 받을 수 없는 캠페인인지 여부
 
af_param_forwarding 설정 값이 false 일 때, 어트리뷰션 링크 상의 파라미터는 리디렉션된 페이지로 전달되지 않습니다.
리디렉션된 페이지에서 URL이 깔끔하게 보여지길 필요한 경우에 사용하거나, 리디렉션된 페이지를 처리하는 쿼리 파라미터 때문에 어트리뷰션 링크 파라미터가 문제를 발생시킬 가능성이 있는 경우에 사용합니다.
 

*광고 유형에 따라 인게이지먼트의 상세 내용을 설명할 수 있는 가시성 파라미터를 전송할 수 있습니다. 다음은 예상되는 가시성 파라미터와 “af_ad_type”에 대해 가능한 값의 목록입니다.

파라미터 값 형식 (value format) 설명
af_video_total_length   비디오의 전체 가능한 길이
af_video_played_length   얼마만큼의 비디오가 시청되었는가
af_playable_played_length   완전히 로드된 이후, 얼마만큼의 재생 가능 요소가 재생되었는가
af_ad_time_viewed   화면에서 얼마나 오래 광고 유닛이 보여졌는가
af_ad_displayed_percent   디바이스 화면에서 광고 유닛이 보여질 수 있는 최대 비율
af_audio_total_length   오디오의 전체 가능한 길이
af_audio_played_length   얼마만큼의 오디오가 청취되었는가

안드로이드 전용 파라미터

파라미터 표시 이름 설명

필드 유형

advertising_id

Advertising ID

구글 광고 ID - 애드 네트워크 지원 필요

40 char max

sha1_advertising_id

N/A

SHA1으로 해시된 구글 광고 ID - 애드 네트워크 지원 필요

 

md5_advertising_id

N/A

MD5로 해시된 구글 광고 ID - 애드 네트워크 지원 필요

인스톨과 리어트리뷰션에서만 지원

android_id

Android ID

Device Android_id이며 광고 네트워크 지원이 필요합니다.

20 char max

sha1_android_id

N/A

SHA1으로 해시된 디바이스 Android_id - 애드 네트워크 지원 필요

 

md5_android_id

N/A

MD5로 해시된 디바이스 Android_id - 애드 네트워크 지원 필요

인스톨과 리어트리뷰션에서만 지원

IMEI

IMEI

디바이스 IMEI ID

 

sha1_imei

N/A

SHA1으로 해시된 디바이스 IMEI ID - 애드 네트워크 지원 필요

 

md5_imei

N/A

MD5로 해시된 디바이스 IMEI ID - 애드 네트워크 지원 필요

 

oaid

oaid

Open Anonymous Device Identifier

안드로이드 SDK 4.10.3에서 가능

sha1_oaid

N/A

SHA1으로 해시된 Open Anonymous Device Identifier - 애드 네트워크 지원 필요

안드로이드 SDK 4.10.3에서 가능

md5_oaid

N/A MD5로 해시된 Open Anonymous Device Identifier - 애드 네트워크 지원 필요 안드로이드 SDK 4.10.3에서 가능

af_android_url

N/A

Android 사용자를 구글플레이의 앱 페이지외의 다른 URL로 리디렉트 합니다. 이 파라미터는 out-of-store 앱을 위해 사용할 수 있습니다.

 

sha1_el

N/A

데스크톱에서 모바일로의 어트리뷰션을 위해 사용되는, SHA1으로 해시된 이메일. 애드 네트워크 지원 필요.

 

fire_advertising_id

N/A

아마존의 Fire 광고 ID

 


iOS 전용 파라미터

파라미터 표시 이름 설명

필드 유형

idfa

IDFA

Apple Advertiser ID(애플 광고 ID)로 대문자 형식으로 제공하여야 합니다. 광고 네트워크 지원이 필요합니다.

40 char max

af_ios_url

iOS 사용자를 iTunes의 앱 페이지 외 다른 URL로 리디렉션 합니다.

랜딩 페이지 리다이렉션을 위해 사용할 수 있습니다.

 

af_ios_fallback

N/A

iOS 10.3 유저를 위해 폴백 URL을 제공

 

sha1_idfa

N/A

애플 광고주 ID을 SHA1으로 해시한 값입니다. 광고 네트워크 지원이 필요합니다.

 

mac

N/A

기기 맥 주소. 광고 네트워크 지원이 필요합니다.

 

sha1_mac

N/A

SHA1으로 해시된 디바이스 mac address. 애드 네트워크 지원 필요.

 

 

http://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
	  af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign

모든 파라미터는 인스톨 리포트애널리틱스, 리포트 및 API에서 사용 가능합니다.

커스텀 파라미터

안드로이드 특정 및 iOS 특정 기본 파라미터에 더하여, 커스텀 파라미터를 지정할 수 있습니다. 이런 커스텀 파라미터는 앱 설치를 가져오는 어트리뷰션 링크에 따라 사용자 경험 및 컨텐츠를 맞춤 설정하려는 경우 도움이 됩니다.

어트리뷰션 링크에 parameter=value의 형태로 커스텀 파라미터를 부착할 수 있습니다. 예시:

http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value

커스텀 파라미터 관련 두 가지 중요 사항이 있습니다.

왜 PID(퍼블리셔 ID)가 가장 중요한 파라미터일까요?

사용 가능한 모든 어트리뷰션 링크 파라미터 중에 PID 파라미터가 가장 중요한 이유는 모든 트래킹 링크에서 반드시 포함되어야 할 유일한 파라미터이기 때문입니다. 

퍼블리셔 ID인 PID는 사실상 미디어 소스 이름입니다. 앱 설치를 유입 소스로 어트리뷰션 하기 위한 주요 필드입니다.

앱스플라이어의 각 연동 파트너는 "_int"로 끝나는 고유 PID값을 가집니다. 커스텀 어트리뷰션 링크를 사용할 때는 원하는 PID 이름을 설정할 수 있습니다. 연동 파트너에게 할당된 값만 아니면 됩니다. 

중요한 연동 퍼블리셔 아이디의 예시: organic, googleadwords_int (Google AdWords), Facebook ads, Twitter. 이메일, 문자 메시지 또는 메일 서비스처럼 연동된 파트너가 아닌 경우는 어떤 이름이든 사용할 수 있습니다.

흔한 PID 관련 문제를 피하려면

파라미터를 사용할때 다음의 PID 규칙을 고려하세요:

1. 어트리뷰션 링크에 PID를 항상 포함합니다.

어트리뷰션 링크에 PID가 없으면, 유저는 자동으로 "None" 미디어 소스에 어트리뷰션 되며 원래의 인스톨 소스는 사라집니다.

2. 커스텀 소스에는 연동 파트너 PID가 아닌 PID를 사용합니다
각각의 연동 소스는 앱 설치를 정확하게 어트리뷰션 하기 위해 지정된 PID만을 사용해야 합니다. 이메일, 문자 메시지 또는 페이스북에서의 무료 바이럴 포스트와 같은 커스텀 미디어 소스를 사용하려면 연동된 PID 값이 아닌 것을 사용하십시오.
 
3. 올바른 문자만을 사용 할 것
만약 어트리뷰션 링크에 포함된 PID 파라미터에 다음의 문자가 포함되면 ":<>*&?/" - 클릭과 앱 설치가 대시보드에 invalid_media_source_name 아래 표시됩니다.

 

PID 값에는 공백 사용을 피하거나, 링크를 사용하기 전에 어트리뷰션 링크를 URL 인코딩 하십시오.

데이터 세분화 수준

최대 네 개의 URL 파라미터를 사용하여 심층적으로 광고 성과를 파악할 수 있습니다.

어트리뷰션 링크에서 4개의 파라미터를 모두 사용하면 다음을 할 수 있습니다.

  • 모든 사용자 설치와 이벤트를 특정 광고에 어트리뷰트하고
  • 모든 단계에서 최적화하기 위해, 통합 리포트의 모든 미디어 소스, 캠페인 및 광고 세트 당 모든 광고의 성과를 드릴 다운하여 비교합니다.
  • 로데이터 보고서와 피벗 테이블에서 모든 미디어 소스를 대상으로 광고를 비교할 수 있습니다.

파라미터는 다음과 같습니다:

  1. 미디어 소스 (pid=)
  2. 캠페인 이름 (c=)
  3. 광고 세트 (af_adset=)
  4. 광고 이름 (af_ad=)

 

다음의 어트리뷰션 링크는 4 단계의 세분화 수준을 사용하여 연동된 미디어 소스 "networkx"의 캠페인 "winter"의 광고 세트 "coats" 내의 광고 "cashmere"를 기록합니다.

http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

자주 하는 질문

파라미터에 소문자를 써야합니까? 대문자를 써야합니까?

둘 중 하나를 사용할 수 있지만, 일관성이 있어야 합니다. 커스텀 파라미터를 대문자 또는 소문자로 설정했다면, 반드시 동일한 파라미터를 사용하십시오.

예를 들어, pid=MyMediaSource라고 사용하기로 했다면, 항상 이렇게 사용하십시오. 만약 어떤 어트리뷰션 링크에 pid=MyMediaSource 를 사용하고 다른 어트리뷰션 링크에 pid=mymediasource 를 사용하면 데이터가 불일치할 수 있습니다. 어트리뷰션 링크에서 설정한 다른 파라미터도 마찬가지입니다.

앱스플라이어 어트리뷰션 링크는 동적입니까? 정적입니까?

앱스플라이어의 어트리뷰션 링크는 트래커가 아니며, 동적 또는 정적 모두 가능합니다.
링크가 동적인지 정적인지 어떻게 알 수 있을까요? 만약 어트리뷰션 링크가 파라미터를 포함하고 있으면, 이 링크는 사전에 정의된 긴 트래킹 링크이고 정적입니다.
커스텀 어트리뷰션 링크에서 사용되는 단축 URL만동적입니다.
이것은 연동 파트너를 위해서 어트리뷰션 링크를 사용하거나, 온드 미디어를 위해서 긴 URL을 사용하기 시작했다면, 앱스플라이어 대시보드에서 어트리뷰션 링크의 값을 변경하더라도 여기에 참여할 잠재 사용자들을 위해 링크가 변경되지 않는다는 것을 의미합니다. 변경을 적용하기 위해서는 새로운 긴 URL을 만들어 사용해야 합니다.
반면에, 온드 미디어를 위해서 단축 URL을 사용했다면, 파라미터를 직접 추가하지 마십시오. 잠재 사용자가 앱스플라이어의 단축 URL에 참여하면, 잠재 사용자는 앱스플라이어로 리디렉션되고, 현재 설정된 파라미터는 동적으로 발생합니다.

이 플레이 스토어 에러 메시지는 무엇입니까?

어트리뷰션 링크를 사용한 후 플레이 스토어에서 다음의 오류 메시지가 표시된다면:

TL_error_message.png

이는 어트리뷰션 링크에 # 문자가 포함되어 있기 때문입니다. 예시:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

보통 링크 내의 이런 문자는, 값을 동적으로 변경하는 매크로이기 때문에 포함됩니다. 그러므로 실제로는 큰 문제가 아니며 메시지를 무시할 수 있습니다.

구독자 파라미터의 장점은 무엇입니까?

구독자 파라미터 (즉, af_sub1부터 af_sub5까지)는 유용한 KPI를 기록하기 위해 사용할 수 있습니다. 이러한 파라미터는 파싱(parse)되어 로데이터 리포트에 표시되므로, 데이터 통합 또는 필터링을 수행할 때 유용합니다.

 

차량 공유 앱인 Luber는 파랑, 노랑, 빨강의 3가지 색의 템플릿의 광고소재가 있습니다. Luber의 모바일 마케팅 담당자인 Linda는 많은 앱 설치로 이어지는 색상 템플릿을 테스트 하려고 합니다. 이를 위해 그녀는 모든 비 SRN 미디어 소스의 파랑색 광고 어트리뷰션 링크에 &af_sub3=blue를 추가합니다. 노란색과 빨간색 광고에 대해서도 동일하게 추가합니다. 파싱되어 로데이터 리포트에 표시된 이 정보를 통해, Linda는 서로 다른 색깔의 광고소재 성과를 분석하고 가장 많이 전환시킨 색깔을 선택할 수 있습니다.

캠페인 이름의 최대 길이는 무엇입니까?

앱스플라이어는 어트리뷰션 링크 URL에서 최대 100자로 캠페인 이름 길이를 제한합니다. 이름 제한을 초과하면, 캠페인 이름은 다음 문자열로 변경됩니다: c_name_exceeded_max_length

 

영상 자료: Playtika의 Noam Gohary가 강연한 링크 구조와 데이터를 최적화하는 세 가지 베스트 방법.

도움이 되었습니까?