アトリビューションモジュール

使用法

アトリビューションモジュールは、各トラッキングコールにユーザーリセット可能な広告識別子（IDFA）を追加し、オプションでApple Search Ads APIを実装してアトリビューション情報を収集します。Apple Search Adsアトリビューションの構成について詳しく学びましょう。

バージョン2.1.1以降では、アトリビューションモジュールにはSKAdNetworkのサポートが含まれており、ATTransparency.AuthorizationStatusがディスパッチペイロードに追加されます。

このモジュールの使用はオプションです。その機能について読んで、必要かどうかを判断してください。なぜなら、それは追加の依存関係を導入します。あなたはAppleに対して、なぜIDFAを使用しているのかを説明する必要があります。IDFAの使用を明記しない場合、Appleはあなたのアプリを拒否します。IDFAの使用と拒否について詳しく学びましょう。

以下のプラットフォームがサポートされています：

• iOS

要件

• UIKit
• AdSupport
• iOS 14以降：AppTrackingTransparency
• iOS 14以降：StoreKit

インストール

Swift Package Manager、CocoaPods、またはCarthageを使用してアトリビューションモジュールをインストールします。

Swift Package Manager（推奨）

バージョン1.9.0以降でサポートされているSwift Package Managerは、Tealium Swiftライブラリをインストールする最も簡単で推奨される方法です：

1. Xcodeプロジェクトで、File > Add Package Dependenciesを選択します。
2. リポジトリURLを入力します：https://github.com/tealium/tealium-swift
3. バージョンルールを構成します。通常、"Up to next major"が推奨されます。現在のTealium Swiftライブラリのバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットします。
4. インストールするモジュールのリストからAttributionモジュールを選択し、Xcodeプロジェクトの各アプリターゲットに追加します。Frameworks and Librariesの下にあります。

iOS向けのSwift Package Managerのインストールについて詳しく学びましょう。

CocoaPods

CocoaPodsでアトリビューションモジュールをインストールするには、以下のpodをPodfileに追加します：

pod 'tealium-swift/Attribution'

iOS向けのCocoaPodsのインストールについて詳しく学びましょう。

Carthage

Carthageでアトリビューションモジュールをインストールするには、以下の手順を実行します：

1. Xcodeでアプリターゲットの一般構成ページに移動します。
2. 次のフレームワークをEmbedded Binariesセクションに追加します：

   TealiumAttribution.framework
   

iOS向けのCarthageのインストールについて詳しく学びましょう。

初期化

モジュールを初期化するには、collectorsプロパティに含めます。

config.collectors = [Collectors.Attribution]

Collectorsのドキュメンテーションを確認し、必要なコレクターを正しく指定する方法を理解してください。

iOS 14+でのアトリビューション

iOS 14以降では、アプリはユーザーの許可を得てデバイスの広告識別子（IDFA）にアクセスする必要があります。アプリが初めて起動するときにユーザーに「トラッキングの許可」を求めるプロンプトが表示されます。ユーザーが拒否すると、IDFAはアプリで利用できません。

IDFAが利用できない場合、SKAdNetworkは登録された広告ネットワークがアプリのインストールをキャンペーンにアトリビュートするための方法を提供します。これは、Appleから直接署名された信号を受け取ることによって行われます。広告ネットワークは、アプリが正常にインストールされたこと、キャンペーンID、およびオプションのコンバージョン値を受け取ります。

AppTrackingTransparencyとSKAdNetworkフレームワークについては、Consent and the Apple IDFA (Identifier for Advertisers)で詳しく学びましょう。

AppTrackingTransparency (ATT)

アトリビューションモジュールが有効になっていると、ユーザーのトラッキング認証ステータスが自動的にディスパッチペイロードにdevice_tracking_authorizationとして追加され、その値はATTrackingManager.AuthorizationStatus列挙型の文字列表現です。

該当する場合は、ATTrackingManager.requestTrackingAuthorizationを別途呼び出します。Tealium SDKを有効にするためのトラッキング認証のリクエストについて詳しく学びましょう。

SKAdNetwork

Tealiumは、config.skAdAttributionEnabledがtrueに構成されている場合、起動時に自動的にSKAdNetwork.registerAppForAdNetworkAttribution()を呼び出します。これにより、広告ネットワークはアプリのインストールを匿名で検証することができます。config.skAdConversionKeys辞書が定義されている場合、指定されたイベントで自動的にSKAdNetwork.updateConversionValue()が呼び出され、指定されたコンバージョンキーの値が送信されます。

config.skAdConversionKeys = ["EVENT_NAME": "DATA_LAYER_VARIABLE"]

コンバージョン値は、0から63までの値を持つIntでなければなりません。コンバージョン値が小数の場合、コンバージョンイベントを呼び出す前に整数に変換する必要があります。

例えば：

config.skAdConversionKeys = ["purchase": "conversion_value"]
...
tealium?.track("purchase", dataLayer: ["order_subtotal": 456.87, "conversion_value": conversionValue])

SKAdNetworkフレームワークについて詳しく学びましょう。

プロセス

以下の図は、広告のインストール検証のパスを示しています。App Aは広告を表示するソースアプリで、App Bはユーザーがインストールする広告アプリです。

ユーザーがアプリ内またはモバイルウェブブラウザ内の広告をクリックすると、App Storeが起動し、ユーザーは広告キャンペーンの製品画面に移動します。iOS 14.5以降では、広告主はカスタムビュースルーアドまたはStoreKitレンダリングアドを表示するかどうかを選択するオプションがあります。ユーザーが広告アプリをインストールすると、デバイスは保留中のインストール検証を保存します。ユーザーがアトリビューションタイムウィンドウ内にアプリを開くと、デバイスはインストール検証のポストバックを広告ネットワークに送信します。

通知はAppleによって署名され、キャンペーンIDを含みますが、ユーザーまたはデバイス固有のデータは除外されます。ポストバックには、Appleが値の提供がAppleのプライバシー閾値を満たすと判断した場合、コンバージョン値とソースアプリのIDが含まれる場合があります。

広告主導のアプリインストールについて詳しく学びましょう。

Tealiumの役割

AppleのSKAdNetworkソリューションには3つの主要な関係者がいます：

• 広告ネットワーク
• ソースアプリ
• 広告アプリ

TealiumはSKAdNetworkへの呼び出しをラップします。TealiumAttributionモジュールと構成フラグが有効になっている場合、アプリの起動時にSKAdNetwork.registerAppForAdNetworkAttribution()が呼び出されます。

さらに、skAdConversionKeysを定義している場合、SKAdNetwork.updateConversionValue(_:)メソッドが呼び出され、指定されたコンバージョン値が渡されます。Tealiumは、既に設置しているトラッキングを通じてSKAdNetworkへの呼び出しを管理することを可能にします。

ユーザーからトラッキング認証をリクエストし、適切なキーを.plistファイルに追加する必要があるかもしれません。

次の図は、TealiumがSKAdNetworkとどのように連携するかを示しています：

検証

SKAdNetworkへの呼び出しの検証について学びましょう。

Search Ads API

Apple Search Ads APIを使用するには、TealiumConfigオブジェクトのsearchAdsEnabledプロパティを有効にします。次に、AAAttributionクラスを使用して、アトリビューションオブジェクトを取得するためのトークンを取得します。Tealiumライブラリはアプリの起動時にこれを行いますが、情報がタイムリーに取得されない可能性があります。Appleから受け取った情報は、通常は起動イベント中にデータレイヤーに追加されます。

場合によっては、起動後にいくつかのイベントが発生することがあります。これらの変数は、アプリのライフタイム中に一度だけAppleのサーバーから取得され、永続的な変数として保存されるため、将来のアプリの起動時に利用可能になります。

iAdフレームワークからAdServicesフレームワークへ

iOS 14.3以降、AppleはiAdフレームワークを非推奨とし、新しいAdServicesを推奨しています。

• iAdフレームワークは、同じタイプのアトリビューションデータを返しましたが、詳細な情報はATTを通じて同意したユーザーにのみ提供されました。
• 新しいAdServicesフレームワークは詳細度は低いですが、すべてのユーザーにアトリビューションデータを提供します。

TealiumSwift SDKのバージョン2.9.0では、新しいアトリビューションモジュールを含め、iOS 14.3以降では新しいAdServicesを使用します。

2023年2月7日、Appleは旧iAdフレームワークの公式サポートを終了し、近日中にiOSから削除されると発表し、開発者に対してすべてのアプリとSDKから依存関係を削除するよう勧告しました。

TealiumSwift SDKのバージョン2.11.0では、Appleがサポートを終了したため、iAdフレームワークを完全に削除しました。今後は新しいAdServicesフレームワークのみを使用します。

お客様に対するサービスの中断を避けるため、AdServicesに含まれるすべてのデータは、旧iAdフレームワークの同じデータレイヤー変数にマッピングされます。 Appleから返されなくなったiAdのアトリビューションキーの一部を非推奨とします。iAdフレームワークが最終的にシャットダウンされる前にユーザーがそれらを受け取った場合、そのデータを引き続き受け取ることができますが、新規インストールには適用されません。

必要なアクション

お客様に必要なアクションは、TealiumSwift SDKのバージョン2.11.0以降に更新することだけです。このアクションにより、iAdフレームワークがアプリから削除され、新規インストールでは非推奨のアトリビューションキーのみをデータレイヤーから使用することが保証されます。非推奨のキーは空になります。

データレイヤー

モジュールが有効な間、以下の変数が各トラッキングコールで送信されます：

ad_で始まる変数は、Search Adsが有効になっている場合にのみ構成されます。