言語 ▼
さらに見る ▼

SKAdNetwork

SKAdNetworkは、アプリのインストールおよび再インストールのためのApple独自のアトリビューションフレームワークです。Appleはアトリビューションを実行し、関連するアドネットワークに通知をします。その後、アドネットワークがデータとともにコールバックをAdjustに送信します。

AdjustによるSKAdNetworkフレームワーク向けのサポート機能で、SKAdNetworkのコンバージョンおよびイベントマッピングを簡単に設定できます。さらに、SKAdNetworkのローデータを集計し、キャンペーン最適化のためにデータ分析に活用することもできます。

事前準備

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

要件​

参考​

  • SKAdNetworkは、お客様自身、あるいはAdjustを使って設定できます。Adjustを使う場合、管理画面から全てを制御でき、設定の変更にアプリコードを書き換える必要がありません。また、Adjustでconversion value（コンバージョン値）がどう表示されるかは、設定方法により異なります。

計測の仕組み

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

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

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

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

最小：000000[0]
最大：111111 [63]

registerAppForAdNetworkAttribution() メソッドは、アプリ起動時に呼び出されます。これにより、リセット可能な24時間のタイマーがスタートします。このタイマーが終了する前に updateConversionValue(_:) メソッドが呼び出された場合（ユーザーが特定のイベントをトリガーした場合など）、conversion valueはより大きな値に変わります。その後タイマーがリセットされ、期間がさらに24時間延長されます。

conversion valueがアップデートされずに24時間が経過すると、別の最大24時間のタイマーがスタートします。このタイマーが終了する時、Appleはアトリビュートされたアドネットワークに最終的なconversion valueをポストバック送信します。

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

AdjustでSKAdNetworkを管理する

Adjustでは、conversion valueのアップデートをトリガーするイベントを最大6つ選択できます。これらのカスタムイベントは1度だけマッピングをすることができます。

マッピングされたイベントがトリガーされると、Adjust SDKはそれをトラッキングして、Adjustのバックエンドに送信します。つぎに管理画面のイベントマッピングに読み込まれ、対応するconversion valueを返します。このconversion valueは、SDKがupdateConversionValue(_:) メソッドを呼び出すのに使用します。

AdjustはアドネットワークからAppleのポストバックデータを受け取り、conversion valueを解読して、レポートに実際のイベントを反映させます。

このプロセスは以下のようになります。

Adjustのイベントトークンをアプリに追加する

SKAdNetworkで計測したいイベントを最大6つ選択します。Adjustは各イベントをトリガーしたユーザー数をレポートしますが、ユーザーが1イベントを何回トリガーするかは計測できません。

重要：​ SKAdNetworkは、インストールされたアプリがconversion valueを提供し、さらにAppleのプライバシー規定に準ずる場合にのみイベントのconversion valueを共有します。

選択したイベントは、管理画面ですでに設定したイベントである必要があります。既存イベントも使えますが、新規イベントを設定したい場合は、基本的なイベント設定手順をご覧ください。新規イベントを設定する際、イベントトークンをアプリに追加するよう開発者に依頼してください。

Conversion valueのイベントマッピングを設定する

AdjustでSKAdNetworkのconversion valueのイベントマッピングを設定するには、以下の手順に従って下さい。

  1. 該当アプリの下部に表示されている（▲）ボタンを選択します。
  2. その他の設定 (All Settings) > iOS 14サポート (iOS 14 support) > SKAdNetworkの設定 (SKAdNetwork settings)​ を選択します。
  3. Conversion valueの管理 (Conversion value management) を ON​ にします。
  4. 最大6つのイベントを追加します
  5. 保存（SAVE）を選択します。

設定が完了しました。AdjustはSKAdNetworkのconversion valueを管理し、これらをイベントにマッピングするようになります。

SKAdNetworkの集約データを閲覧する

Adjust データキャンバスで集計されたSKAdNetworkデータを確認できます。この機能の使い方の詳細については、専用のAdjust データキャンバスガイドをご覧ください。

SKAdNetworkのためのローデータエクスポートの設定

SKAdNetworkのアトリビューションのアップデートをローデータ転送するには、専用のアクティビティタイプである、 SKAdNetwork​ を使用します。このデータは、グローバルコールバックにデフォルトでは含まれていないことにご注意下さい。

データエクスポートの方法に合わせて、以下のプレースホルダーを使用してCSVの定義またはコールバックURLをアップデートします。Appleは2つのバージョンのインストール検証ポストバックを使用することにご注意下さい。

  • ソースアプリがiOS 14未対応版のSDKを使用している場合、または、広告の対象となるアプリがiOS 14以前の場合は、バージョン1が使用されます。

Appleからアドネットワークへのポストバックで渡されるパラメーターについての詳細、さらにそれらのパラメーターが異なるバージョンで使用可能かどうかを確認するには、Appleのドキュメントをご覧下さい。

プレースホルダー定義
{sk_ts}元のポストバックをアドネットワークが受信した時間を示すUNIXタイムスタンプ（秒数）
{sk_payload}Appleから受け取った完全なSKAdNetworkペイロード（URLエンコード済み）
{sk_version}アドネットワークに送信されたポストバックのバージョン
{sk_network_id}アドネットワークの識別子
{sk_campaign_id}広告を表示する際に付与されるキャンペーンID
{sk_transaction_id}検証のための一意の値。インストール検証のメッセージの重複排除に使用
{sk_app_id}広告の対象となる製品のアイテム識別子
{sk_attribution_signature}Appleのアトリビューションシグネチャー
{sk_invalid_signature}アドネットワークからのSKAdNetworkのインストールポストバックの検証

無効なポストバックについての場合、1の値が返されます。有効なポストバックの場合、0の値が返されます。
{sk_redownload}顧客がアプリを再ダウンロードおよび再インストールする場合のブーリアンフラグ

[true/false]
{sk_source_app_id}広告を表示したアプリのアイテム識別子

注：Source app IDは、インストールされたアプリがそれを提供し、そのパラメーターの提供がAppleのプライバシー規定に準ずる場合にのみ表示されます。
{sk_conversion_value}インストールされたアプリが提供する、未署名の6ビットの値

注：Conversion valueは、インストールされたアプリがそれを提供し、そのパラメーターの提供がAppleのプライバシー規定に準ずる場合にのみ表示されます。
{network_name}拡張SKAdNetworkポストバックで表示されるネットワーク名
{campaign_name}拡張SKAdNetworkポストバックで表示されるキャンペーン名
{adgroup_name}拡張SKAdNetworkポストバックで表示されるアドグループ名
{creative_name}拡張SKAdNetworkポストバックで表示されるクリエイティブ名
{tracker}6文字のAdjustトラッカートークン
{ip_address}SKAdNetworkのポストバックで表示されるデバイスのIPアドレス
{user_agent}SKAdNetworkのポストバックで受信するユーザーエージェントのローデータ

パートナー連携

AdjustはSKAdNetworkのデータを取得するためのパートナー連携をサポートしています。パートナーによっては内部制限が原因でSKAdNetworkの全セットのデータをAdjustに送信できません。つまり、いくつかのデータがAdjustデータキャンバスやローデータ転送にて提供されない場合があります。

サポートしているパートナー連携：

  • Appier
  • IronSource
  • Lifestreet
  • Liftoff
  • Smadex
  • Tapjoy
  • Unicorn
  • Vungle

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

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

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

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

{
 "version" : "2.0",
 "ad-network-id" : "com.example",
 "campaign-id" : 42,
 "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
 "app-id" : 525463029,
 "attribution-signature" : "MDYCGQD0AdGn5gUnSuVGk8Wi0IgxzWiKdBzwJrQCGQCJfkrI5bda93EC4Xm1H+MtNxstFmnVBn0="
 "redownload": true,
 "source-app-id": 1234567891
 "conversion-value: 20
}