개요

이 가이드는 공유 S2S 메커니즘 위에 더해지는 모바일 전용 어트리뷰션 신호, 즉 Apple Search Ads, Google Play 및 Meta 설치 리퍼러, 앱 삭제 추적, iOS 설치 영수증을 다룹니다. 세션과 이벤트를 server-to-server 방식으로 리포트하는 iOS 및 Android 앱 연동에 적용됩니다.

Apple Search Ads 어트리뷰션

iOS Search Ads 연동

Apple Search Ads는 Self-Attributing Network(SAN)로, Apple 프레임워크를 통한 플랫폼별 어트리뷰션 구현이 필요합니다.

프레임워크 지원:

• AdServices (iOS 14.3 이상): AdServices 프레임워크. 현재 권장되는 연동 방식입니다.
• iAd (iOS 14.2 이하): iAd 프레임워크. Apple에서 지원 중단된 레거시 프레임워크로, 신규 연동에는 권장되지 않습니다.

전체 가이드: Apple Search Ads 연동 문서

AdServices 프레임워크 구현

iOS 14.3 이상에서 AdServices 프레임워크를 통해 어트리뷰션 토큰을 가져와 전송합니다.

1단계: 어트리뷰션 토큰 가져오기

#import <AdServices/AdServices.h>

NSError *error = nil;
Class AAAttributionClass = NSClassFromString(@"AAAttribution");
if (AAAttributionClass) {
    NSString *attributionToken = [AAAttributionClass attributionTokenWithError:&error];
    if (!error && attributionToken) {
        // Handle attributionToken
    }
}

2단계: Singular로 전송

토큰을 URL 인코딩하여 모든 설치 및 재설치 후 첫 세션에서 SESSION 엔드포인트 에 attribution_token 파라미터로 추가합니다.

Google Play 설치 리퍼러

Android 설치 어트리뷰션

Google Play 설치 리퍼러는 가장 정확한 Android 설치 어트리뷰션을 제공하며, Play Store에 도달하기 전 사용자 출처에 대한 정보를 포함합니다.

자세한 정보: Google Install Referrer 문서

구현 단계:

1. 첫 앱 실행 시 Play Install Referrer API 를 사용하여 설치 리퍼러를 가져옵니다
2. 필수 속성이 포함된 install_ref JSON 파라미터를 포함하여 SESSION 엔드포인트 를 통해 세션을 리포트합니다

install_ref 속성:

Meta 설치 리퍼러

Facebook 어트리뷰션 강화

Meta Referrer는 Android 전용 측정 솔루션으로, Google Play 설치 리퍼러와 Meta 설치 리퍼러 기술을 결합하여 앱 설치에 대한 세분화된 유저 레벨 어트리뷰션 데이터를 제공합니다.

자세히 알아보기: Meta Referrer FAQ

구현 단계:

1. 첫 앱 실행 시 Meta 문서 에 따라 Meta 설치 리퍼러를 가져옵니다
2. 필수 속성이 포함된 meta_ref JSON 파라미터를 포함하여 SESSION 엔드포인트 를 통해 세션을 리포트합니다

meta_ref 속성:

앱 삭제 추적

사일런트 푸시 알림 설정

모든 세션 알림과 함께 푸시 토큰을 전송하여 기기의 사일런트 푸시 알림을 사용해 앱 삭제를 추적합니다.

설정 요구사항:

1. 플랫폼별 앱 삭제 추적 설정을 따르세요:
   • iOS 앱 삭제 추적 설정
   • Android 앱 삭제 추적 설정
2. 플랫폼별 토큰을 SESSION 요청에 추가하세요:
   • iOS: apns_token (APNs 기기 토큰)
   • Android: fcm (FCM 기기 토큰)

iOS 설치 영수증

영수증 검증

iOS 세션을 리포트할 때 iOS 설치 영수증을 install_receipt 파라미터로 전달합니다.

import Foundation
import StoreKit

class ReceiptManager {
    static func getInstallReceipt() -> String? {
        if #available(iOS 18.0, *) {
            let semaphore = DispatchSemaphore(value: 0)
            var result: String?

            Task {
                do {
                    let transaction = try await AppTransaction.shared
                    result = transaction.jwsRepresentation
                    semaphore.signal()
                } catch {
                    debugPrint("Failed to get app transaction: \(error.localizedDescription)")
                    semaphore.signal()
                }
            }

            semaphore.wait()
            return result

        } else {
            guard let receiptURL = Bundle.main.appStoreReceiptURL else {
                debugPrint("Receipt URL not found")
                return nil
            }

            do {
                let receiptData = try Data(contentsOf: receiptURL, options: .uncached)
                return receiptData.base64EncodedString(options: [])
            } catch {
                debugPrint("Failed to read receipt: \(error.localizedDescription)")
                return nil
            }
        }
    }
}