Languages 
  • English
  • 中文
  • 日本語

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

顧客がアプリを再ダウンロードおよび再インストールする場合のブーリアンフラグ

[true/false]

{sk_source_app_id}

広告を表示したアプリのアイテム識別子

注:Source app IDは、インストールされたアプリがそれを提供し、そのパラメーターの提供がAppleのプライバシー規定に準ずる場合にのみ表示されます。

{sk_conversion_value}

インストールされたアプリが提供する、未署名の6ビットの値

注:Conversion valueは、インストールされたアプリがそれを提供し、そのパラメーターの提供がAppleのプライバシー規定に準ずる場合にのみ表示されます。

{campaign_name}拡張SKAdNetworkポストバックで表示されるキャンペーン名
{adgroup_name}拡張SKAdNetworkポストバックで表示されるアドグループ名
{creative_name}拡張SKAdNetworkポストバックで表示されるクリエイティブ名
{tracker}6文字のAdjustトラッカートークン

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
}