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

문자열 150

String 100

af_prt

파트너

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

String 50

af_mp

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

clickid

N/A

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

af_siteid

Site ID

• 광고를 표시하는 퍼블리셔를 식별하는 고유 ID. 더 알아보기

String 24

af_sub_siteid

하위 사이트 ID

• 광고 하위 네트워크/퍼블리셔 ID. 
• 기본 퍼블리셔(site ID)에 추가하여, 하위 퍼블리셔가 있거나, 배너, 전면광, 비디오 등과 같은 앱 내의 광고 유형/배치와 같은 추가 정보를 포함하고자 한다면 af_sub_siteid를 사용합니다. 예시: af_sub_siteid =ABCD_4567

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: 현재의 유저 경험 중 쉬는 시간에 표시되는 전면 광고
• 비디오: 일반 비디오, 즉 비보상형
• rewarded_video: 비디오를 시청함으로써 인앱 보상을 제공하는 광고 유닛
• playable: 상호적인 앱 경험 미리보기를 포함하는 광고 유닛
• sponsored_content: 광고 기사와 같이, 스폰서된 컨텐츠를 포함하는 링크
• audio: 오디오 광고

String 24

af_click_lookback

어트리뷰션 룩백 기간

• 클릭 어트리뷰션을 위한 룩백 윈도우. 이 윈도우의 기간은 새로운 유저가 광고/링크가 게재된 미디어 소스에 어트리뷰션 될 수 있는 최대 CTIT(Click To Install Time, 클릭에서 앱 설치까지 소요시간)입니다.
• 룩백 클릭 어트리뷰션 기간으로 설정 가능한 일수입니다. 이용 가능한 파라미터 값: 1d~30d(일) 또는 1h~23h(시간). 기본값은 7d입니다.
• 원링크 및 SRN에 대해 기여 기간을 사용자 정의할 수 있습니다.

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

3 char max

af_viewthrough_
lookback

N/A

• 룩백 뷰-쓰루 어트리뷰션 기간에 대해 구성 가능한 시간입니다. 사용 가능한 파라미터 값: 1h - 24h(시간). 기본값은 24시간입니다.
• SRN에 대해 기여 기간을 사용자 정의할 수 있습니다.

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

3 char max

af_channel

채널

광고가 배포되는 미디어소스 채널. 예시: UAC_Search, UAC_Display, Instagram, Meta 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]

광고주가 정의한 선택적 커스텀 파라미터입니다. 이러한 파라미터의 사용에 대한 자세한 내용은 Traits and limitations 섹션을 확인하십시오.

String 100

단일 플랫폼 링크에서 사용자를 두 플랫폼(안드로이드 및 iOS)에 대해 지정된 URL로 리디렉션하는 데 사용됩니다.

• 다음 링크 수준 단일 플랫폼 매개변수에 의해 재정의됨 ) :
  • af_android_url
  • af_ios_url
  • af_web_dp

• 다음 템플릿 수준 매개 변수를 재정의합니다.
  • android_custom_url
  • ios_custom_url

데스크톱(예를 들어, Windows 또는 Mac) 사용자를 원링크 템플릿에서 설정된 것과 다른 웹 페이지로 리디렉션합니다. 이 파라미터를 사용하여 데스크톱 사용자 어트리뷰션 데이터를 다른 플랫폼 환경에서 유지합니다(예: Google Analytics 또는 Omniture).

일러두기: 활동적인 리디렉션 허용 목록이 있는 경우 이 URL의 도메인이 목록에 있는지 확인하십시오.

• 설정 값이 false일 때, 어트리뷰션 링크상의 파라미터는 리디렉션된 페이지로 전달되지 않습니다.
• 리디렉션된 페이지에서 URL이 깔끔하게 보여지길 필요한 경우에 사용하거나, 리디렉션된 페이지를 처리하는 쿼리 파라미터 때문에 어트리뷰션 링크 파라미터가 문제를 발생시킬 가능성이 있는 경우에 사용합니다.

• 설정 값이 false일 때, 어트리뷰션 링크에 있는 앱스플라이어 PID 및 C 파라미터는 리디렉션된 페이지로 전달되지 않습니다.
• 데스크톱에서 URL을 클릭할 예정이고 필수 CRM 파라미터는 유지하되 앱스플라이어 PID 및 C 파라미터는 제거하려는 경우 이 옵션을 사용합니다. 이렇게 하면 URL에 여러 PID가 있는 것을 방지할 수 있습니다.

서버 간에 클릭 및;과 노출 횟수를 전송하는 애드 네트워크와 관련이 있습니다.

다음으로 전송된 유저 에이전트 문자열:

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

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

일러두기: Android에서는 유저 에이전트가 가끔 클라이언트 힌트로 축소됩니다. 하지만 그와 관계없이 보내야 합니다.

• 전체 유저 에이전트의 예: Mozilla/5.0(Linux, Android 12, Pixel 5) AppleWebKit/537.36(Gecko와 같 KHTML) Chrome/95.0.4638.16 Mobile Safari/537.36
• 감소된 유저 에이전트의 예: Mozilla/5.0(Linux, Android 10, K) AppleWebKit/537.36(Gecko와 같은 KHTML) Chrome/95.0.0.0 Mobile Safari/537.36

서버 간에 클릭 및;과 노출 횟수를 전송하는 애드 네트워크와 관련이 있습니다.

기기 IP 주소

권장: 사용 가능한 경우 af_ip 파라미터 아래에 디바이스 IP를 제공합니다.

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

[iOS 전용] 기기 운영 체제 버전.

이 파라미터는 더 이상 사용되지 않지만 앱스플라이어에서는 계속 지원합니다. 권장: 대신 af_os_version 파라미터를 매개 변수를 사용합니다. 

• 서버 간에 클릭 및;과 노출 횟수를 전송하는 애드 네트워크와 관련이 있습니다.
• 기기 운영 체제 버전.
  • Android:
    • 예: 12
    • (데스크톱 또는 Android에서 실행되고 Chrome 110 이상의 엔진을 사용하는 브라우저로 인해) 유저 에이전트를 줄이려면 애드 네트워크에서 Client Hints API를 사용하여 이 값을 가져와야 합니다.
    • 축소되지 않는 유저 에이전트의 경우 다음 정규식을 사용하여 유저 에이전트 문자열(\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/))에서 Android OS 버전을 추출합니다.
  • iOS:
    • 예: 16.2

• 서버 간에 클릭 및;과 노출 횟수를 전송하는 애드 네트워크와 관련이 있습니다.
• 기기 모델.
  •  Android:
    • 예: Pixel 픽셀 5
    • (데스크톱 또는 Android에서 실행되고 Chrome 110 이상의 엔진을 사용하는 브라우저로 인해) 유저 에이전트를 줄이려면 애드 네트워크에서 Client Hints API를 사용하여 이 값을 가져와야 합니다.
    • 축소되지 않는 유저 에이전트의 경우 다음 정규식을 사용하여 유저 에이전트 문자열(\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/))에서 Android 모델을 추출합니다.
  • iOS:
    • iphone 또는 ipad 중 하나(모두 소문자)

다음과 같이 링크를 전달하는 광고 배치:

• 앱: 앱을 통해 링크를 사용할 수 있습니다.
• 웹: 모바일 웹 사이트에서 링크를 사용할 수 있습니다.

추가 딥링크 값. 개발자는 코드에서 원하는 값의 동작을 구현합니다.

사용자가 연결될 특정 인앱 콘텐츠의 이름입니다. 개발사는 코드에서 deep_link_value의 원하는 동작을 구현합니다. 

링크가 소셜 미디어에 게시되면 열린 그래프(OG) 제목에 제목의 미리보기를 생성됩니다.

링크가 소셜 미디어에 게시되면 열린 그래프(OG) 설명이 설명의 미리보기를 생성합니다.

링크가 소셜 미디어에 게시되면 오픈 그래프(OG) 이미지가 이미지 미리보기를 생성합니다.

is_retargeting

Enum 5 char

af_reengagement_window

리인게이지먼트 윈도우

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

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

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

기본 값: 30 일

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

N/A