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 인증 및 연동

🚧

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

앱을 인증하려면 Apple의 개발자 도구인 App Store Connect에 접속할 수 있어야 합니다. Branch가 인증 과정을 마친 뒤 앱을 정확히 Branch 계정과 연동시키기 위해서 몇가지 ID와 Key가 필요하기 때문입니다.

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은 앱 소유권을 검증하기 위한 일회성 확인 방법으로 사용됩니다. 이 Credentials은 앱 연동 과정이 완료된 후 삭제될 수 있습니다(녹색 체크 표시가 'App Integration' 옆에 표시됨). 'Reset App Store Credentials'을 선택하여 Credentials을 제거하십시오. 앱 연동 과정이 완료되어야 SKAdNetwork 연동이 온전히 완료됩니다.

2. Branch SDK Opt-in 설정

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

다음에 해당하는 경우 Opt-in을 No로 선택하세요.

3. 이벤트에 Conversion Value 할당

  • Branch 대시보드SKAdNetwork Config 섹션에서 Branch가 어트리뷰션을 위해 Apple에 보낼 모든 앱 이벤트를 선택합니다.
  • You may optionally select a Customer Event Alias and/or a Revenue Range to further distinguish the conversion value.
  • Assign unique values to each event (Apple accepts any number from 0 to 63) that represent their level of importance to you, where 63 is the highest priority and 0 is the lowest priority. Apple will always use the event with the highest priority, regardless if an event with a lower priority was tracked afterward.

📘

Revenue Range Guidance

  • Revenue range is available for all Commerce Events where revenue is available on the event (Purchase, Add to Cart, Add to Wishlist, View Cart, Initiate Purchase, Add Payment Info, Click Ad, View Ad, Reserve, Spend Credits).
  • Revenue must be entered as USD on the dashboard. Branch will convert revenue with different currencies on events to USD.
  • Revenue ranges must not overlap for the same event (Ex: 1-100, 50-150).
  • Lower Bound Revenue is inclusive, Upper Bound Revenue is exclusive.
  • While not necessary, it is recommended to include both a lower + upper bound on every event.

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

지원 플랫폼

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

연동 과정

  • SKAdNetwork를 지원하는 버전으로 Branch SDK를 업데이트합니다.
  • iOS 빌드로 Apple의 StoreKit 프레임 워크 가져오기
  • 앱이 열릴 때 Branch SDK가 초기화되는지 확인합니다. SDK가 초기화되지 않는 경우 모바일 개발자에게 기본 Branch 모바일 연동을 완료하도록 합니다. 배후에서 Branch SDK는 registerAppForAdNetworkAttribution을 호출하여 Apple이 SKAdNetwork를 서포트하는 애드 네트워크에 설치를 어트리뷰션 하도록 합니다.
  • Branch SDK를 통해 앱 이벤트들을 트래킹하고 있는 지 확실히 확인합니다. 새 전환 이벤트를 추가하려는 경우, Branch SDK를 사용하여 해당 이벤트를 추적하도록 앱을 업데이트해야 합니다.

📘

Conversion value 변경

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

📘

SKAdNetwork 호출 기간 변경

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

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

📘

Facebook - 광고 게재 최적화 요구사항

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

📘

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

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

앱 옵션 2: SKAdNetwork와 직접 연동

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

연동 과정

  • 대시보드 설정에서 Branch SDK가 SKAdNetwork를 관리하지 않도록 Opt-in "No"를 선택하고 대시보드 설정의 나머지를 완료합니다.
  • iOS 빌드로 Apple의 StoreKit 프레임 워크 가져오기

📘

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

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

전환 리포트

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

📘

updateConversionValue()의 값 수정

이벤트에 해당하는 conversion value를 수정하게 되면, 최신 버전의 앱 유저는 수정한 conversion value로 전환을 리포트하는 반면, 이전 앱 버전의 유저는 수정하기 전의 conversion value로 전환을 계속 리포트하게 됩니다(유저가 직접 앱 업데이트를 하기 전까지).

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

📘

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

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

이런 리스크를 줄이려면, 일반적으로 서버 사이드 이벤트까지 이어지는 일련의 인앱 이벤트를 항상 트래킹 하세요. (예: "add-to-cart"는 일반적으로 "purchase"전에 발생하는 이벤트입니다). 이는 서버 사이드 이벤트를 대신할 수는 없지만 광고 캠페인 실적을 평가할 때 효과적인 보조적 대안이 될 수 있습니다. 또한 Apple의 24시간 타이머를 지연시켜 서버 사이드 이벤트가 추적된 후 유저가 제시간 내에 앱을 다시 열 가능성을 높일 수 있습니다.

문제 해결 FAQ

8일 전에 업데이트됨



SKAdNetwork 모바일 연동


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

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