基本のSDK実装ガイド

AppsFlyer IDは全ての新規アプリインストールに対して自動的に作成されます。広告主側でアクションの必要はありません。

この識別子を使用して、以下のアクションを実行することができます。

• サーバー間(S2S)イベントを送信するとき
• AppsFlyer IDを広告主側で持っているシステム上のユーザー情報と一致させる
• アプリ内イベントのローデータレポートをダウンロードし、appsflyer_id を使ってユーザーの行動とジャーニーを分析する

独自の顧客ユーザーID（CUID）をAppsFlyer SDKで設定することで、自社BIシステムのユニークIDをAppsFlyer IDや他の識別子と相互参照できるようになります。CUIDはAppsFlyerのローデータレポートで利用できます。また、ポストバックAPIでは、社内のIDとの相互参照に使用することができます。

CUIDの実装に関するディベロッパー向けガイドを参照してください。

Google Playインストールリファラー

Google PlayインストールリファラーAPI は、アトリビューションの精度を向上させ、インストールの不正から保護し、Google Play からのリファラデータ（例えばアプリが最初にインストールされたときのアプリバージョンなど）を安全に取得できます。 

Google Playインストールリファラー APIを追加するガイドをディベロッパーに共有してください。 

GAID

SDK V4.8.0以降、AppsFlyerは自動的にこのデバイス識別子を収集します。

AppsFlyerでは、Amazon、Opera、GetJar、Baidu、Huawei などのサードパーティからのインストールを計測することができます。これにより、Google Playを利用できないエリアでも多くのオーディエンスにリーチしてアプリを宣伝可能です。

AppsFlyerでは、サードパーティアプリストアの文脈において、以下のように計測をサポートしています：

• IMEI または Android ID：SDKは、IMEI または Android IDを自動的に収集しません。ただし、これらのIDを収集する必要がある場合（例えば、中国国内市場のアプリなど）、ディベロッパーは以下の収集タイプのいずれかを実装することができます。
  • 手動での収集：アプリはIMEIやAndroid IDをSDKに渡します（setImeiData または setAndroidIdData APIを使用）。SDKはデータをAppsFlyerサーバーに送信します。
  • デバイスIDの収集にオプトイン：SDKがIMEIまたはAndroid IDを強制的に収集します。
• OAID：サードパーティAndroidアプリストアからインストールを計測します。詳しくは、OAID実装ガイドを参照してください。
• インストールリファラ：SDKはSamsung GalleryとHuawei AppGalleryからのリファラデータの取得に対応しています。

背景

iOS 14.5以降、IDFAの収集にはアプリユーザーの同意が必要になります。実際には、IDFAへのアクセスはApp Tracking Transparency (ATT) のフレームワークによって管理されることを意味します。そのため、iOS14以降の端末においては、AppsFlyerのiOS SDKもATTのフレームワークを利用して端末のIDFAへのアクセスを得ることになります。 

ATTの概要については、ATTの基本仕様を参照してください。

IDFAを利用した計測が発生する場合には、IDFAが初回起動（first launch）のイベントとともに送信されることが重要になります。このため、AppsFlyer SDKでは waitForATTUserAuthorization という機能を提供しています。

waitForATTUserAuthorization について

waitForATTUserAuthorization を使用することで、ATTへの同意が完了するのを待って、AppsFlyerサーバーへデータ送信するのを延期する期間を設定することが可能です。

ユーザーがアプリを起動した時、ATTステータスは undetermined（未確定）の状態です。waitForATTUserAuthorization がタイムアウト中は、SDKはオフライン時のイベント計測方法と同様の方式で、起動イベントとその後のアプリ内イベントをメモリ内に待機させます。

• ユーザーがATTプロンプト(IDFAの収集)に同意 した場合：
  • SDKはメモリ内に待機させたイベントにもIDFAを追加します。
  • SDKは計測を開始し、メモリ内に待機させたイベントにIDFAを添えて、タイムアウトが終了するのを待たずに送信します。
• ユーザーがATTダイアログを拒否した場合：SDKは計測を開始し、メモリ内に待機させたイベントにIDFAを添えず、またタイムアウトが終了するのを待たずに送信します。
• タイムアウトが終了しATTの同意も得られなかった場合（notDetermined /未確定）：SDKは計測を開始し、メモリ内に待機させたイベントはIDFAの情報を追加せずに送信します。

注意事項

• waitForATTUserAuthorizationを設定せずにrequestTrackingAuthorizationを呼び出してしまうと、iOS14以降の端末ではIDFAを取得せずに起動とその後のアプリ内イベントを送信してしまうので注意してください。
• タイムアウト中にユーザーがアプリをバックグラウンドに移動した場合：
  • ユーザーが再度アプリを表示させる(フォアグラウンドに戻す)まで、タイマーが一時停止されます。
  • イベントはメモリ内にキャッシュされます。
• タイムアウト中にユーザーがアプリをシャットダウンまたは強制終了（=キル）した場合：
  • タイマーは、次回のアプリの起動時に再開されます。
  • キャッシュされたイベントは削除されます。

ATTの同意ダイアログをカスタマイズすることができます。ATTのダイアログでその目的を明確に示したメッセージを届けることは、ユーザーのオプトイン率を高めるのに役立ちます。

メッセージを作成するときには、以下のポイントに注意してください：

• アプリがユーザーの同意を求めている理由を、ユーザーにもっとも分かりやすく説明しているテキスト/単語を使用しましょう。
• データがどのように利用されるのかについてユーザーに知らせましょう。詳細はユーザーのプライバシーとデータの利用を参照してください。

メッセージが完成したら、開発担当者にそのテキストと実装ガイドを共有してください。

ATTダイアログの実装例を参照してください。

SKANは iOS で使用されるクラスで、広告主アプリのインストールを検証します。アプリのインストール検証プロセスには、ソースアプリ（≒広告配信面のアプリ）と広告主アプリが関係します。 

ソースアプリは、アドネットワークからの広告を表示することで広告キャンペーンに参加するアプリです。広告を表示できるようにアプリを設定することは、AppsFlyer SDKのサポート範囲ではありません。　設定する場合には、Appleのガイドに従ってください。

広告主アプリ (AppsFlyer SDKを実装しているアプリ) の場合、AppsFlyerの  SKANソリューションはSKANを使用してアトリビューションのポストバックを提供し、AppsFlyerはユーザーのプライバシーを維持しながらデータを収集、翻訳、集計します。アプリを初回起動すると、AppsFlyerはマーケティング担当者が事前に設定した内容を使用して、SKANのコンバージョン値の設定方法をSDKに指示します。

SKANソリューションの使用方法：

• マーケティング担当者は、AppsFlyerの管理画面上でSKANの計測に関する設定を行う必要がありますが、開発担当者は何も追加作業を行う必要はありません。
• AppsFlyer SDK は自動的に必要なSKAN APIを呼び出します。
• SKANの計測をAppsFlyerで実行する場合、他のSDKではSKANに関する呼び出しを全て無効にしてください。
• AppStoreにおいて、開発者、マーケティング担当者のどちらも、この他に何も特別なアクションや登録プロセスは必要ありません。 

SKANの計測を無効にするには、SDK内で無効にするように開発担当者へ依頼してください。

収益の情報は、どのアプリ内イベントでも送信できます。収益を計測する際には、必ず af_revenue のパラメータを使用していることを確認してください。これは、AppsFlyerが管理画面やローデータのレポートで実際の収益としてカウントする唯一のイベントパラメータです。詳細はこちらを参照してください。

開発担当者向けの手順については、収益の計測を参照してください。

AppsFlyerのSDKでは、アプリ内購入をサーバーにて検証できます。アプリ内購入を検証するとアプリ内イベントが自動的にAppsFlyerに送信されます。このイベントを別途送信すると、重複してイベントをレポートすることになるので注意してください。

旅行、ゲーム、Eコマースなど、業種ごとに推奨されるアプリ内イベントのリストを参照してください。

まだアプリをインストールしていないユーザーの場合、OneLinkはそのユーザーの端末の種類を判別して正しい遷移先 (GooglePlay、AppleのAppStore、サードパーティのアプリストア、もしくはウェブページ) へリダイレクトさせます。この挙動は予め設定されたOneLinkテンプレートの内容に基づきます。詳細はこちら

アプリを既にインストールしているユーザーの場合、OneLinkはアプリを起動します。また、アプリを開くだけでなく、アプリ内の特定のアクティビティやページへユーザーをディープリンクさせることも可能です。そのためには、開発者側でユニファイドディープリンク(UDL)を実装する必要があります。

注意：

• UDLの利用には、SDK V6.1以上の実装が必要です。
• なお、ディープリンクのためにOneLinkを既に使用しているお客様は、UDLではなく従来の方法を使用している可能性があります。

OneLinkでのディープリンク設定 のガイドを参照してください。

まだアプリをインストールしていないユーザーの場合、OneLinkはそのユーザーの端末の種類を判別し、GooglePlay、AppleのAppStore、サードパーティのアプリストア、もしくはウェブページへリダイレクトさせます。そのユーザーがアプリを初回起動した際に、ディファードディープリンクを使用して、アプリ内の特定のアクティビティやページにユーザーをリダイレクトさせることが可能です。

そのためには、開発者側でユニファイドディープリンク(UDL)を実装する必要があります。

注意：

• UDLの利用には、SDK V6.1以上の実装が必要です。
• なお、ディファードディープリンクのためにOneLinkを既に使用しているお客様は、UDLではなく従来の方法を使用している可能性があります。

OneLinkでのディファードディープリンクの設定に関するガイドを参照してください。