SKAdNetwork 모바일 연동

Overview

Branch를 사용하여 광고주 SKAdNetwork 연동을 관리하고 Branch에서 SKAdNetwork 데이터를 표시하려면 Branch 대시보드를 업데이트하고 다음 두 가지 방법 중 하나로 iOS 앱을 업데이트해야 합니다.

  • 옵션 1 - Branch SDK를 사용하여 SKAdNetwork에 대한 모든 호출 관리
  • 옵션 2 - SKAdNetwork와 직접 연동하여 Apple로의 전송 내역 제어 및 관리

📘

어떤 SDKAdNetwork 구현 옵션이 더 나을까요?

각 통합 접근 방식의 장점에 대해 자세히 알아 보려면 이 FAQ 항목을 읽어보십시오.

📘

서버 간 및 TUNE SDK 연동

서버 간 연동을 사용하거나 TUNE SDK를 사용하거나 Branch SDK를 직접 포함하지 않는 다른 연동 솔루션/키트를 사용하는 모든 모바일 앱은 OPTION 2를 사용하거나 다른 써드파티 SDK를 활용하여 SKAdNetwork에 이벤트를 전송해야 합니다.

전제 조건

대시보드 설정

1. Apple SKAdnetwork 인증 및 연동

🚧

개발자가 필요할 수 있습니다.

앱을 인증하려면 Branch가 여러 개의 ID와 인증을 완료하고 올바른 앱을 Branch 계정에 동기화해야 하므로 Apple의 개발자 도구 App Store Connect에 액세스해야 합니다.

imageimage

SKAdNetwork 기능을 설정하려면:

  1. 왼쪽 탐색 메뉴의 Channel & Links 아래에서 Ads를 클릭합니다.
  2. Ads 하위 메뉴에서 SKAdNetwork를 클릭하세요.
  3. SkAdNetwork 페이지에서 Configuration 탭을 클릭하세요.
  4. Authentication 탭에서 다음 App Store Connect 정보를 제공하세요:
    a. Issuer ID
    b. Key ID
    c. Private Key
    - "Admin" 또는 "App Manager" 액세스 수준을 선택합니다
  5. Save & Continue를 클릭합니다.
  1. App Store Connect 계정이 인증되면 (녹색 확인 표시로 표시됨) 올바른 앱이 동기화되었는지 확인하고 Integrate를 클릭하세요.

📘

App Store Connect Credentials

App Store Connect credentials are used as a one time check to verify app ownership. These credentials may be removed after the App Integration step is complete (green checkmark appears next to "App Integration"). Remove credentials by selecting "Reset App Store Credentials". The SKAdNetwork integration is complete and valid as long as the App Integration step is completed.

2. Branch SDK 서포트 옵트인

Branch 대시보드SKAdNetwork Config 섹션에서 YES 라디오 버튼을 선택하여 Branch SDK가 SKAdNetwork에 대한 모든 호출을 처리하도록 합니다.

다음과 같이 진행하는 경우 OPT-IN을 선택하지 마십시오.

3. 이벤트에 Conversion Value 할당

  • Branch 대시보드SKAdNetwork Config 섹션에서 Branch가 어트리뷰션을 위해 Apple에 보낼 모든 앱 이벤트를 선택합니다.
  • 중요도 레벨을 나타내는 각 이벤트(Apple은 0에서 63까지의 숫자를 허용)에 고유한 값을 할당합니다. 여기서 63은 가장 높은 우선순위이고 0은 가장 낮은 우선순위입니다. Apple은 우선순위가 낮은 이벤트가 나중에 트래킹되었는지 여부와 관계 없이 항상 가장 높은 우선순위의 이벤트를 사용합니다.

📘

이벤트 매핑은 최상위 레벨 이벤트 을 사용해야 합니다.

customer_event_alias를 사용하는 Branch 이벤트의 경우 Branch SDK의 자동화 된 이벤트 매핑이 해당 값에 매핑되지 않음으로 conversion value를 최상위 레벨 이벤트 이름에 매핑해야 합니다.

앱 옵션 1: Branch SDK를 사용하여 SKAdNetwork 관리

서포트되는 플랫폼

아래의 Branch SDK 버전은 SKAdNetwork 인앱 기능을 자동으로 처리합니다. 아래의 플랫폼에 Branch를 연동하지 않은 경우 SKAdNetwork와 직접 연동을 대신 수행하세요.

연동 단계

  • SKAdNetwork를 서포트하는 버전으로 Branch SDK를 업데이트합니다.
  • iOS 빌드로 Apple의 StoreKit 프레임 워크 가져오기

📘

Conversion value 변경

Branch SDK가 이벤트를 트래킹할 때마다 updateConversionValue를 호출하고 Branch 대시보드에 매핑된 값을 사용합니다. 대시보드에서 값을 변경하면 Branch SDK가 이러한 새 값을 대신 사용하기 시작합니다.

📘

SKAdNetwork 콜아웃의 기간 변경

기본적으로 Branch는 SKAdNetwork로의 updateConversionValue() 호출을 첫 설치 후 24 시간 이내로 제한합니다. updateConversionValue()이 이전보다 큰 값으로 호출될 때마다, 이로 인해 24시간 롤링 타이머에 의해 원 설치 이벤트에 대한 Apple의 어트리뷰션이 지연됩니다.

그러나 다음 SDK 방법을 사용하여 이 기간을 수정할 수 있습니다.
- (void)setSKAdNetworkCalloutMaxTimeSinceInstall:(NSTimeInterval)maxTimeInterval;

📘

Facebook - 광고 딜리버리 최적화 요구사항

Facebook 광고 게재 최적화를 위해서는 SKAdNetwork 창이 24 시간 이상 지연되지 않아야합니다. SDK는 24 시간의 기본 기간을 지원합니다.

📘

SKAdNetwork와 Branch SDK 간의 다양한 이벤트 트래킹

SKAdNetwork 전략에 따라 Branch SDK가 SKAdNetwork 인앱 연동을 자동화하는 것이 항상 의미가 있는 것은 아닙니다. conversion value에 대한 Apple의 제한(총 64개, 메타데이터 금지 등)으로 인해 Branch SDK로 트래킹하는 기존 이벤트를 사용하는 것은 SKAdNetwork와 직접 연동하여 맞춤 값을 트래킹하는 것만큼 효과적이지 않을 수 있습니다. 예를 들어 수익이 가장 중요한 측정 항목인 경우 conversion value를 사용하여 수익 '바구니 크기'의 차이를 나타낼 수 있습니다.

앱 옵션 2: SKAdNetwork와 직접 연동

Branch SDK를 통하지 않고 SKAdNetwork를 직접 관리하려는 경우 이 접근 방식을 사용하십시오.

연동 단계

📘

registerAppForAdNetworkAttribution ()은 한 번만 호출하면 됩니다.

이 메소드에 대한 후속 호출은 영향이 없습니다.

전환 리포트

  • Apple에 보내려는 모든 앱 이벤트에 대해 SKAdNetwork에서 updateConversionValue()를 호출하고 Branch 대시보드의 각 이벤트에 동일한 값을 사용합니다.
  • INSTALL 후 24 시간이 지나면 Branch의 트래킹 방법에 맞게 updateConversionValue () 호출을 중지 합니다. updateConversionValue ()가 이전보다 큰 값으로 호출 될 때마다 이로 인해 24 시간 롤링 타이머에 의해 원 설치 이벤트에 대한 Apple의 어트리뷰션이 지연됩니다.

📘

updateConversionValue()의 값 업데이트

이벤트의 conversion value를 변경하면 최신 버전의 앱 유저가 새로운 conversion value로 전환을 리포트하는 반면, 이전 앱 버전의 유저는 이전 conversion value로 전환을 계속 리포트하게 됩니다(앱 업데이트 전까지).

또한 Branch 대시보드에서 매핑된 값을 업데이트하여 리포트가 Branch에서 정렬되도록 해야 합니다.

📘

Apple에는 전환을 리포트하는 서버 측 API가 없습니다.

SKAdNetwork는 유저를 전환에 연결하는 기능을 차단하므로 서버 측 이벤트를 트래킹하는 연동은 여전히 앱이 SKAdNetwork에 전환을 하도록 지시해야 합니다. 첫 번째 전환은 설치 후 24시간 이내에 이루어져야 하기 때문에 이벤트가 서버 측에서 트래킹 될 가능성이 있지만 유저는 Apple에 리포트하기 위해 24시간 이내에 앱을 다시 열지 않습니다.

이러한 위험을 완화하려면 일반적으로 서버 측 이벤트로 이어지는 일련의 인앱 이벤트를 항상 트래킹 하세요(예: "add-to-cart"는 일반적으로 "구매"전에 발생하는 이벤트입니다). 이는 서버 측 이벤트를 대체하지는 않지만 광고 캠페인 실적을 평가할 때 효과적인 프록시 역할을 할 수 있습니다. 또한 Apple의 24시간 타이머를 지연 시켜 서버 측 이벤트가 트래킹 된 후 유저가 제시간에 앱을 다시 열 가능성을 높일 수 있습니다.

문제 해결 FAQ

16일 전에 업데이트됨



SKAdNetwork 모바일 연동


제안된 편집은 API 참조 페이지에서 제한됩니다.

Markdown 본문 콘텐츠에 대한 편집만 제안할 수 있지만 API 사양에는 제안할 수 없습니다.