Apple의 SKAdNetwork API는 사용자 개인 정보를 보호하면서 앱 설치 광고 캠페인의 실적을 측정하는 것을 목표로 합니다.
SKAdNetwork v2.0 및 v2.1의 경우 StoreKit 렌더링 광고의 설치 기여 분석은 사용자가 앱을 설치하게 되는 광고 클릭에 의해 결정됩니다. SKAdNetwork v2.2 및 이후 버전에서는 광고 조회만으로 기여 분석이 이루어지는 조회 완료 광고도 지원합니다.
다음 가이드라인은 Google 모바일 광고 SDK가 SKAdNetwork 기여 분석을 올바르게 시작할 수 있도록 제공됩니다.
모바일 광고의 클릭 기여 분석
SKAdNetwork 기여 분석은 클릭 액션이 Apple App Store에만 도달하는 경우에만 Google 모바일 광고 SDK 광고 클릭 이벤트에 의해 시작됩니다. 이 요구사항은 앱 스토어를 열기 위한 것이 아닌 클릭으로 앱 스토어가 실행되는 것을 방지하기 위한 것입니다. 이러한 유형의 클릭 액션에는 예를 들어 Ad Choices 페이지로 이동하는 것이 포함될 수 있습니다.
가이드라인
광고의 클릭 액션과 후속 앱 설치가 SKAdNetwork 기여 분석으로 이어지도록 하려면 광고 소재를 빌드할 때 광고 소재의 클릭연결 URL이 다음 중 하나인지 확인하세요.
앱 스토어에서 광고하는 앱으로 연결되는 직접 링크
HTTP 301, 302 또는 앱 스토어의 최종 대상이 될 수 있는 기타 유형의 서버 측 HTTP 리디렉션 체인과 같은 리디렉션 메서드를 사용합니다.
직접 또는 리디렉션 체인을 통해 앱 스토어로 연결되는 링크는 URL이 다음 패턴 중 하나로 시작하면 확인됩니다.
https://apps.apple.com
https://itunes.apple.com
itms-apps://
itms://
다른 방문 페이지 또는 다른 클라이언트 측 리디렉션 방법을 사용하는 경우 앱 스토어로 연결되지 않는 것으로 확인되며 SKAdNetwork 기여 분석 프로세스가 시작되지 않을 수 있습니다. 예:
앱 스토어로 리디렉션하려면 사용자 작업이 필요한 HTML 페이지
앱 스토어로 연결되는 자동화된 JavaScript 기반 리디렉션 스크립트가 있는 HTML 페이지
메타 새로고침 태그
다양한 광고 소재 유형에 대한 권장사항
SKAdNetwork 기여 분석을 시작하는 클릭 액션은 다음과 같이 다양한 광고 유형에 대해 설정할 수 있습니다.
HTML 광고 소재
클릭 가능한 요소를 둘러싸는 앵커 태그의 도착 URL로 설정하거나 JavaScript 기반 클릭 이벤트의 window.location 작업 타겟 URL로 설정할 수 있습니다.
MRAID
클릭 액션은 SKAdNetwork 기여 분석을 시작하려면 Mraid.open()를 호출해야 합니다.
VAST 동영상
앱 스토어 URL은 VAST XML의 ClickThrough 요소에 설정해야 합니다.
네이티브
앱 스토어 URL은 OpenRTB의 native.link.url 필드(또는 지원 중단된 Google RTB 프로토콜의 native_ad.click_link_url 필드)에 설정해야 합니다.
모바일 광고의 조회 후 기여 분석
SKAdNetwork v2.2 조회 완료 기여 분석이 지원되는 경우 SKAdNetwork API는 광고가 렌더링되고 사용자가 광고를 본 후 노출 타이머를 시작합니다.
기여 분석은 3초 이상 표시된 광고에 대해서만 허용됩니다.
iOS 버전 15.3 이하에서는 한 번에 활성 노출 타이머를 1개만 지원하므로 동일한 화면에 조회 완료 기여 분석 광고가 여러 개 있는 경우 노출이 조회 완료 기여 분석 시작에 실패할 수 있습니다. 이 제한사항은 iOS 버전 15.4 이상에서 해제되었으므로 이제 SKAdNetwork에서 조회 완료 기여 분석에 사용 설정된 여러 개의 동시 노출을 허용합니다.
가이드라인
입찰 요청 필드 BidRequest.imp.ext.skadn.fidelities는 어떤 기여 분석 무결성 유형이 지원되는지 지정합니다. 이 필드에는 SKAdNetwork 버전 v2.2 이상에서 VIEW_THROUGH_ADS 충실도 유형이 포함됩니다.
조회연결 기여 분석이 지원되지 않는 경우 입찰 응답에 VIEW_THROUGH_ADS 화질이 포함되지 않아야 합니다. 지원되지 않는 경우 VIEW_THROUGH_ADS 화질로 응답하면 입찰 전에 입찰이 필터링됩니다.
이전 버전과의 호환성
SKAdNetwork v4.0부터 SKAdNetwork 기여 분석에 사용 설정된 광고 요청은 하위 호환됩니다. 이렇게 하면 광고 요청이 최신 버전을 지원하는 경우에도 광고 네트워크가 이전 SKAdNetwork 버전으로 응답할 수 있습니다.
가이드라인
사용자의 기기 OS 버전과 게시자 앱의 Google 모바일 광고 SDK 버전 모두 광고 요청에서 지원되는 SKAdNetwork 기능을 지정합니다.
이는 BidRequest.imp.ext.skadn.versions를 사용하여 입찰 요청에서 확인할 수 있습니다. 광고 요청에서 지원하는 모든 SKAdNetwork 버전이 표시됩니다.
입찰 필터링을 방지하려면 응답을 빌드하는 데 사용된 SKAdNetwork 버전이 입찰 요청에 나열된 버전 중 하나인지 확인합니다. 또한 최신 SKAdNetwork 버전이 도입되면 버전이 이 목록에 있는 한 이전 버전으로 응답하는 것이 허용됩니다. 이를 통해 광고 네트워크는 이전 버전으로 계속 응답하고 자체 속도에 맞게 최신 버전을 조정할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eApple's SKAdNetwork API measures app install ad campaign success while prioritizing user privacy, with versions 2.2 and later supporting view-through ad attribution in addition to click-based attribution.\u003c/p\u003e\n"],["\u003cp\u003eTo ensure correct SKAdNetwork attribution, ad click actions must directly link to the Apple App Store or use server-side redirects (HTTP 301, 302) that ultimately lead to the App Store.\u003c/p\u003e\n"],["\u003cp\u003eFor view-through attribution in SKAdNetwork v2.2 and later, ads must be displayed for a minimum of 3 seconds to initiate the impression timer, with iOS 15.4 and later versions supporting multiple concurrent impressions.\u003c/p\u003e\n"],["\u003cp\u003eThe bid request fields indicate supported SKAdNetwork features, including attribution fidelity types and supported versions, ensuring compatibility and preventing bid filtering.\u003c/p\u003e\n"],["\u003cp\u003eSKAdNetwork ad requests are backward compatible, allowing ad networks to respond with earlier versions listed in the bid request, providing flexibility in adopting new SKAdNetwork versions.\u003c/p\u003e\n"]]],[],null,["Apple's [SKAdNetwork\nAPI](//developer.apple.com/documentation/storekit/skadnetwork) aims to\nmeasure the success of app install ad campaigns while maintaining user privacy.\nFor SKAdNetwork v2.0 and v2.1, install attribution for StoreKit-rendered ads is\ndriven by clicks on the ad that would lead to the user installing the app.\n[SKAdNetwork v2.2](//developer.apple.com/documentation/storekit/skadnetwork/skadnetwork_release_notes/skadnetwork_version_2_2_release_notes)\nand later versions additionally supports view-through ads where attribution is\ndriven by just viewing the ad.\n\nThe following guidelines are provided to ensure that the Google Mobile Ads SDK\ncan initiate SKAdNetwork attribution correctly.\n\nOn-click attribution for mobile ads\n\nSKAdNetwork attribution is initiated by the Google Mobile Ads SDK ad click event\nonly if the click action specifically lands in the Apple App Store. The reason\nfor this requirement is to prevent the app store from being launched by clicks\nthat are *not* meant to open the app store. These types of click actions could\ninclude, for example, navigating to an Ad Choices page.\n\nGuidelines\n\nTo guarantee that click actions on ads and subsequent app installs would result\nin a SKAdNetwork attribution, when building the creatives, make sure that the\ncreative's click-through URL is either\n\n- a direct link to the advertised app in the app store, or,\n- uses redirect methods, such as HTTP 301, 302, or other types of server-side HTTP redirect chains that would have a final destination of the app store.\n\nLinks to the app store either directly or through a redirect chain are confirmed\nif the URL begins with any of the following patterns:\n\n- `https://apps.apple.com`\n- `https://itunes.apple.com`\n- `itms-apps://`\n- `itms://`\n\nAny other landing pages or using any other client-side redirect methods are\ndetermined to *not* land in the app store and might not initiate the SKAdNetwork\nattribution process. Examples:\n\n- HTML page that requires user action to redirect to the app store\n- HTML page that has an automated JavaScript-based redirect script to the app store\n- Meta refresh tags\n\nBest practices for different creative types\n\nThe click action to initiate SKAdNetwork attribution can be set up for the\ndifferent creative types as follows:\n\nHTML creatives\n: This can be set up as the destination URL on the anchor tags surrounding the\n clickable element, or as the target URL of `window.location` operations from\n JavaScript-based on-click events.\n\nMRAID\n: The click action needs to call `Mraid.open()` to initiate the SKAdNetwork\n attribution.\n\nVAST video\n: The app store URL should be set in the `ClickThrough` element in the VAST\n XML.\n\nNative\n: The app store URL should be set on the `native.link.url` field for OpenRTB\n (or the `native_ad.click_link_url` field for the deprecated Google RTB\n protocol).\n\nView-through attribution for mobile ads\n\nWhen SKAdNetwork v2.2 view-through attribution is supported, the SKAdNetwork API\nstarts an impression timer once the ad is rendered and is viewed by the user.\nAttribution is only allowed for ads that have been displayed for a [minimum of 3\nseconds](//developer.apple.com/documentation/storekit/skadnetwork/generating_the_signature_to_validate_view-through_ads).\n\nNote that iOS versions 15.3 and earlier only supports 1 active impression timer\nat a time, in which case it could be possible for an impression to fail\nview-through attribution initiation if there are multiple view-through\nattribution ads within the same screen. This restriction has been [lifted on iOS\nversion 15.4 and above](//developer.apple.com/documentation/storekit/skadnetwork/3727304-startimpression#discussion),\nso SKAdNetwork now allows for multiple concurrent impressions enabled for\nview-through attribution.\n\nGuidelines\n\nThe bid request field `BidRequest.imp.ext.skadn.fidelities` specifies which\nattribution fidelity types are supported. This field includes the\n`VIEW_THROUGH_ADS` fidelity type in SKAdNetwork versions v2.2 or higher.\n\nEnsure the bid response doesn't include `VIEW_THROUGH_ADS` fidelities if\nview-through attribution is not supported. Responding with `VIEW_THROUGH_ADS`\nfidelities when not supported causes the bid to be filtered before the auction.\n\nBackwards compatibility\n\nAs of SKAdNetwork v4.0, ad requests enabled for SKAdNetwork attribution are\nbackward compatible. This allows ad networks to respond with earlier SKAdNetwork\nversions even when the ad request supports newer versions.\n\nGuidelines\n\nThe user's device OS version and the publisher app's Google Mobile Ads SDK\nversion both dictate which SKAdNetwork features are supported by the ad request.\nThis can be determined on the bid request using\n`BidRequest.imp.ext.skadn.versions`. This lists all SKAdNetwork versions\nsupported by the ad request.\n\nTo prevent bid filtering, ensure that the SKAdNetwork version used to build the\nresponse is one of the listed versions on the bid request. In addition, when\nnewer SKAdNetwork versions are introduced, note that responding with earlier\nversions are allowed as long as the version is in this list. This allows ad\nnetworks to continue responding with earlier versions and adapt newer versions\nat their own pace."]]
