FireOS プッシュ統合
このリファレンス記事では、FireOS アプリケーションで Braze プッシュ通知を統合する方法について説明します。
プッシュ通知は、重要なアップデートが発生したときにユーザーの画面に表示されるアプリ外のアラートです。プッシュ通知は、時間的制約があって関連性の高いコンテンツをユーザーに提供したり、ユーザーをアプリに再エンゲージしたりするための効果的な方法です。
ADM (Amazon Device Messaging) は、Amazon 以外のデバイスではサポートされていません。Kindle プッシュをテストするには、[FireOS デバイス][32]が必要です。その他のベストプラクティスについては、[ヘルプの生地][8]を参照してください。
Braze は、[Amazon Device Messaging (ADM)][14] を使用して Amazon デバイスにプッシュ通知を送信します。
ステップ 1:ADM を有効にする
- まだ作成していない場合は、[Amazon Apps & Games Developer Portal][10] を使用してアカウントを作成します。
- [OAuth 認証情報 (クライアント ID とクライアントシークレット) と ADM API キー][11]を取得します。
- [Unity Braze 設定]ウィンドウで [自動 ADM 登録が有効] を有効にします。
- または、
res/values/braze.xml
ファイルに次の行を追加して、ADM 登録を有効にすることもできます。
1
| <bool name="com_braze_push_adm_messaging_registration_enabled">true</bool>
|
ステップ 2:AndroidManifest.xml を更新する
アプリの AndroidManifest.xml で、<>manifest</>
タグに Amazon の名前空間を追加します。
1
| xmlns:amazon="http://schemas.amazon.com/apk/res/android"
|
次に、<>permission</>
および<>uses-permission</>
要素を <>manifest</> element
の後に追加して、ADM をサポートするために必要な権限を宣言します。
```xml
...
```
次に、amazon:enable-feature
要素をマニフェストのアプリケーション要素に追加することで、アプリがデバイスの ADM 機能を使用すること、およびデバイスに ADM が存在しない状態でアプリが機能を維持するように設計されていること (android:required="false"
) を宣言します。android:required
を"false"
として設定しても安全です。これは、ADM がデバイスに存在しない場合、Braze ADM コードはグレースフルデグラデーションを行うためです。
```xml
…
...
\`\`\`
最後に、Braze `AndroidManifest.xml` ファイル内の ADM から `REGISTRATION` および `RECEIVE` インテントを処理するインテントフィルターを追加します。`amazon:enable-feature` の直後に、以下の要素を追加します。
\`\`\`xml
\`\`\`
## ステップ 3:ADM API キーを保存する
まず、ADM API キーを `api_key.txt` という名前のファイルに保存し、ファイルをプロジェクトの [`Assets/Plugins/Android/assets`][54] folder. Next, [アプリの ADM API キーを取得][11]します。
Amazon は、末尾の改行などの空白文字が `api_key.txt` に含まれている場合、キーを認識しません。
## ステップ 4:ディープリンクを追加する
#### ディープリンクの自動オープンを有効にする
プッシュ通知がクリックされたときに Braze がアプリとディープリンクを自動的に開くようにするには、`braze.xml` で `com_braze_handle_push_deep_links_automatically` を `true` に設定します。
```
true
```
ディープリンクをカスタムで処理する場合は、Braze からのプッシュ受信およびオープンインテントをリッスンするプッシュコールバックを作成する必要があります。詳細については、Android のプッシュに関するドキュメントの [カスタム処理のプッシュ受信およびオープン][52] を参照してください。
## ステップ 5:Braze ダッシュボードにクライアントシークレットとクライアントID を追加する
最後に、[ステップ 1][2] で取得したクライアントシークレットとクライアント ID を Braze ダッシュボードの [**設定の管理**] ページに追加する必要があります。
![][34]
## 手動プッシュ登録
Braze では手動登録の使用はお勧めしませんが、ADM 登録を自分で処理する必要がある場合は、[braze.xml][12] に次の内容を追加してください。
\`\`\`xml
false
```
Next, use [`Braze.setRegisteredPushToken()`](https://braze-inc.github.io/braze-android-sdk/kdoc/braze-android-sdk/com.braze/-braze/registered-push-token.html) to pass your user's ADM `registration_id` to Braze:
1
| Braze.getInstance(context).setRegisteredPushToken(registration_id);
|
1
| Braze.getInstance(context).registeredPushToken = registration_id
|
## ADM の extra
ユーザーは、[ディープリンク][29]、URL トラッキングなどのための `extras` として、Kindle プッシュメッセージでカスタムのキーと値のペアを送信できます。Android プッシュとは異なり、Kindle プッシュのユーザーは、`extra` キーと値のペアを定義するときに、Braze の予約キーをキーとして使用しないことがあります。
予約キーには以下が含まれます。
- `_ab`
- `a`
- `cid`
- `p`
- `s`
- `t`
- `ttl`
- `uri`
Kindle 予約キーが検出されると、Braze は `Status Code 400: Kindle Push Reserved Key Used` を返します。
[2]: #step-1-enable-adm
[8]: /docs/ja/developer_guide/platform_integration_guides/android/push_notifications/fireos/troubleshooting/
[10]: https://developer.amazon.com/public
[11]: https://developer.amazon.com/public/apis/engage/device-messaging/tech-docs/02-obtaining-adm-credentials
[12]: https://developer.amazon.com/public/apis/engage/device-messaging/tech-docs/03-setting-up-adm
[14]: https://developer.amazon.com/public/apis/engage/device-messaging
[29]: /docs/ja/developer_guide/platform_integration_guides/android/advanced_use_cases/deep_linking/
[32]: https://developer.amazon.com/appsandservices/apis/engage/device-messaging/tech-docs/04-integrating-your-app-with-adm
[34]: /docs/ja/assets/img_archive/fire_os_dashboard.png?725b1fd9d8208f4a861323e5fc16a376
[52]: /docs/ja/developer_guide/platform_integration_guides/android/push_notifications/android/integration/standard_integration/#android-push-listener-callback