CTV, PC 및 콘솔 플랫폼 다이렉트 어트리뷰션 링크

요약:  CTV, PC, 콘솔 플랫폼에 대한 앱스플라이어 어트리뷰션 링크와 파라미터를 자세히 알아보십시오. 참고: 안드로이드 PC 게임을 포함한 안드로이드 및 iOS 앱에는 모바일 어트리뷰션 링크 지침을 사용하십시오.

요약

CTV, PC 및 콘솔 플랫폼 다이렉트 어트리뷰션 링크를 사용하면 광고주가 클릭 후 사용자를 리디렉션하고 데이터를 수집할 수 있습니다. 이러한 직접 어트리뷰션 링크는 한 번에 한 플랫폼에서 실행되는 하나의 목적 앱에 대한 리디렉션 및 어트리뷰션을 지원하는 앱스플라이어 링크입니다. 리디렉션 대상은 링크에 포함된 af_r 파라미터의 값입니다.

참고: 안드로이드 PC 게임을 포함한 안드로이드 및 iOS 앱에는 모바일 어트리뷰션 링크 지침을 사용하십시오.

어트리뷰션 링크는 사용자가 직접 만들어 광고 뒤에 배치할 수 있습니다. 이러한 링크를 만들려면 이 문서의 지침을 따르십시오.

또는 EngagementsAPI를 사용하여 S2S를 통해 링크를 만들 수 있습니다. 이는 약간의 개발 작업을 요구합니다. 참고: S2S를 통해 생성된 링크도 노출 데이터를 수집할 수 있습니다.

어트리뷰션 링크

어트리뷰션 링크 구조
기본 URL engagement.appsflyer.com/v1.0/c2s/click/app/
필수 경로 파라미터
  • 플랫폼
    예: steam
  • app_id
    예: 123456
필수 쿼리 파라미터
  • af_media_source
  • af_campaign_id
  • af_r
기타 파라미터 전체 보기
URL 구조 https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}
샘플 URL https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

파라미터

파라미터 로데이터 내보내기 및 Pull API의 표시 이름 설명 필드 유형
플랫폼 플랫폼
  • 애플리케이션 플랫폼을 지정하는 경로 파라미터.
  • 가능한 값:
    • smartcast
    • tizen
    • roku
    • webos
    • vidaa
    • Playstation
    • steam
    • quest
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 

문자열

app_id 앱 ID
  • 게시하는 앱의 앱 ID를 지정하는 경로 파라미터.
  • 예시: ap123456

문자열

af_media_source 미디어 소스 앱스플라이어 플랫폼에 정의된 고유 파트너 식별자입니다.
다음 특수 문자는 허용되지 않습니다: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, \/, {, }, %.
문자열
af_campaign 캠페인 캠페인 이름 문자열
af_campaign_id 캠페인 ID 캠페인 ID 문자열

af_request_id

해당 없음

파트너 요청을 고유하게 식별하는 ID입니다.

문자열

af_adset

광고 세트

광고 세트 이름

문자열

af_adset_id

광고 세트 ID

광고 세트 ID

문자열

af_ad

광고

광고 이름

문자열

af_ad_id

광고 ID

광고 ID

문자열

af_campaign_type

캠페인 유형

다음 중 하나:

  • user_acquisition
  • 리타겟팅

문자열

af_prt

파트너

  • 에이전시에 어트리뷰션할 수 있도록 하는 에이전시 계정 이름
  • 주의: 에이전시 권한이 활성화되어 있는지 확인하기 전에는 이 매개변수를 사용하지 마세요.

문자열

af_siteid

사이트 ID

광고를 표시하는 퍼블리셔의 고유 ID

문자열

af_sub_siteid

하위 사이트 ID

광고 서브 네트워크/퍼블리셔 ID

문자열

af_click_id

해당 없음

애드 네트워크 고유 트랜잭션 ID

문자열

af_lookback_window

해당 없음

  • ID 매칭으로 어트리뷰션하는 룩백 윈도우
  • 룩백 윈도우 기간을 성할 수 있는 일/시간의 선택입니다. 사용 가능한 파라미터 값: 1d-30d(일) 또는 1h-23h(시간).
  • 유효성 검증: 위의 스키마를 사용하여 최대 3자.
  • 기본값은 노출에 대해 24시간, 클릭에 대해 7일입니다.

문자열

해당 없음

애드 네트워크 고유 트랜잭션 ID

문자열

af_ad_type

광고 유형

  • 광고 유형. 다음 명명 규칙을 사용하세요:
    • text: 문자만 포함하는 광고 단위, 예: 검색 결과
    • 배너: 디바이스 화면 상단 또는 하단에 표시되는 기본 형식
    • interstitial: 현재 사용 중인 앱의 쉬는 시간에 표시되는 전면 광고
    • video: 표준 비디오, 비보상형
    • rewarded_video: 동영상을 시청하면 인앱 보상을 제공하는 광고 단위
    • playable: 앱 체험을 미리보기로 제공하는 광고 단위
    • audio: 오디오 광고
  • 대소문자 구분 엄격 적용

문자열

af_channel

채널

광고가 배포되는 미디어 소스 채널, 예: UAC_Search, UAC_Display, 인스타그램, Meta Audience Network 등

문자열

af_model

디바이스 모델

디바이스 모델명

String 64

af_os_version

해당 없음

  • 디바이스 OS 버전
  • 숫자와 점만 입력 가능
  • 예시: 8.1.0

문자열

af_device_id_type

해당 없음

디바이스 식별자 유형 다음 중 하나:

  • Vida
  • tifa
  • rida
  • lgudid
  • fire
  • advertising_id
  • fire
  • 커스텀

문자열

af_device_id_value

해당 없음

디바이스 식별자 값

문자열

af_r

해당 없음

  • 필수
  • 올바른 애플 앱 스토어나 랜딩 페이지로 연결되는 링크를 포함합니다.
  • af_r 매개변수 내의 모든 것은 인코딩해야 합니다. 여기에는 UTM 매개변수 값이 포함됩니다(추가된 경우).

문자열

특성 및 한계

확률적 모델링에서는 클릭과 노출에 대해 24시간의 고정 룩백 윈도우가 사용됩니다. af_lookback_window 값은 무시됩니다.