SKAdNetwork

SKAdNetworkは、アプリのインストールおよび再インストールのアトリビューションのための、Apple独自のアトリビューションフレームワークです。ユーザーレベルのデータにはアクセスできません。Appleはアトリビューションを行って、関連するアドネットワークに通知をします。その後、アドネットワークがデータとともにポストバックをAdjustに送信します。Adjustは連携する全てのアドネットワークからのデータを集計し、レポートします。

Adjust SDKはSKAdNetworkをサポートしており、デフォルトでサポートが有効に設定されています。つまり、SDKが初期化されると、AdjustはSKAdNetworkアトリビューションを自動的に記録し、コンバージョン値の更新を処理できるようになります。この機能をOFFにすることもできます。

SKAdNetworkのconversion value管理とイベントマッピングは、Adjustで簡単な手順で設定できます。その後、データキャンバスで集計データが確認できるようになります。あるいは、SKAdNetworkのローデータを収集してキャンペーン最適化に活用したり分析ができるようになります。これらの機能の詳細については、専用のガイドをご覧ください。

事前準備

事前準備として、以下の内容をご確認ください。

SDKの要件

この機能を利用するには、まずお使いのプラットフォーム用のAdjust SDKをダウンロードして設定してください。以下のリンク先の説明に従って、設定を開始してください。

この機能は、Adjust SDKバージョン4.23.0以降が要件となります。

⚙️ iOS / Unity / Cordova / Flutter / Titanium / Corona / Cocos2d-x / React Native

Adjust SDKの実装と設定が完了したら、以下のリンク先のガイドに従ってください。

📖 iOS / Unity / Cordova / Flutter / Titanium / Corona / Cocos2d-x / React Native

Adjustの要件

管理者、編集者およびカスタムの編集者ユーザー権限
Adjustは、アプリのSKAdNetwork機能を有効化するために、ユーザーのApp IDを確認しています。Adjust管理画面から確認をリクエストすることができます。

参考

SKAdNetworkは、お客様自身、あるいはAdjustを使って設定できます。Adjustを使う場合、管理画面から全てを制御でき、設定の変更にアプリコードを書き換える必要がありません。また、Adjustでconversion value（コンバージョン値）がどう表示されるかは、設定方法により異なります。
SKAdNetworkにアクセスするには、アドネットワークがAppleに登録していることが必要です。次に、開発者がAppleに登録されたネットワークとSKAdNetworkフレームワークとの互換性がアプリにあることを確認してください。

ヒント:

アプリの構築には、 Xcode の最新安定版を使用することを推奨します。

計測の仕組み

SKAdNetworkはApp Storeのダウンロードデータを活用してアトリビューションを実行します。デバイスレベルのデータ計測や共有はされず、また、SKAdNetworkのデータはAdjustの計測データと異なることにご留意ください。

インストールまたは再インストールの発生後、Appleの conversion value を使用してユーザーがトリガーしたアプリ内イベント（レベル突破や購入など）を特定できます。

以下に記載されている方法は、SKAdNetworkとconversion valueを管理してキャンペーンを最適化するためのAdjustのソリューションです。

Conversion value（コンバージョン値）とは？

Conversion valueは6ビットの値で、0と1のみを含む6つの数列からできています。6ビットの値は0〜63の64通りあります。

10進数	2進数	10進数	2進数	10進数	2進数	10進数	2進数
0	000000	16	010000	32	100000	48	110000
1	000001	17	010001	33	100001	49	110001
2	000010	18	010010	34	100010	50	110010
3	000011	19	010011	35	100011	51	110011
4	000100	20	010100	36	100100	52	110100
5	000101	21	010101	37	100101	53	110101
6	000110	22	010110	38	100110	54	110110
7	000111	23	010111	39	100111	55	110111
8	001000	24	011000	40	101000	56	111000
9	001001	25	011001	41	101001	57	111001
10	001010	26	011010	42	101010	58	111010
11	001011	27	011011	43	101011	59	111011
12	001100	28	011100	44	101100	60	111100
13	001101	29	011101	45	101101	61	111101
14	001110	30	011110	46	101110	62	111110
15	001111	31	011111	47	101111	63	111111

Conversion valueに関するアップデート

ユーザーが広告をクリックしてApp Storeからアプリをダウンロードし初回起動した時点で、Adjust SDKはSKAdNetworkを呼び出してアトリビューションを記録します。
タイマーが終了する前に特定のイベントがトリガーされた場合、conversion valueはその値に更新されます。その後タイマーがリセットされ、期間がさらに24時間延長されます。
conversion valueがアップデートされずに24時間が経過すると、別の最大24時間のタイマーがスタートします。このタイマーが終了する時、Appleはアトリビュートされたアドネットワークに最終的なconversion valueをポストバック送信します。その後、アドネットワークはこれをAdjustに転送します。

重要:

SKAdNetworkのアトリビューションデータがリアルタイムで共有されることはありません。メソッドが呼び出された時に有効化されるタイマーのため、インストール発生時からアトリビュートされたアドネットワークへのポストバックまでの間には、常に最短24時間の期間が発生します。

呼び出されるメソッド

メソッド	説明および手順
`registerAppForAdNetworkAttribution()`	広告がきっかけでインストールされたアプリの初回起動を検証します。 Appleのドキュメント
`updateConversionValue(_:)`	Conversion valueを更新し、広告がきっかけでインストールされたアプリの初回起動を検証します。 Appleのドキュメント

SKAdNetworkデータの受信

ネットワークはユーザーあたり1つのSKAdNetworkポストバックのみを受信します。これには最終かつ最大のconversion valueを含みます。SKAdNetworkポストバックを受信できるのはネットワークのみであること、また、これらをAdjustやアプリパブリッシャーに直接送信できないことにご留意ください。

Adjustがネットワークから受信するデータの詳細については、SKAdNetworkパートナー連携に関するページをご覧ください。

Adjustを使わずにSKAdNetworkを管理する

自社でSKAdNetworkを設定する場合は、以下の点にご注意ください。

アプリ開発者は、SKAdNetworkの registerAppForAdNetworkAttribution() メソッドをアプリ起動時に呼び出す必要があります。
開発者は、アプリ内のconversion valueをそれぞれ定義する必要があります。
Adjustはアドネットワークよりレポートされるconversion valueのみをレポートします。これはネットワークのペイロードに表示されるとおり、0〜63の値となります。

アドネットワークのペイロードの例

{
  "version" : "2.2",
"ad-network-id" : "com.example","campaign-id" : 42,
  "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id" : 525463029,
  "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1
  "conversion-value": 20
}