Android 初期設定

概要：アプリの初期設定では、既存のアプリユーザーを直接アプリに遷移させるためのリンクをマーケティング担当者が作成できます。また、初期設定はディープリンクとディファードディープリンクの前提となるものです。

アプリ起動メソッド

ユーザーベースを十分に網羅するためには、実装する必要のあるアプリ起動メソッドは2つあります。使用する方法は、モバイルプラットフォームのバージョンによって異なります。

この2つの方法と実装方法については、次のセクションで詳しく説明します。

メソッド	詳細	Androidバージョン	手順
Androidアプリリンク	モバイルアプリをデフォルトのアクティビティで直接開きます。	Android V6+	SHA256フィンガープリントを生成します。メインアクティビティにintent-filterを追加します。
URIスキーム	URIスキームで指定されたアクティビティパスに基づいて、アプリを直接開きます。	Android全バージョン	マーケティング担当者と一緒にURIスキームを決めてください。メインアクティビティにintent-filterを追加します。テスト

Androidアプリリンク向けの手順

Android App LinksはAndroid 6.0以上で機能します。詳細はこちら

Generating a SHA256 fingerprint while in development

Locate your app's keystore.
If the app is in still in development, locate the debug.keystore
- Windowsユーザーの場合： C:\Users\USERNAME\.android\debug.keystore
- LinuxまたはMac OSユーザーの場合： ~/.android/debug.keystore
コマンドラインを開いて、keystore ファイルが配置されたフォルダに移動してください。
次のコマンドを実行してください：

// keytool -list -v -keystore <<KEY_STORE_FILE>>
// For example, the default keystore file 
keytool -list -v -keystore ~/.android/debug.keystore

🚧
debug.keystoreのパスワードは通常、「android」です。

次のように出力されます。

Alias name: test
Creation date: Sep 27, 2017
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=myname
Issuer: CN=myname
Serial number: 365ead6d
Valid from: Wed Sep 27 17:53:32 IDT 2017 until: Sun Sep 21 17:53:32 IDT 2042
Certificate fingerprints:
MD5: DB:71:C3:FC:1A:42:ED:06:AC:45:2B:6D:23:F9:F1:24
SHA1: AE:4F:5F:24:AC:F9:49:07:8D:56:54:F0:33:56:48:F7:FE:3C:E1:60
SHA256: A9:EA:2F:A7:F1:12:AC:02:31:C3:7A:90:7C:CA:4B:CF:C3:21:6E:A7:F0:0D:60:64:4F:4B:5B:2A:D3:E1:86:C9
Signature algorithm name: SHA256withRSA
Version: 3
Extensions:
#1: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
  KeyIdentifier [
   0000: 34 58 91 8C 02 7F 1A 0F  0D 3B 9F 65 66 D8 E8 65 
   0010: 74 42 2D 44                    
 ]
]

SHA256をマーケティング担当者に送り返してください。

Generating a SHA256 fingerprint while in production

The SHA256 fingerprint is generated in

In Google Play console Find the public SHA256 fingerprint in Setup -> App signing (see image below)

Google Play SHA256 cert!

SHA256をマーケティング担当者に送り返してください。

Adding App Link intent-filter to main activity

自動生成されたintent-filterコードをマーケターから取得します。intent-filterコードはAndroidManifest.XMLで使用されます。
Open the app's AndroidManifest.xml file.
main activity にintent-filter を追加してください。
メインアクティビティに既にAndroidアプリリンク用の intent-filter が存在する場合、それを上書きしてください。

例

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data
        android:host="onelink-basic-app.onelink.me"
        android:scheme="https" />
</intent-filter>

ℹ️
条件 android:autoVerify="true" intent-filter のいずれかに {0} が存在する場合、Android 6.0以上の端末にアプリをインストールすると、アプリのintent-filter に含まれるURLに関連するすべてのホストの検証が試みられます。Androidは、上記のインテントフィルターで見つかったユニークなホスト名ごとに、{0}にあるDigital Asset Linksファイルの対応するWebサイトに問い合わせます。 https://hostname/.well-known/assetlinks.json. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer creates and hosts this path for you.
Learn more

Githubリンク：XML

マーケティング担当者にアプリリンクの設定が完了したことを伝えてください。
マーケティング担当者がリンクをテストする際に、ユーザーはアプリのメインページに誘導されるべきです。

URIスキームの手順

URIスキームとは、ユーザーを直接モバイルアプリに誘導するURLです。

アプリユーザーがブラウザのアドレスバーボックスにURIスキームを入力したり、URIスキームに基づくリンクをクリックしたりすると、アプリが起動し、ユーザーはディープリンクされます。

アプリリンクでアプリが開けないときは、そのURIスキームをフォールバックとして使用しアプリを開くことができます。

Deciding on a URI scheme

URIスキームを決定する方法：

Contact the marketer.
URIスキームを選択します。例： yourappname://
ℹ️
- エコシステム内の他のアプリとの重複を避けるために、アプリやブランドにできるだけユニークな URI スキームを使用します。他のアプリとの重複は、URI スキームプロトコルの性質上の本質的な問題です。
- URI スキームは、httpまたは httpsで始まらないようにしてください。
- URIスキームは、AndroidとiOSで同様に定義する必要があります。
URIスキームをマーケティング担当者に渡します。
例： afshopapp://mainactivity

Adding URI scheme intent-filter to the main activity

メインアクティビティにintent-filter を追加する方法：

Open the app's AndroidManifest.xml file.
Add the following intent-filter to the main activity.
In the data section, replace host and scheme with the URI scheme you chose. In the intent-filter code below, host="mainactivity" and scheme="afshopapp", matching the URI scheme afshopapp://mainactivity.
If there already is an intent-filter for the URI scheme in the main activity, overwrite it.

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data
        android:host="mainactivity"
        android:scheme="afshopapp" />
</intent-filter>

⇲ Github リンク：XML

URIスキームをマーケティング担当者に渡してください。

Testing URI schemes

前提条件：

アプリがインストールされているAndroid端末をご用意ください。
App LinksやURIスキームが実装されたアプリのソースとバージョンであることを確認してください。

URIスキームをテストする方法：

マーケティング担当者に連絡し、彼らが作成したカスタムリンクを取得してください。
マーケティング担当者から取得したショートまたはロングURLを自分の携帯電話に送信してください。次のいずれかを実行できます：
- お使いの携帯電話のカメラまたは QR スキャナーアプリで QR コードをスキャンします。
- リンクを自分宛てにメールまたはWhatsAppで送信し、自分の端末で開きます。
モバイル端末でリンクをクリックします。
アプリのホーム画面が開くはずです。