他社SDKからAppsFlyerへのデバイス移行

アプリに実装するAppsFlyer SDKは、アプリとAppsFlyerプラットフォーム間のリンクの役割を果たします。アプリインストール、アプリ起動、アプリ内イベントなどを計測します。

AppsFlyer SDKを実装するには：

1. AppsFlyer SDKをアプリに実装します。
   AndroidとiOSのSDK実装ガイドを参照してください。
2. AppsFlyerのスキームを使用して記録したいアプリ内イベントをマッピングしてください。
   これは、SDKまたはS2Sを介して行うことができます。
3. 競合するアトリビューションベンダーのSDKを削除します。
   すぐに削除してAppsFlyerのみに切り替えるか、数週間両方のSDKで同時に計測することも可能です。以下の表でこれらのオプションの内訳をご覧ください。
   

   オプション	更新されたアプリバージョンを リリース後に起こること	影響
   他社SDKを削除（推奨）	AppsFlyerのみが、新規インストールと既存ユーザーを記録します。 他社SDKでは、ユーザーがアプリを更新するまで実行したイベントを記録します。	切り替えが素早く完了します。 重複計測無し
   移管期間中は 他社SDKも保持する	AppsFlyerと他社SDKは、それぞれ新規インストールとイベントを計測します。後日、他社SDKを削除してください。	データの検証が可能です。つまり、AppsFlyerと他のベンダーのデータを比較できます。 重複計測有り - アドネットワークで二重請求が発生する可能性があります。次の例を参照してください。 作業量がより多いです。

4. 作業範囲に含まれる他の全てのタスクが完了したあと、AppsFlyer SDKを含むアプリバージョンをアプリストアに更新します。新規ユーザーがAppsFlyerに計測されます。
   注：
   • iOS、Google Play、および関連する全てのAndroidの外部ストアのアプリを更新してください。
   • Androidアプリは、認識せずとも非公式のAPKサイトに存在している可能性があります（アプリのパッケージ名をウェブで検索して確認してください）。APKサイトは最新バージョンに更新するのに時間がかかるため、AppsFlyer SDKが実装されていない古いバージョンのアプリをインストールするオーガニックユーザーを生む可能性があります。
   • ストアでの更新版アプリの公開は、完全に完了するまでに数日かかる場合があります。この段階でインストールするユーザーは、以前のバージョンを引き続き使用できます。

デバイス移行とは、既存のユーザーデバイスID（IDFA、IDFV、GAID、CUID）のリストをAppsFlyerにアップロードする作業です。この処理は、AppsFlyer SDKを含む新しいアプリのバージョンをリリースする前に行う必要があります。デバイスを移行する際には、計測データ付き、または計測データを含まない移行の2つのオプションがあります。

デバイスの移行により、アプリを既にダウンロード済みで、以前のベンダーによって計測されている既存ユーザーに関連するデータの問題が解決します。例えば、SRNの二重課金は、以前のベンダーでSRNに成果が計測されていたユーザーが、まだルックバック期間内にいるにもかかわらず、AppsFlyerで再びSRNに請求された場合に発生します。

デバイスを移行すると、データは以下のようにAppsFlyerに反映されます。

• インストールデータ：再インストールと同様に、移行されたデバイスには、インストールデータが存在しません。移行されたデバイスのインストールデータは、AppsFlyerに表示されません。
• アプリ内イベントとセッションデータ：流入経路を含まないデバイス移行の場合は、オーガニックに紐づくデータとして記録・表示されます。また、流入経路を含むデバイス移行の場合は、メディアソースとキャンペーンに紐づくデータとして記録されます。
• リターゲティング： リアトリビューションとリエンゲージメントは通常どおり表示されます。
• アクティビティデータ：正常に表示されます。
• リテンションとコホートデータ：移行されたデバイスにはインストールの記録が存在しません。そのため、これらのユーザーはどのコホートにも属さないため、リテンションおよびコホートレポートには、データを表示できません。

デバイス移管を行うには： 

1. 移行するユーザーグループを決定します。全ての既存ユーザー (AppsFlyerから正確なリアトリビューションデータを取得できない場合があります)、または最近アプリをインストールしたユーザー (多少古いユーザーに関する計測料金が重複する可能性があります) を移行できます。
   現在のリアトリビューション期間中にアクティブなユーザーを移行することをお勧めします。たとえば、該当アプリにおいてリアトリビューション期間が90日で設定されている場合、過去90日間に少なくとも1回はセッション（起動）を行ったユーザーのデータを移行することをお勧めします。
2. [オプション] マーケティング担当者／UAマネージャに、デバイス移行が完了するまで、既存のマーケティングキャンペーン（SRN、非SRNアドネットワーク、オウンドメディアなど）を一時停止するように指示してください。キャンペーンを一時停止しない場合は、AppsFlyer SDKを実装したアプリバージョンがアプリストアにリリースされ次第、の故地のデバイスIDを他のベンダーから移行してください。 
3. 流入経路を含む、または流入経路を含まない移行方法のいずれかを使用して、移行するユーザーグループに関するCSVファイルを準備してください。サンプルCSVを見る
4. CSVファイルを担当のAppsFlyer CSMに送信します。
   担当CSMがデバイスIDをAppsFlyerに移行します。

この方法でAppsFlyerに移行したデバイスは、アプリ内イベント、セッションが記録され、以前の計測ベンダーが報告したメディアソース、およびアドネットワークのデータ保持ポリシーに従って表示されます。

流入経路を含む移行のCSVファイルの構成

CSVファイルのルール：

• このCSVファイルには複数アプリのユーザーデバイスデータを含めることができます(複数アプリでまとめて移行する際)。
• デバイスIDとアプリIDの同じ組み合わせを複数行に重複しないでください。重複している場合は、ファイル内で最後に出現したものが使用されます。
• すべての列ヘッダー (app_id, platform, device_id, id_type, install_time, media_source、integrated_partner, campaign, campaign_id) を含める必要があります。注：この項目の順序は重要であり、維持する必要があります。
• 同じデバイスにIDFVとIDFAの両方を追加することができますが、それらは別々の行にする必要があります。別々の行のフィールドは、device_idを除いてすべて同じでなければなりません。
• 各行には、カンマで区切られた９つのフィールドを含めてください。
• 必要ない項目の値は空 (blank) にしてください。
• 1ファイルにつき、最大2,000万行まで入力可能です。
• 複数ファイルになる場合には、ファイル毎に一意の名前をつけてください。
• UTF-8を使って、データをエンコードしてください。
• [任意] ZIPもしくはGZIPを使って、ファイルを圧縮してください。
  

サンプルCSVを見る

この方法でAppsFlyerに移行されたデバイスは、オーガニックユーザーとして記録されます（ただし、オーガニックユーザーとして表示はされません）。アプリ内イベントとセッションデータも記録され、オーガニック経由として表示されます。

流入経路を含まないデバイス移管のCSVファイルの構成

オプション	列	いつ使うか	例
1	App ID + IDFA/GAID/IDFV	すべてのAndroidユーザーがGAID識別子を持っている場合 iOSのみのユーザー
2	App ID + Device ID + Device ID type	Androidユーザーの一部がIMEIまたはAndroid IDのみを持ち、GAIDを持たない場合（第三者 (out-of-sotre) 以外のマーケットでは、Androidバージョンは4.4.2以下） Android IDは16進数形式である必要があります。 注意： ID type列には、advertiserId (amazon_aidもサポート), idfa, idfv, android_id, imei という正確な文字列を使用します。 android_id または imeiを使用していて、後日 AppsFlyer がより良い識別子を受取った場合、新しい計測結果が記録されることがあります。

CSVファイルのルール：

• このCSVファイルには複数アプリのユーザーデバイスデータを含めることができます(複数アプリでまとめて移行する際)。
• その場合には、ファイル内の各行にアプリ毎に１つの広告IDを入力する形になります。
• 選択したファイル構造オプションに応じて、ファイル列は次のように (リストされている順序で) なる必要があります：
  • オプション1： app_id,device_id
  • 選択肢２： app_id,device_id,id_type 
• App_IDは小文字で入力してください。
• Androidの各種IDもすべて小文字で入力してください。
• IDFA/IDFVはすべて大文字で入力してください。
• 1ファイルにつき、2,500万行まで入力可能です。

サンプルCSVを見る

SRNは、特定のデバイスのエンゲージメントについて照会されると、モバイル測定パートナー（MMP）に応答します。2つのMMP、たとえばAppsFlyerと競合するアトリビューションベンダーが同じデバイスのインストールについて同じSRNにクエリを実行すると、重複して料金が発生する可能性があります。

SRNキャンペーンを移行する方法：

• AppsFlyerにて、関連するSRNを有効にし設定を完了します。

アドネットワークの計測リンクは、ユーザーの広告エンゲージメントを記録しており、広告とのエンゲージメントが結果的にインストールに至った場合の計測に使用されます。

非SRNアドネットワークキャンペーンを移行する方法：

1. AppsFlyerにて、関連するアドネットワークを有効にします。
2. 各アドネットワークのAppsFlyer計測リンクを生成します。
3. 各キャンペーンの既存リンクをAppsFlyerの計測リンクに切り替えます。

オウンドメディアとは、以下の媒体で使用される計測リンクを指します。

• コンテンツ共有
• Web-to-app
• Email（メール）
• SMS
• ソーシャルメディアの投稿
• ブログ
• インターネットコミュニティ（Quoraなど）
• など、その他多くのメディア…

これらのキャンペーンでは、AppsFlyerはOneLinkカスタムリンクを使用します。OneLinkカスタムリンクは、ユーザーが使用するデバイスに基づいて、正しいアプリストア、インストール済みアプリ、またはWebページURL／ランディングページのいずれかにユーザーをリダイレクトします。

他のベンダーのリンクをAppsFlyer OneLinkに変更する方法：

• 担当カスタマーサクセスマネジャーまでお問合せください。全てのリンクを一括して移行するサポートを致します。

SKAdNetwork（SKAN）アトリビューションでは、1つのSDKのみがコンバージョン値を更新することができます。そうしないと、SKANのデータは意味をなさなくなってしまいます。そのため、移行後はAppsFlyer SDKのみがSKANコンバージョン値を更新するようにしてください。

AppsFlyerでのSKANコンバージョン値の設定について。

移行前は、現在のベンダーのレポート構造、項目、パラメーターなどに従って計測データがシステムに保存されています。AppsFlyerが正しくデータをレポートするためには、現在のレポート構造をAppsFlyerのレポート構造、項目、パラメーターに適応、マッピングする必要があります。

レポート構造を適応／マッピングする方法：

• Adjust、Branch/Tune、KochavaからAppsFlyerのレポート構造に、素早く適用／移行するためのサポートについて、担当のカスタマーサクセスマネジャーへお問い合わせください。

ローデータと集計レポートは、さまざまな方法でAppsFlyerから取得できます。それぞれの方法を理解し最適な方法を選択してください。

次のようなレポーティング方法があります。

• CSVファイルを抽出する
• Push API
• Pull API
• Data Locker