属性モジュール

使用法

属性モジュールは、トラッキングコールごとにユーザーがリセット可能な広告識別子（IDFA）を追加し、オプションでApple Search Ads APIを実装して属性情報を収集します。Apple Search Adsの属性構成について詳しくはこちらをご覧ください。

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

このモジュールの使用は任意です。機能について詳しく読んで必要かどうかを判断してください。なぜなら、追加の依存関係が導入されるため、アプリを提出する際にAppleにIDFAの使用理由を説明する必要があります。IDFAの使用を宣言しない場合、Appleはアプリを拒否します。IDFAの使用と拒否について詳しくはこちらをご覧ください。

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

• iOS

必要条件

• UIKit
• AdSupport
• iAd
• iOS 14以上：AppTrackingTransparency
• iOS 14以上：StoreKit

インストール

AttributionモジュールをSwift Package Manager、CocoaPods、またはCarthageでインストールします。

Swift Package Manager（推奨）

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

1. Xcodeプロジェクトで、「ファイル」>「Swift Packages」>「パッケージの依存関係を追加」を選択します。
2. リポジトリのURLを入力します：https://github.com/tealium/tealium-swift
3. バージョンルールを構成します。通常は、「次のメジャーバージョンまで」が推奨されます。現在のTealium Swiftライブラリのバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
4. Xcodeプロジェクトの各アプリのターゲットのFrameworks > Libraries & Embedded Contentの下にあるリストからAttributionモジュールを選択して追加します。

iOS向けのSwift Package Managerのインストールについて詳しくはこちらをご覧ください。

CocoaPods

CocoaPodsを使用してAttributionモジュールをインストールするには、次のポッドをPodfileに追加します：

pod 'tealium-swift/Attribution'

iOS向けのCocoaPodsのインストールについて詳しくはこちらをご覧ください。

Carthage

Carthageを使用してAttributionモジュールをインストールするには、次の手順に従います：

1. Xcodeのアプリのターゲットの一般構成ページに移動します。

2. 埋め込みバイナリセクションに次のフレームワークを追加します：

   TealiumAttribution.framework
   

iOS向けのCarthageのインストールについて詳しくはこちらをご覧ください。

初期化

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

config.collectors = [Collectors.Attribution]

必要なコレクターを正しく指定する方法については、Collectorsのドキュメントを確認してください。

iOS 14以降の属性

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

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

AppleのIDFAの変更がTealiumに与える影響について詳しくはこちらをご覧ください

AppTrackingTransparency（ATT）

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

該当する場合は、ATTrackingManager.requestTrackingAuthorizationを別途呼び出してください。Tealium SDKを有効にするためのトラッキング許可のリクエストについて詳しくはこちらをご覧ください。

SKAdNetwork

config.skAdAttributionEnabledがtrueに構成されている場合、Tealiumは起動時に自動的に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を含みますが、ユーザーやデバイス固有のデータは含まれません。ポストバックには、コンバージョン値とソースアプリのIDが含まれる場合があります。これは、Appleが値の提供がAppleのプライバシーの基準を満たすと判断した場合です。

広告によるアプリのインストールについて詳しくはこちらをご覧ください。

Tealiumの役割

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

1. 広告ネットワーク
2. ソースアプリ
3. 広告されたアプリ

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

さらに、skAdConversionKeysを定義している場合、SKAdNetwork.updateConversionValue(_:)メソッドが呼び出され、指定されたコンバージョン値が渡されます。Tealiumを使用すると、既に構成されているトラッキングを介してSKAdNetworkへの呼び出しを管理できます。

ユーザーにトラッキングの許可をリクエストし、適切なキーを.plistファイルに追加する必要がある場合があります。

次の図は、TealiumがSKAdNetworkと連携する方法を示しています：

検証

SKAdNetworkへの呼び出しを検証する方法については、インストール検証ポストバックの検証を参照してください。

Search Ads API

Apple Search Ads APIを使用するには、TealiumConfigオブジェクトのsearchAdsEnabledプロパティを有効にします。次に、iAdフレームワークを使用して、属性オブジェクトを含む属性辞書を取得します。Tealiumライブラリはアプリの起動時にこれを行いますが、情報がタイムリーに取得されない場合があります。情報は通常、起動イベント中にAppleから受け取った後にデータレイヤーに追加されます。

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

データレイヤー

モジュールが有効な場合、各トラッキングコールと共に次の変数が送信されます：

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