概要

このガイドでは、共通のS2Sの仕組みの上に重なる、モバイル固有のアトリビューションシグナルを扱います。具体的には、Apple Search Ads、Google PlayおよびMetaのインストールリファラー、アンインストール計測、そしてiOSインストールレシートです。セッションとイベントをサーバー間（server-to-server）で報告するiOSおよびAndroidアプリの連携に適用されます。

これらの機能は、共通のS2Sリクエストフローがすでに実装されていることを前提としています。これらが基盤とするエンドポイント、認証、共通パラメータについては、まずファンダメンタルズのハブと2つのエンドポイントリファレンスから始めてください。

Apple Search Adsアトリビューション

iOS Search Adsの連携

Apple Search Adsは自己アトリビューションネットワーク（SAN）であり、Appleのフレームワークを介したプラットフォーム固有のアトリビューション実装が必要です。

フレームワークのサポート：

• iOS 14.2以前： iADフレームワーク
• iOS 14.3以降： AdServicesフレームワーク （推奨）

詳細ガイド： Apple Search Ads連携ドキュメント

iADフレームワークの実装

iOS 14.2以前向けに、iADフレームワークを介してApple Search Adsのアトリビューションデータを取得して送信します。

ステップ1：アトリビューションデータを取得する

#import <iAd/iAd.h>

Class ADClientClass = NSClassFromString(@"ADClient");

if (ADClientClass) {
    id sharedClient = [ADClientClass performSelector:@selector(sharedClient)];

    if ([sharedClient respondsToSelector:@selector(requestAttributionDetailsWithBlock:)]) {
        [sharedClient requestAttributionDetailsWithBlock:^(NSDictionary *attributionDetails, NSError *error) {
            if (attributionDetails && attributionDetails.count > 0) {
                // REPORT attributionDetails FROM YOUR APP TO YOUR SERVER
            }
        }];
    }
}

ステップ2：Singularに送信する

予約名 __iAd_Attribution__ を使用し、 EVENTエンドポイント を介して、アトリビューションのJSONを e パラメータとして渡し、イベントを報告します。

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インストールリファラーは、Playストアに到達する前のユーザーの発生元に関する情報を含んでおり、最も正確なAndroidインストールアトリビューションを提供します。

詳細情報： Googleインストールリファラードキュメント

実装手順：

1. Play Install Referrer API を使用して、最初のアプリ起動時にインストールリファラーを取得する
2. 必須の属性を含む install_ref JSONパラメータを含めて、 SESSIONエンドポイント を介してセッションを報告する

install_refの属性：

Metaインストールリファラー

Facebookアトリビューションの強化

MetaリファラーはAndroid固有の計測ソリューションで、Google PlayインストールリファラーとMetaインストールリファラーの技術を組み合わせることで、アプリインストールに関する詳細なユーザーレベルのアトリビューションデータを提供します。

詳細はこちら： Metaリファラー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セッションを報告する際に、 install_receipt パラメータでiOSインストールレシートを渡します。

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
            }
        }
    }
}