AppleのApp Clip実装ガイド

ディベロッパーがアプリのApp Clipを作成する方法については、Apple's App Clip guide for developersをご覧ください。

App Clipの使用方法と完全なアプリケーションとの連携を示す簡易サンプルアプリは、AppsFlyerのApp Clipガイドをご覧ください。

• AppsFlyerがApp Clipのクリック、インストール、アプリ内イベント、およびApp Clipから完全なアプリのインストールを計測するには、SDKが必要です。
• OneLinkは、SDK実装とは無関係にユーザーをリダイレクトします。

SDKをインストールし、完全アプリのSDKを設定する方法：

iOSディベロッパーに次のリンクを送信し、手順に従うように指示します。

• App ClipへのSDK実装
• App Clipから完全アプリのインストール計測に関する設定
• [オプション] 完全アプリの中でまたアプリ内イベントの測定をしていない場合、またはApp Clipで異なるアプリ内イベントを使用したい場合は、アプリ内イベントを設定します。

前提条件：

• 完全アプリ向けのユニバーサルリンク設定を持つOneLinkテンプレート。
• OneLinkリンク。
• 推奨：App Clipで使用するテンプレートとリンクの呼び出しは、通常のアプリを持たない全てのユーザーをApp Clipに送信します。そのため、ユーザーをApp ClipではなくApp Storeに誘導したい場合には、別の テンプレートとカスタムリンクを用意することを検討してください。

OneLinkテンプレート向けのApp Clipを設定する方法：

1. AppsFlyerの管理画面から、[エンゲージメント＆ディープリンク] > [OneLinkカスタムリンク] を開きます。
2. ユーザーを完全アプリにリダイレクトするために使用するOneLikテンプレートを選択します。
3. OneLinkテンプレートでユニバーサルリンクが設定してあることを確認します。（ユニバーサルリンクを追加するにはこの手順をご覧ください。）
4. [保存] をクリックします。
   AASAファイルが更新され、App Clipをサポートされます。
5. AppsFlyerの管理画面から、[エンゲージメント＆ディープリンク] > [OneLinkカスタムリンク] を開きます。
6. ステップ1~4で設定したテンプレートに基づいて、ユーザーをApp Clipに誘導するOneLinkカスタムリンクを選択します。
7. メディアソース (pid) が指定されていることを確認します。
   メディアソースはURLで指定されているか（例：pid=chartboost_int）、リンク内に含まれている必要があります。

App ClipがAppsFlyerのOneLinkで有効になっていることを確認する方法：

1. 関連ファイルを取得するURLを作成します。OneLinkテンプレートのドメインを取得してURLが作成され、次が追加されます： /.well-known/apple-app-site-association. 
   例： coffee.onelink.me/.well-known/apple-app-site-association
2. 関連ファイルのURLへ移動します。
   apple-app-site-association ファイルが自動的にダウンロードされます。
3. apple-app-site-association ファイルをテキストエディタ（例：Notepad）で開きます。
4. ファイルに 'appclips' という単語が含まれていること、バンドルID が ".Clip" で終わることを確認してください。
   例：
   

   "appclips": {
       "apps": [
         "ABCD1234.id.your.app.Clip",
         ...
       ]
   ...
   }

   そうであれば、AppsFlyer側でApp Clipを正常にセットアップし、同じサブドメインを持つ任意のOneLinkテンプレートにアプリケーションクリップが実装されます。

前提条件 : App Clip向けのOneLinkテンプレート設定が完了していること。

OneLinkでApp Clipが起動するように設定する方法：

1. App Store Connectのアプリページにて、Build > Domain Status へ進みます。
2. OneLinkドメインがBuild domains にて表示され、Cache status と Debug status が両方とも「validated」であることを確認します。
3. AppsFlyerの管理画面から、 [エンゲージメント＆ディープリンク] >  [OneLinkカスタムリンク] を開きます。
4. 使用したいリンクのアクションアイコンへマウスオーバーし、URLを取得をクリックします。
5. 短縮URL（または長いURLのプレフィックス）を記録します。
6. App Store Connectのアプリページで、App Clip > Edit Advanced Experiences > +Add > Next に移動します。
7. App Clip Experience URLにて、ステップ5で記録したOneLinkカスタムURLを貼り付けます。
   注：メインのカスタムURLの後にクエリパラメータを追加できますが、パスを変更することはできません。
8. [次へ] をクリックします。
   これで、App ClipがOneLinkで動作するように設定されました。App Store Connectの設定に関する詳細な手順は、Appleディベロッパーガイドをご覧ください。

前提条件 : iOS 14で、完全版アプリがインストールされていない登録済みのテストデバイス。

OneLink／App Clipの実装をテストする方法：

1. AppsFlyerの管理画面から、[エンゲージメント＆ディープリンク] > [OneLinkカスタムリンク] を開きます。
2. テストしたいリンクのアクションアイコンにカーソルを合わせ、URLを取得をクリックします。 
3. デバイスでQRコードをスキャンします。
   App Clip Cardがデバイスに表示されると、OneLink／App Clipが正しく実装されていることを示しています。