SKAdNetwork 모바일 연동


Using Branch to manage your Advertiser SKAdNetwork integration and display SKAdNetwork data in Branch, requires updating the Branch dashboard and updating your iOS app in one of two ways:

  • OPTION 1 - Use the Branch SDK to manage all calls to SKAdNetwork
  • OPTION 2 - Integrate directly with SKAdNetwork to fully control what's sent to Apple


Which SKAdNetwork implementation option is better for you?

To learn more about the advantages of each integration approach, please read this FAQ item.


서버 투 서버 및 TUNE SDK 연동

Any mobile app that uses a server-to-server integration, uses the TUNE SDK, or uses any other integration solution/kit that doesn't contain the Branch SDK directly must use OPTION 2 or leverage another 3rd party SDK to send events to SKAdNetwork

전제 조건

대시보드 설정

1. Authenticate & Integrate with Apple SKAdNetwork


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

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


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 설정

In the SKAdNetwork Config section of the Branch dashboard, select the YES radio button to have the Branch SDK handle all calls to SKAdNetwork.

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

Note for Segment SDK Clients
Segment does not support SKAdNetwork conversion tracking so to see conversion events in Branch you need to do one of the following:

  • Tracking this event by the Branch SDK OR
  • Manually implement updateConversionValue method inside the app for events tracked by Segment

3. 이벤트에 Conversion Value 할당

  • In the SKAdNetwork Config section of the Branch dashboard, select all app events you want Branch use for triggering SKAdNetwork conversion value updates.
  • 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 (SKAdNetwork accepts any number from 1 to 63, with 0 reserved by the system for the initial install) that represent their level of importance to you, where 63 is the highest priority and 0 is the lowest priority. SKAdNetwork 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.
  • It is necessary to include both a lower + upper bound on every event.

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

지원 플랫폼

The Branch SDK versions below automatically handle SKAdNetwork in-app functionality. If you do not integrate Branch in the platforms below, please integrate directly with SKAdNetwork instead.

연동 과정

  • SKAdNetwork를 지원하는 버전으로 Branch SDK를 업데이트합니다.
  • Import Apple's StoreKit framework into your iOS build


Conversion value 변경

Whenever the Branch SDK tracks an event, it will call updateConversionValue and use the values mapped in the Branch dashboard. If you change the values in the dashboard, the Branch SDK will start using those new values instead.


SKAdNetwork 호출 기간 변경

By default, Branch limits updateConversionValue() calls to SKAdNetwork to within 24 hours after first install. Every time updateConversionValue() is called with a value greater than previous, this delays SKAdNetwork's attribution of the original Install event by a rolling 24 hour timer.

그러나 다음 SDK 메소드를 사용하여 이 기간을 수정할 수 있습니다.
- Branch.getInstance().setSKAdNetworkCalloutMaxTimeSinceInstall(3600.0 * 24.0)


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

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


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

Based on your SKAdNetwork strategy, it may not always make sense to have the Branch SDK automate the SKAdNetwork in-app integration. Because of SKAdNetwork's restrictions on conversion values (63 total values, no metadata, etc.), using the existing events you track with the Branch SDK may not be as effective as tracking custom values by integrating directly with SKAdNetwork. For example, if revenue is your most important metric, you can use conversion values to represent differences in revenue "basket size".

앱 옵션 2: SKAdNetwork와 직접 연동

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

연동 과정

  • Opt-out from having the Branch SDK manage SKAdNetwork in the dashboard setup, and complete the remainder of the dashboard setup
  • Import Apple's StoreKit framework into your iOS build


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

Subsequent calls to this method have no effect.

전환 리포트

  • Call updateConversionValue() from SKAdNetwork for every app event you want to send to Apple, and use the same values for each event in the Branch dashboard.
  • INSTALL 후 24 시간이 지나면 Branch의 트래킹 방법과 동일하게 updateConversionValue () 호출을 중지하도록 설정합니다. updateConversionValue ()가 이전보다 큰 값으로 호출 될 때마다 최초 설치 이벤트에 대한 Apple의 어트리뷰션이 24시간 롤링 타이머에 의해 미뤄지게 됩니다.


updateConversionValue()의 값 수정

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

Please also remember to update the values mapped in the Branch dashboard, to ensure reporting is aligned in Branch.


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

SKAdNetwork prevents the ability to connect users to conversions, so integrations that track events server-side must still tell the app to report the conversion to SKAdNetwork. Because the first conversion must occur within 24 hours of install, there will be a chance the event is tracked server-side but the user does not re-open the app within the 24 hour window for it to be reported to Apple.

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

문제 해결 FAQ

이 페이지가 도움이 되었습니까?