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

한눈에 보기:  앱스플라이어 어트리뷰션 링크 구조와 파라미터에 대해 알아보세요.

개요

어트리뷰션 링크를 통해 광고주는 광고에 대한 유저 인게이지먼트에 관한 데이터를 수집할 수 있습니다. 어트리뷰션 링크는 광고 뒤에 배치되어 사용자가 광고에 참여할 때 앱스플라이어에 알립니다. 인게이지먼트는 광고를 클릭하거나 광고 노출을 볼 때 발생할 수 있습니다. 어트리뷰션 URL 사본이 앱스플라이어로 전송됩니다.

어트리뷰션 링크는 원링크 또는 단일 플랫폼 링크를 사용하여 발생합니다.

  원링크 (멀티 플랫폼 링크) 단일 플랫폼 링크
설명 및 사용 시기

다음과 같은 경우에 사용:

  • 모든 플랫폼을 아우르는 단일 링크가 필요합니다.
  • 딥링킹 기능이 필요할 때
  • 안드로이드 앱 링크나 iOS 유니버설 링크를 사용하여 앱을 열려고 할 때

원링크에 대해 더 알아보기

다음과 같은 경우에 사용:

  • 단일 플랫폼만 사용할 때. 예를 들어, 안드로이드만 사용하고 iOS는 사용하지 않을 때.
  • 앱을 열기 위해 URI 스킴만 사용할 때.

통합 파트너 설정 방법에 대해 알아보기

선행 조건 원링크 템플릿 없음
필수 정보
기본 URL {하위 도메인}.onelink.me app.appsflyer.com
고유 식별자 템플릿 ID app_id
URL 구조 https://{subdomain}.onelink.me/
{templateid}?pid={media_source}
&af_siteid={ApplicationID}
&c={CampaignName}
https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName}
예시 https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int
&c=GreatCampaign&af_siteid=A1b1
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int&
c=GreatCampaign&af_siteid=A1b1

어트리뷰션 링크 파라미터

  • 나열된 파라미터는 어트리뷰션 링크에서 사용할 수 있습니다.
  • 필드 유형 열은 매개변수 값의 문자 제한입니다. 매개변수 값의 길이 제한에 대한 자세한 내용은 여기에서 확인하세요.

어트리뷰션 링크 파라미터—UA 및 리타겟팅

다음 표는 파일로 다운로드할 수 있습니다.

파라미터 로데이터에서의 표시 이름 설명 필드 유형 및 길이
pid 미디어 소스 앱스플라이어 통합 파트너를 고유하게 식별합니다. 수정하지 마세요. 자세한 내용. 문자열 150
c 캠페인 광고주 또는 퍼블리셔가 제공합니다. 캠페인 이름에 대한 제한을 참조하세요. 문자열 100
af_prt 파트너
  • 에이전시 계정 이름을 통해 인스톨을 에이전시에 귀속시킬 수 있습니다.
  • 주의: 에이전시 권한이 활성화되었는지 확인하기 전에는 이 매개변수를 사용하지 마세요.
문자열 50
af_mp 해당 없음
  • 인스톨 시 퍼블리셔 마케팅 파트너에게 포스트백을 보낼 수 있도록 설정합니다.
  • 참고: 현재 이 매개변수는 핀터레스트 마케팅 파트너에게만 적용됩니다.
 
클릭아이디 해당 없음 애드 네트워크 고유 클릭 식별자  
af_siteid 사이트 ID
  • 광고를 게재하는 퍼블리셔를 식별하는 고유 ID입니다. 더 보기
문자열 24
af_sub_siteid 하위 사이트 ID
  • 광고 서브 네트워크\/퍼블리셔 ID입니다. 
  • 주요 퍼블리셔(사이트 ID) 외에 하위 퍼블리셔가 있거나 앱 내 광고 유형\/배치(배너, 전면 광고, 비디오 등)와 같은 추가 정보를 포함하려면 af_sub_siteid를 사용하세요. 예: af_sub_siteid =ABCD_4567
문자열 50
af_c_id 캠페인 ID 광고주\/퍼블리셔가 제공합니다. 문자열 24
af_adset 광고세트
  • 광고주\/퍼블리셔가 제공합니다.
  • 광고세트는 캠페인과 광고 사이의 중간 데이터 계층 구조 수준입니다. 더 보기
문자열 100
af_adset_id 광고세트 ID 광고주\/퍼블리셔가 제공합니다. 문자열 24
af_ad 광고 광고주\/퍼블리셔가 제공한 광고 이름(더 보기) 문자열 100
af_ad_id 광고 ID 광고주\/퍼블리셔가 제공합니다. 문자열 24
af_ad_type 광고 유형  다음 명명 규칙을 사용하세요.
  • 네이티브: 미디어 소스의 콘텐츠와 일치하도록 설계된 유료 매체입니다. 이 매체는 귀사의 추천 비디오 피드에 자연스럽게 나타나는 콘텐츠의 시각적 디자인과 기능에 맞게 설계되었습니다.
  • 배너: 웹 페이지나 앱 인터페이스의 다양한 위치에 나타나는 작은 직사각형 형태의 디스플레이 광고입니다. 
  • 전면 광고: 호스트 앱의 전체 인터페이스를 덮는 전체 화면 광고입니다. 이 광고는 콘텐츠 사이에 배치되도록 설계되어 앱의 흐름에서 활동 사이 또는 게임 수준 사이, 또는 일시 정지 중에 전환 지점에서 일반적으로 표시됩니다.
  • 보상형 비디오: 인앱 보상을 대가로 게임에서 여분의 생명을 얻기 위해 비디오를 시청하거나, 문서에 액세스하거나, 공항에서 Wi-Fi에 접속하는 등의 광고를 사용자가 완전히 시청할 수 있습니다. 이러한 '보상형' 광고는 사용자를 (유저를 앱에) 참여시키며, 앱 전반의 경험을 향상시킵니다.
  • 오디오: 온라인 팟캐스트나 음악 스트리밍 플랫폼에서 제공되는 오디오 형식의 광고입니다.
  • 오퍼월: 개발자가 앱을 수익화하기 위해 사용하는 인앱 광고 단위입니다. 앱 내에서 작은 상점처럼 작동하며, 사용자가 인앱 보상을 위해 여러 '제안'을 완료할 수 있습니다.
문자열 24
af_ad_format 광고 형식  다음 명명 규칙을 사용하세요.
  • 텍스트: 일반적으로 짧은 텍스트 조각으로 나타나는 텍스트 기반 광고입니다. 사용자의 관심을 끌고 웹사이트나 랜딩 페이지로 클릭-쓰루를 유도하기 위해 제목, 설명, 링크 또는 행동 촉구가 포함될 수 있습니다.
  • 이미지: 그래픽이나 사진을 사용하여 제품, 서비스 또는 브랜드를 보여주는 시각적 광고입니다. 일반적으로 매력적인 이미지와 간결한 텍스트가 포함될 수 있으며, 행동 촉구도 포함될 수 있습니다.
  • 비디오: 마케팅 메시지를 전달하기 위해 시청각 콘텐츠를 사용하는 디지털 광고입니다. 길이는 다양할 수 있으며 온라인 비디오 콘텐츠 내에서 프리롤, 미드롤, 포스트롤로 나타날 수 있습니다. 또한 다양한 플랫폼에서 독립형 비디오로 나타날 수도 있습니다.
  • 플레이어블: 사용자에게 게임이나 앱의 축소판을 체험해 볼 수 있는 대화형 광고로, 다운로드나 구매 전에 (유저를 앱에) 참여시킬 수 있습니다. 사용자는 실제 게임 플레이나 앱 기능을 직접 체험할 수 있습니다.
  • 대화형: 사용자 상호작용이나 참여를 장려하는 매력적이고 역동적인 광고입니다. 사용자의 관심을 끌고 활발한 참여를 유도하기 위해 퀴즈, 설문조사 또는 기타 대화형 요소를 포함할 수 있습니다.
  • 동적_제품: 사용자 행동, 선호도 또는 검색 기록에 따라 제품 정보를 동적으로 채우는 개인화된 광고 형식입니다. 이 형식을 통해 광고주는 각 개인에게 적합하고 맞춤형의 제품 광고를 보여줄 수 있습니다.
  • 회전목마: 하나의 광고에 여러 슬라이드 또는 카드로 구성된 광고 형식입니다. 각 카드에는 서로 다른 이미지, 제목, 설명을 포함할 수 있어 광고주는 하나의 광고에서 여러 제품이나 기능을 선보일 수 있습니다.
 
af_클릭_룩백 어트리뷰션 룩백 윈도우
  • 클릭 어트리뷰션을 위한 룩백 윈도우. 이 윈도우의 지속 시간은 광고/링크를 보여주는 소스가 새 사용자로 측정될 수 있는 최대 CTIT (클릭에서 인스톨까지의 시간)입니다.
  • 룩백 클릭 어트리뷰션 기간에 대한 설정 가능한 일수입니다. 사용 가능한 파라미터 값: 1일~30일(일) 또는 1시간~23시간(시간). 기본값은 7일입니다.
  • 룩백 윈도우는 OneLinks 및 SRN에 맞게 사용자 정의할 수 있습니다.
참고: 클릭 URL에만 영향을 주며 노출 URL에는 영향을 주지 않습니다.
최대 3자
af_viewthrough_
룩백
해당 없음
  • 룩백 뷰-쓰루 어트리뷰션 기간에 대한 설정 가능한 시간입니다. 사용 가능한 파라미터 값: 1시간~24시간(시간). 기본값은 24시간입니다.
  • 룩백 윈도우는 SRN에 맞게 사용자 정의할 수 있습니다.
참고: 노출 URL에만 영향을 주고 클릭 URL에는 영향이 없습니다.
최대 3자
af_채널 채널 광고가 배포되는 미디어 소스 채널 (예: UAC_Search, UAC_Display, 인스타그램, Meta Audience Network 등) 동적 Enum. 문자열 20자
af_키워드 키워드 텍스트 타겟 캠페인을 위한 키워드 목록 문자열 100
af_비용_모델 비용 모델 문자열 20자
af_cost_currency 비용 통화
  • 3자리 통화 코드는 ISO-4217을 준수합니다. 예: USD, ZAR, EUR
  • [기본값]: USD
열거형 3자 
af_cost_value 비용 값
  • 비용 통화를 사용한 비용 값입니다.
  • 소수점 이하 4자리까지 가능합니다.
  • 숫자만 입력하세요(소수점이 필요하면 사용하세요). 예: "56", "2.85"
문자열 20자

af_sub[n] 

(n=1-5) 예: af_sub1

하위 파라미터 [n] 광고주가 정의한 선택적 커스텀 파라미터입니다. 이 파라미터 사용에 대한 자세한 내용은 특성 및 제한 사항 섹션을 확인하세요. 문자열 100
af_r 해당 없음

모든 플랫폼(안드로이드, iOS 및 데스크톱)에서 지정된 URL로 사용자를 리디렉션하는 데 사용됩니다.

멀티 플랫폼 링크(원링크)에서 이 파라미터는:

  • 템플릿 수준의 리디렉션 설정을 무시합니다.
  • 다음 링크 수준 파라미터로 무시됩니다.

참고사항:

  • 활성화된 리디렉션 허용목록이 있을 경우, 이 URL의 도메인이 목록에 포함되어 있는지 확인하세요.
  • 값은 RFC 1738 표준에 따라 유효한 전체 웹 URL (https:\/\/[도메인][선택사항 경로])이어야 하며, 이 매개변수에는 URI 체계가 허용되지 않습니다.
 
af_web_dp 해당 없음

데스크톱(예: Windows 또는 Mac) 사용자를 원링크 템플릿에 설정된 것과 다른 웹 페이지로 리디렉션하는 URL입니다. 이 기능을 사용하여 다른 플랫폼(예: Google Analytics 또는 Omniture)에서 데스크톱 사용자의 어트리뷰션 데이터를 유지할 수 있습니다.

주의사항:

  • 활성화된 리디렉션 허용목록이 있을 경우, 이 URL의 도메인이 목록에 포함되어 있는지 확인하세요.
  • 값은 RFC 1738 표준에 따라 유효한 전체 웹 URL (https:\/\/[도메인][선택사항 경로])이어야 하며, 이 매개변수에는 URI 체계가 허용되지 않습니다.
 
af_dp 해당 없음

앱을 시작하는 URI 스킴 대체 값으로, Universal Link 또는 안드로이드 앱 링크 메서드가 실패할 경우 및 안드로이드 6.0 미만의 사용자를 위해 사용됩니다. 기본 경로, 즉 기본 액티비티만을 가리켜야 합니다.

참고사항: 이 파라미터에 웹 URL 값을 사용하는 경우(권장하지 않음), URL이 RFC 1738 표준에 따라 유효한지 확인하고 이 URL의 도메인이 리디렉션 허용 목록에 있는지 확인하세요.

 
af_force_deeplink 해당 없음 af_dp 값에 지정된 액티비티에 강제 딥링크를 적용합니다.  
af_ref 해당 없음
S2S 클릭을 사용하는 광고 네트워크는 다음 매개변수를 사용하여 고유한 참조자 값을 발송할 수 있습니다. &af_ref=ReferrerValue
af_ref 값은 필수적으로 다음과 같이 구성된 고유한 값으로 구성되어야 합니다:
네트워크 이름_각 클릭에 대한 고유 클릭 값
예: af_ref=networkname_123456789ABCDEF
 
네트워크 이름은 어떤 유효한 문자열도 가능합니다. networkname_int이거나 네트워크 이름일 수 있습니다.
 
앱스플라이어는 안드로이드 디바이스의 어트리뷰션에 이 파라미터를 사용할 수 있습니다. 앱스플라이어는 iOS 또는 Windows 디바이스의 어트리뷰션에 이 파라미터를 사용하지 않습니다.
 
is_incentivized 해당 없음
부울: true/false
보상형 또는 비보상형 캠페인
 
af_param_forwarding 해당 없음
  • false로 설정하면, 어트리뷰션 링크에 있는 파라미터가 리디렉션된 페이지로 전달되지 않습니다.
  • 리디렉션된 페이지에서 URL을 더 깔끔하게 보이게 하거나 어트리뷰션 링크 파라미터가 쿼리 파라미터 처리 문제로 인해 문제가 생길 수 있는 경우 이 옵션을 사용하세요.
 
af_base_params_forward 해당 없음
  • false로 설정하면, 어트리뷰션 링크에 있는 앱스플라이어 PID 및 C 파라미터가 리디렉션된 페이지로 전달되지 않습니다.
  • URL이 데스크톱에서 클릭될 경우, 필수적인 CRM 파라미터는 유지하면서 앱스플라이어 PID와 C 파라미터는 제거하고 싶을 때 이 옵션을 사용하세요. 이렇게 하면 URL에 중복된 PID가 생기는 것을 방지할 수 있습니다.
 
af_partner_account_id 네트워크 계정 ID 파트너와 광고주의 계정 ID 문자열 100
리디렉트 해당 없음 &redirect=false인 경우, 이 파라미터는 앱스플라이어가 S2S 클릭임을 알고, 파트너가 클릭한 유저를 리디렉션 해야 한다는 것을 알려줍니다.  
af_ua 유저 에이전트

클릭과 노출을 서버 간으로 발송하는 애드 네트워크에 적합합니다.

유저 에이전트 문자열은 다음과 같이 전송됩니다.

  1. URL 파라미터(URL로 인코딩됨)
  2. HTTP 요청 헤더(인코딩되지 않음)

유저 에이전트는 URL 파라미터와 HTTP 헤더에서 동일해야 합니다.

참고: 안드로이드에서는 유저 에이전트가 클라이언트 힌트로 인해 축소될 수 있습니다. 그럼에도 불구하고 항상 보내야 합니다.

  • 전체 유저 에이전트의 예: Mozilla/5.0 (Linux; Android 12; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.16 Mobile Safari/537.36
  • 축소된 유저 에이전트의 예: Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.0.0 Mobile Safari/537.36
 
af_ip IP

클릭과 노출을 서버 간으로 발송하는 애드 네트워크에 적합합니다.

디바이스 IP 주소

권장 사항: 가능한 경우 디바이스 IP를 af_ip 파라미터에 입력하세요.

다음 옵션: 가능하다면 앱스플라이어는 X-Forwarded-For의 IP를 사용합니다.

 
[사용 중단됨] af_os OS 버전

[iOS 전용] 디바이스의 운영 체제 버전입니다.

이 매개변수는 사용이 중단되었지만 앱스플라이어에서 여전히 지원됩니다. 권장 사항: af_os_version 매개변수를 대신 사용하세요. 

 
af_os_version OS 버전
  • 클릭과 노출을 서버 간으로 발송하는 애드 네트워크에 적합합니다.
  • 디바이스의 운영 체제 버전입니다.
    • 안드로이드:
      • 예시: 12
      • 사용자 에이전트가 축소된 경우(데스크톱 또는 안드로이드에서 운영되는 브라우저와 Chrome 110+ 엔진 사용으로 인해), 애드 네트워크는 클라이언트 힌트 API를 사용하여 이 값을 얻어야 합니다.
      • 축소되지 않은 사용자 에이전트의 경우 다음 정규식을 사용하여 사용자 에이전트 문자열에서 안드로이드 OS 버전을 추출합니다. .
    • iOS:
      • 예시: 16.2
 
af_model 디바이스 모델
  • 클릭과 노출을 서버 간으로 발송하는 애드 네트워크에 적합합니다.
  • 디바이스 모델
    •  안드로이드:
      • 예시: 픽셀 5
      • 사용자 에이전트가 축소된 경우(데스크톱 또는 안드로이드에서 운영되는 브라우저와 Chrome 110+ 엔진 사용으로 인해), 애드 네트워크는 클라이언트 힌트 API를 사용하여 이 값을 얻어야 합니다.
      • 축소되지 않은 사용자 에이전트의 경우 다음 정규식을 사용하여 사용자 에이전트 문자열에서 안드로이드 모델을 추출합니다. .
    • iOS:
      • iphone 또는 ipad (모두 소문자)
 
af_media_type 매체 유형 링크가 포함된 광고 배치는 다음과 같습니다:
  • 앱: 링크는 앱을 통해 사용할 수 있습니다.
  • 웹: 링크는 모바일 웹사이트에서 제공됩니다.
 
deep_link_sub1-10 해당 없음 추가적인 딥 링크 값입니다. 개발자는 코드에서 이 값들의 원하는 동작을 구현합니다.  
딥 링크 값 해당 없음 사용자가 이동할 특정 인앱 콘텐츠의 이름입니다. 개발자는 코드에서 deep_link_value의 원하는 동작을 구현합니다.   
af_og_title 해당 없음 링크가 소셜미디어에 게시되면, 오픈그래프(OG) 제목이 미리 보기 제목을 생성합니다. 문자열 40
af_og_description 해당 없음 링크가 소셜미디어에 게시되면, 오픈그래프(OG) 설명이 설명의 미리 보기를 생성합니다. 문자열 300
af_og_image 해당 없음 링크가 소셜미디어에 게시되면, 오픈그래프(OG) 이미지가 이미지 미리 보기를 생성합니다.  

어트리뷰션 링크 파라미터 - 리타겟팅 전용

파라미터 로데이터에서의 표시 이름 설명 필드 유형과 너비
is_retargeting 리타겟팅 (캠페인)  모든 리타겟팅 캠페인의 클릭 URL에는 &is_retargeting=true이 포함되어야 합니다.
매개변수가 포함되지 않았거나 값이 "false"인 경우, 캠페인은 일반 유저 유입 캠페인으로 간주됩니다.
열거형 5 문자
af_재참여_창 리인게이지먼트 기간

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

가능한 기간 범위 옵션은 다음과 같습니다.

  • 일: 1-90 또는 시간 1-36
  • 수명: 즉, 리인게이지먼트 기간은 무제한입니다. 예: &af_reengagement_window=lifetime

기본값: 30일

예:  &af_reengagement_window=30d은 리인게이지먼트 기간을 30일로 설정합니다.

해당 없음

조회 가능성 파라미터

광고 유형에 따라 인게이지먼트 사양을 자세히 설명하는 관련 조회 가능성 파라미터를 발송할 수도 있습니다.

파라미터 값 형식 설명
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 광고 ID 구글 광고 ID - 애드 네트워크 지원 필요합니다. 최대 40자
sha1_advertising_id 해당 없음 SHA1로 해시된 구글 광고 ID - 애드 네트워크 지원 필요합니다.  
md5_advertising_id 해당 없음 MD5로 해시된 구글 광고 ID - 애드 네트워크 지원 필요합니다. 인스톨 및 재귀속으로만 지원됨
android_id 안드로이드 ID 디바이스 Android_id - 애드 네트워크 지원 필요합니다. 최대 20자
sha1_android_id 해당 없음 SHA1로 해시된 디바이스 Android_id - 애드 네트워크 지원 필요합니다.  
md5_android_id 해당 없음 MD5로 해시된 디바이스 Android_id - 애드 네트워크 지원 필요합니다. 인스톨 및 재귀속으로만 지원됨
imei IMEI 디바이스 IMEI ID  
sha1_imei 해당 없음 SHA1로 해시된 디바이스 IMEI ID - 애드 네트워크 지원 필요합니다.  
md5_imei 해당 없음 MD5로 해시된 디바이스 IMEI ID - 애드 네트워크 지원 필요합니다.  
oaid OAID 오픈 익명의 디바이스 식별자 안드로이드 SDK 버전 4.10.3부터 사용 가능
sha1_oaid 해당 없음 SHA1로 해시된 오픈 익명의 디바이스 식별자 - 애드 네트워크 지원 필요합니다. 안드로이드 SDK 버전 4.10.3부터 사용 가능
md5_oaid 해당 없음 MD5로 해시된 익명의 디바이스 식별자 - 애드 네트워크 지원이 필요합니다. 안드로이드 SDK 버전 4.10.3부터 사용 가능
af_android_url 해당 없음

안드로이드 사용자를 구글 플레이의 앱 페이지가 아닌 다른 URL로 리디렉션합니다. 써드 파티 앱 스토어에 사용하세요.

주의사항:

  • 활성화된 리디렉션 허용목록이 있을 경우, 이 URL의 도메인이 목록에 포함되어 있는지 확인하세요.
  • 값은 RFC 1738 표준에 따라 유효한 전체 웹 URL (https:\/\/[도메인][선택사항 경로])이어야 하며, 이 매개변수에는 URI 체계가 허용되지 않습니다.
 
sha1_el 해당 없음 데스크탑에서 모바일 어트리뷰션을 위해 사용됨 - 이메일을 SHA1로 해시함. 애드 네트워크 지원이 필요합니다.  
fire_advertising_id 해당 없음 Amazon Fire 광고 ID  
af_android_store_csl store_product_page Google 콘솔에서의 커스텀 스토어 리스트 문자열

iOS 전용 파라미터

파라미터 표시 이름 설명
idfa IDFA

대문자를 사용하세요. 애드 네트워크 지원이 필요합니다.

필드 유형: 최대 40자

idfv IDFV 대문자를 사용하세요. 
af_ios_url  

이 설정을 통해 iOS (iPhone 또는 iPad) 사용자를 iTunes의 앱 페이지가 아닌 다른 URL로 리디렉션하는 랜딩 페이지 리디렉션에 사용할 수 있습니다.

주의사항:

  • 활성화된 리디렉션 허용목록이 있을 경우, 이 URL의 도메인이 목록에 포함되어 있는지 확인하세요.
  • 값은 RFC 1738 표준에 따라 유효한 전체 웹 URL (https:\/\/[도메인][선택사항 경로])이어야 하며, 이 매개변수에는 URI 체계가 허용되지 않습니다.
af_ios_store_cpp store_product_page

커스텀 제품 페이지 ID (ppid)

참고사항: 로데이터와 데이터 집약형 리포팅에서는 af_ios_store_cpp (커스텀 제품 페이지 ID) 파라미터 값이 클릭에 대해서만 기록되고 노출에 대해서는 기록되지 않습니다.

af_ios_fallback [사용 중단] 해당 없음 사용 중단: 사용자는 iOS URI 체계 흐름을 기반으로 리디렉션됩니다. 
sha1_idfa 해당 없음 IDFA를 SHA1로 해시함. 애드 네트워크 지원이 필요합니다.
sha1_idfv 해당 없음 SHA1로 해시된 IDFV
mac 해당 없음 디바이스의 MAC 주소. 애드 네트워크 지원이 필요합니다.
md5_idfv 해당 없음 MD5로 해시된 IDFV
sha1_mac 해당 없음 SHA1로 해시된 디바이스의 MAC 주소. 애드 네트워크 지원이 필요합니다.

예시

https://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 형식으로 어트리뷰션 링크에 커스텀 파라미터를 추가할 수 있습니다. 예를 들어:

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

커스텀 파라미터에 대해 알아야 할 두 가지 중요한 사항:

  • 커스텀 파라미터는 로데이터에 나타나지 않습니다.
  • 커스텀 파라미터는 전환 데이터 SDK API에서 검색할 수 있습니다.

파트너 ID (PID) 파라미터

사용 가능한 모든 어트리뷰션 링크 파라미터 중에서 PID는 필수입니다. PID는 앱스플라이어가 할당한 미디어 소스의 고유 식별자입니다. 

통합 파트너에는 고유한 PID 값이 있습니다. PID는 _int 접미사로 끝납니다. 원링크 링크를 사용하는 경우 통합 파트너가 예약하지 않은 한 PID를 원하는 값으로 설정할 수 있습니다. 충돌을 피하려면 _int 접미사를 사용하지 마세요. 

중요한 통합 퍼블리셔 ID의 예: 오가닉, googleadwords_int(Google AdWords), Meta Ads, X Ads. 이메일, SMS 문자메시지, 우편 비둘기 등 통합되지 않은 소스에는 원하는 이름을 사용할 수 있습니다.

일반적인 PID 문제를 방지하세요:

  • 귀사의 어트리뷰션 링크에 항상 PID를 포함하세요. 어트리뷰션 링크에 PID가 없으면 사용자는 자동으로 "없음" 미디어 소스로 귀속되고 원래 인스톨 소스가 사라집니다.
  • 커스텀 소스의 경우 비통합 파트너 PID를 사용하세요. 각 통합 소스에 대해서는 인스톨의 올바른 어트리뷰션을 위해 지정된 PID만 사용하세요. 이메일, SMS 문자메시지 또는 페이스북의 무료 바이러스 게시물과 같은 커스텀 미디어 소스의 경우 다른 비통합 PID 값을 사용하세요.
  • 법적 문자만 사용하세요. 어트리뷰션 링크의 PID 파라미터에 다음 문자 중 하나가 포함되어 있는 경우 \/<>&*?\\
    • 클릭 또는 인스톨이 대시보드의 af_invalid_param에 나타납니다.
    • 어트리뷰션 링크는 귀속되지 않습니다.
    • 클릭 시 딥링킹 기능이 작동하지 않습니다.

PID 값에 공백을 사용하지 않거나, 사용하기 전에 귀사의 어트리뷰션 링크를 URL로 인코딩하세요.

사이트 ID 파라미터

사이트 ID는 광고를 게재하는 퍼블리셔의 고유 식별자입니다. 즉, 광고를 표시하는 웹사이트나 앱입니다. 광고 네트워크는 각 퍼블리셔에게 고유한 사이트 ID를 할당합니다. 

이 ID는 어트리뷰션 링크의 af_siteid 매개변수를 통해 앱스플라이어에 전달되며, 다양한 대시보드, 리포팅 옵션 및 포스트백에서 확인할 수 있습니다. 

사이트 ID는 다음과 같은 이유들로 인해 어트리뷰션 링크에서 앱스플라이어에 전달되어야 합니다.

  • 퍼블리셔에 대한 명확성과 투명성을 제공합니다.
  • 앱스플라이어는 이것을 이용해 사기성 퍼블리셔와 다른 트래픽 집단을 식별하고 제거합니다.

사이트 ID 매개변수에는 광고를 제공하는 퍼블리셔의 ID만 포함됩니다.

앱 내부에 광고 유형, 배치 또는 두 가지 모두, 예를 들어 배너, 중간 광고 또는 비디오 같은 추가 정보를 포함하려면 하위 사이트 ID 매개변수를 사용합니다.

예시

다음 어트리뷰션 링크에는 다음이 포함됩니다.

  • af_siteid (사이트 ID): 퍼블리셔 ID
  • af_sub_siteid (하위 사이트 ID): 추가 ID 정보 (이 경우 제휴 소스 및 광고 유형 배치)

https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567

예시 링크:

  • 1234 = 퍼블리셔 ID
  • ABCD = 퍼블리셔가 협력하는 제휴 소스 (하위 퍼블리셔)
  • 4567 = 앱 내에서의 광고 유형 배치, 예를 들어 배너, 중간 광고 또는 비디오

자주 묻는 질문: 트래픽으로 차단된 인스톨이 많은 이유는 무엇입니까?

차단된 인스톨은 다음과 같은 이유로 발생할 수 있습니다.

  • 누락된 사이트 ID: 클릭 URL에서 af_siteid 매개변수가 비어 있습니다. 빈 사이트 ID로 전송된 참여는 기술적 문제 또는 프로드 감지 시스템을 우회하려는 의도적인 시도를 의미합니다.
  • 여러 사이트 ID: 동일한 퍼블리셔가 서로 다른 사이트 ID를 사용하여 여러 클릭 URL을 통해 전송됩니다. 이는 실제 퍼블리셔 액티비티를 가리는 사기 행위로 간주되며, 종종 클릭 플러딩과 관련이 있습니다.
  • 잘못된 사이트 ID 형식: 잘못된 형식을 보내고 다른 프로드 징후가 나타나면 특정 퍼블리셔뿐만 아니라 더 높은 수준의 클러스터도 차단될 수 있으며, 파트너 액티비티에 큰 영향을 미칠 수 있습니다.

인스톨이 차단되는 상황을 피하려면, 예시에 나와 있듯 퍼블리셔당 하나의 사이트 ID 파라미터를 발송하세요.

데이터의 세분화 수준

최대 4개의 URL 파라미터를 사용하여 귀사의 광고 성과를 깊이 분석할 수 있습니다.

모든 활성 어트리뷰션 링크에 4개의 파라미터를 전부 사용하면 다음과 같은 이점이 있습니다.

  • 모든 유저 인스톨과 이벤트를 특정 광고와 어트리뷰션합니다.
  • 데이터 집약형 보고서에서 광고 세트별, 캠페인별, 미디어 소스별로 귀사의 모든 광고 성과를 분석하고 비교하여 모든 수준에서 최적화할 수 있습니다.
  • 로데이터 리포트와 피벗 표에서 모든 미디어 소스에 걸쳐 귀사의 모든 광고를 비교합니다.

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

  • Media source (pid=)
  • campaign name (c=)
  • Ad set (af_adset=)
  • Ad name (af_ad=)

예시

다음 어트리뷰션 링크는 통합된 "네트워크" 미디어 소스에서 운영되는 "겨울" 캠페인의 "코트" 광고 세트 내 "캐시미어" 광고를 기록하기 위해 4단계의 세분성을 사용합니다.

https://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로 상호작용하면, 리드는 앱스플라이어로 리디렉션되고 현재 설정된 파라미터가 동적으로 적용됩니다.

Play 스토어 오류 메시지가 무엇인가요?

어트리뷰션 링크를 따라간 후 Play 스토어에서 다음과 같은 오류 메시지가 나타나는 경우:

TL_오류_메시지.png

이는 어트리뷰션 링크에 # 문자가 포함되어 있기 때문입니다. 예를 들어:

https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

일반적으로 이러한 문자는 매크로이기 때문에 링크에 있으며, 동적으로 값으로 대체되므로 큰 문제가 아니며 메시지를 무시할 수 있습니다.

구독자 파라미터는 무엇이 좋은가요?

구독자 파라미터, 즉 af_sub1, af_sub2, ..., af_sub_5는 유용한 KPI를 기록하는 데 사용할 수 있습니다. 이러한 파라미터는 분석되어 로데이터 리포트에 표시되므로 데이터 집계나 필터링을 수행하는 데 매우 유용합니다.

예시

우박 차량 호출 앱인 Luber에는 파란색, 노란색, 빨간색의 3가지 색상 템플릿이 있는 크리에이티브가 있습니다. Luber의 모바일 마케터인 Linda는 어떤 색상 템플릿이 더 많은 인스톨을 가져오는지 시험하고 싶어합니다. 이를 위해 그녀는 모든 비(非) SRN 매체 소스의 모든 파란색 광고의 어트리뷰션 링크에 &af_sub3=blue을 추가합니다. 노란색과 빨간색 광고에도 동일한 작업이 수행됩니다. 이러한 정보를 분석하여 로데이터 리포트에 표시되면 Linda는 다양한 색상의 광고의 성공 여부를 분석하고 가장 전환율이 높은 광고를 선택할 수 있습니다.

캠페인 이름에 어떤 제한이 있나요?

  • 어트리뷰션 링크 URL에 있는 캠페인 이름의 최대 길이는 100자로 제한됩니다. 초과 시 캠페인 이름이 c_name_exceeded_max_length로 변경됩니다.
  • 캠페인 이름은 공백으로 시작하거나 끝나서는 안 됩니다. 이는 대시보드와 리포트에서 불일치를 일으킬 수 있습니다.

특성 및 제한 사항

특성 비고
특수문자 다음 특수 문자는 파라미터나 값에 허용되지 않습니다: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, \/, {, }, %
URL 문자 제한 총 URL 길이는 2000자를 초과할 수 없습니다.
안드로이드 소셜 앱 WebView 딥링킹 리디렉션 제한 세부사항은 여기에서 확인하세요.
안드로이드 네이버 블로그 앱에서는 딥링킹이 지원되지 않습니다. 안드로이드 네이버 블로그 앱에서는 딥링킹이 지원되지 않습니다. 사용자는 링크에 설정된 대로 구글 플레이 스토어나 웹으로 리디렉션됩니다.
iOS에서 Chrome 브라우저에서 URI 스킴 링크를 클릭하면 팝업이 표시됩니다. Chrome iOS의 변경으로 인해 iOS의 Chrome에서 사용자가 URI 스킴 링크를 클릭할 때마다 앱 열기 확인 또는 애플 앱 스토어로 리디렉션할지 묻는 팝업이 표시됩니다.
 
URI 스킴 유효성 요구 사항 RFC 3986을 준수하는 유효한 URI 스킴을 사용하는 것이 좋습니다. 위의 조건을 준수하지 않는 스킴은 앱을 열지 못할 수 있으며 웹뷰 또는 다른 웹 환경에서 클릭 시 오류가 발생할 수 있습니다.
텔레그램 WebView 어트리뷰션 제한 세부사항은 여기에서 확인하세요.