Huawei Cordova SDKセットアップ

​

概要

​

要件

• Android Studio
• 「Huawei App Gallery」がインストールされたHuaweiデバイス
• 構成されたOneSignal AppとPlatform

​

OneSignalアプリとプラットフォームを設定

OneSignalアプリを設定するためのステップバイステップの手順

単一のOneSignalアプリで複数のプラットフォーム（iOS、Android、Huawei、Amazon、Web）を管理できます。

1

アプリを作成または選択

• 既存のアプリにプラットフォームを追加するには、OneSignalダッシュボードでSettings > Push & In-Appに移動します。
• 新規に開始するには、New App/Websiteをクリックしてプロンプトに従います。

新しいアプリを作成する例

2

プラットフォームをセットアップして有効化

• アプリと組織の明確で認識可能な名前を選択します。
• 設定するプラットフォーム（iOS、Androidなど）を選択します。
• Next: Configure Your Platformをクリックします。

最初のOneSignalアプリ、組織、チャネルをセットアップする例

3

プラットフォーム認証情報を設定

プラットフォームに基づいてプロンプトに従います：

• Android：Firebase認証情報をセットアップ
• iOS：p8トークン（推奨）またはp12証明書
• Amazon：APIキーを生成
• Huawei：OneSignalを承認

認証情報を入力した後、Save & Continueをクリックします。

4

ターゲットSDKを選択

開発プラットフォーム（iOS、Android、React Native、Unityなど）に一致するSDKを選択し、Save & Continueをクリックします。

使用しているSDKを選択してドキュメントに移動

5

SDKをインストールしてApp IDを保存

プラットフォームが設定されると、OneSignal App IDが表示されます。このIDをコピーして保存してください - SDKのインストールと初期化時に必要になります。他のユーザーと共同作業する場合は、Inviteボタンを使用して開発者またはチームメイトを追加し、Doneをクリックしてセットアップを完了します。

App IDを保存して追加のチームメンバーを招待

完了したら、選択したプラットフォームのSDKインストールガイドに従って、OneSignalの統合を完了します。

​

セットアップ

​

1. OneSignal SDKをセットアップする

​

2. Huawei構成

​

追加の構成手順

​

Huawei位置情報サービス（オプション）

​

他のHMSプッシュライブラリまたは独自のHmsMessageServiceクラスとの互換性

• OneSignalに加えて、アプリに別のHMSプッシュSDK/ライブラリがある
• 独自のHmsMessageServiceがある

public class YourHmsMessageService extends HmsMessageService {
  public void onNewToken(String token) {
      // ...
      // Forward event on to OneSignal SDK
      OneSignalHmsEventBridge.onNewToken(this, token);
  }

  @Override
  public void onMessageReceived(RemoteMessage message) {
      // ...
      // Forward event on to OneSignal SDK
      OneSignalHmsEventBridge.onMessageReceived(this, message);
  }
}

<application>
    ...

    <!--
      Ensure you only have one intent-filter for "com.huawei.push.action.MESSAGING_EVENT".
      HMS only supports one per app.
    -->
    <service
        android:name=".YourHmsMessageService"
        android:exported="false">
        <intent-filter>
            <action android:name="com.huawei.push.action.MESSAGING_EVENT" />
        </intent-filter>
    </service>

    ...
</application>

​

Huaweiトラブルシューティング

E/OneSignal: HMS ApiException getting Huawei push token!
    com.huawei.hms.common.ApiException: -5: Core error

​

OneSignal SDK統合のテスト

​

モバイルサブスクリプションを確認

1

テストデバイスでアプリを起動します。

初期化時にrequestPermissionメソッドを追加した場合、ネイティブのプッシュ許可プロンプトが自動的に表示されます。

iOSとAndroidのプッシュ許可プロンプト

2

OneSignalダッシュボードを確認

プロンプトを受け入れる前に、OneSignalダッシュボードを確認してください：

• Audience > Subscriptionsに移動します。
• ステータスが「Never Subscribed」の新しいエントリが表示されるはずです。

「Never Subscribed」ステータスのサブスクリプションを表示するダッシュボード

3

アプリに戻り、プロンプトで「許可」をタップします。

4

OneSignalダッシュボードのSubscriptionsページを更新します。

サブスクリプションのステータスがSubscribedと表示されるはずです。

「Subscribed」ステータスのサブスクリプションを表示するダッシュボード

モバイルサブスクリプションの作成に成功しました。 モバイルサブスクリプションは、ユーザーがデバイスで初めてアプリを開いたとき、またはユーザーが同じデバイスでアプリをアンインストールして再インストールしたときに作成されます。

​

テストサブスクリプションをセットアップ

1

Test Subscriptionsに追加します。

ダッシュボードで、サブスクリプションの横にある**Options（3つのドット）**ボタンをクリックし、Add to Test Subscriptionsを選択します。

デバイスをTest Subscriptionsに追加

2

サブスクリプションに名前を付けます。

Test Subscriptionsタブで後でデバイスを簡単に識別できるように、サブスクリプションに名前を付けます。

「Name your subscription」フィールドを表示するダッシュボード

3

テストユーザーセグメントを作成します。

Audience > Segments > New Segmentに移動します。

4

セグメントに名前を付けます。

セグメントにTest Usersという名前を付けます（この名前は後で使用されるため重要です）。

5

Test Usersフィルターを追加し、Create Segmentをクリックします。

Test Usersフィルターを使用して「Test Users」セグメントを作成

テストユーザーのセグメントの作成に成功しました。 この個別のデバイスとテストユーザーのグループにメッセージを送信するテストが可能になりました。

​

API経由でテストプッシュを送信

1

App API KeyとApp IDを取得します。

OneSignalダッシュボードで、**Settings > Keys & IDs**に移動します。

2

提供されたコードを更新します。

以下のコードのYOUR_APP_API_KEYとYOUR_APP_IDを実際のキーに置き換えます。このコードは、先ほど作成したTest Usersセグメントを使用します。

Copy

Ask AI

curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

3

コードを実行します。

ターミナルでコードを実行します。

4

画像とConfirmed Deliveryを確認します。

すべてのセットアップ手順が正常に完了した場合、テストサブスクリプションは画像を含む通知を受信するはずです：

iOSとAndroidで画像付きプッシュ通知

画像は折りたたまれた通知ビューでは小さく表示されます。通知を展開すると、完全な画像が表示されます。

5

Confirmed Deliveryを確認します。

ダッシュボードで、Delivery > Sent Messagesに移動し、メッセージをクリックして統計を表示します。confirmed統計が表示されるはずです。これは、デバイスがプッシュを受信したことを意味します。

Confirmed Deliveryを示す配信統計

Professionalプラン以上をご利用の場合は、Audience Activityまでスクロールして、サブスクリプションレベルの確認を表示します：

Audience Activityでのデバイスレベルでの Confirmed Delivery

API経由でセグメントに通知を送信することに成功しました。

• 画像が受信されない場合は、Notification Service Extensionが不足している可能性があります。
• Confirmed Deliveryがない場合は、こちらのトラブルシューティングガイドを確認してください。
• 問題が発生した場合は、APIリクエストとアプリ起動の最初から最後までのログを.txtファイルにコピー&ペーストしてください。その後、両方をsupport@onesignal.comと共有してください。

​

アプリ内メッセージを送信

1

デバイスでアプリを閉じるか、バックグラウンドにします。

これは、ユーザーが新しいセッションを開始する_前_にアプリ内オーディエンスの基準を満たす必要があるためです。OneSignalでは、ユーザーがアプリをバックグラウンドまたは閉じた状態から少なくとも30秒後に開くと、新しいセッションが開始されます。詳細については、アプリ内メッセージの表示方法に関するガイドを参照してください。

2

アプリ内メッセージを作成します。

• OneSignalダッシュボードで、Messages > In-App > New In-Appに移動します。
• Welcomeメッセージを見つけて選択します。
• Audienceを、以前使用したTest Usersセグメントに設定します。

「Test Users」セグメントをアプリ内メッセージでターゲティング

3

必要に応じてメッセージコンテンツをカスタマイズします。

アプリ内Welcomeメッセージのカスタマイズ例

4

トリガーを「On app open」に設定します。

5

頻度をスケジュールします。

**Schedule > How often do you want to show this message?**で、Every time trigger conditions are satisfiedを選択します。

アプリ内メッセージのスケジュールオプション

6

メッセージをライブにします。

Make Message Liveをクリックして、Test Usersがアプリを開くたびにメッセージが利用できるようにします。

7

アプリを開いてメッセージを確認します。

アプリ内メッセージがライブになったら、アプリを開きます。次のように表示されるはずです：

デバイスに表示されたWelcomeアプリ内メッセージ

メッセージが表示されない場合：

• 新しいセッションを開始します
  • 再度開く前に、少なくとも30秒間アプリを閉じるかバックグラウンドにする必要があります。これにより、新しいセッションが開始されます。
  • 詳細については、アプリ内メッセージの表示方法を参照してください。
• まだTest Usersセグメントに含まれていますか？
  • アプリを再インストールしたりデバイスを切り替えたりした場合は、デバイスをTest Subscriptionsに再度追加し、Test Usersセグメントの一部であることを確認してください。
• 問題が発生していますか？
  • 上記の手順を再現しながらデバッグログの取得に従ってください。これにより、support@onesignal.comと共有できる追加のログが生成され、何が起こっているかを調査するのに役立ちます。

​

ユーザー識別

​

External IDを割り当て

​

データタグを追加

"current_level"というタグが"6"に設定されたOneSignalのユーザープロファイル

current_level値が4より大きく10より小さいユーザーをターゲットとするセグメントを示すセグメントエディター

パーソナライズされたメッセージでLevel 5-10セグメントをターゲットとするプッシュ通知を示すスクリーンショット

パーソナライズされたコンテンツを含むプッシュ通知がiOSおよびAndroidデバイスで受信されます

​

メールおよび/またはSMSサブスクリプションを追加

• addEmailメソッドを使用してメールサブスクリプションを作成します。
• addSmsメソッドを使用してSMSサブスクリプションを作成します。

External IDによって統合されたプッシュ、メール、SMSサブスクリプションを持つユーザープロファイル

​

プライバシーとユーザー同意

• setConsentRequired(true)：同意が与えられるまでデータ収集を防ぎます。
• setConsentGiven(true)：同意が付与されるとデータ収集を有効にします。

• SDKによって収集されるデータ
• 個人データの取り扱い

​

プッシュ許可のプロンプト

​

プッシュ、ユーザー、アプリ内イベントをリッスン

​

プッシュ通知イベント

• addClickListener()：通知がタップされたときを検出します。ディープリンクに役立ちます。
• addForegroundLifecycleListener()：フォアグラウンドでの通知の動作を制御します。

​

ユーザー状態の変更

• ユーザー状態用のaddObserver()：External IDが設定されたときを検出します。
• addPermissionObserver()：ネイティブのプッシュ許可プロンプトとのユーザーの特定のインタラクションを追跡します。
• プッシュサブスクリプション用のaddObserver()：プッシュサブスクリプションのステータスが変更されたときを追跡します。

​

アプリ内メッセージイベント

• addClickListener()：アプリ内クリックアクションを処理します。ディープリンクやイベントの追跡に最適です。
• addLifecycleListener()：アプリ内メッセージの完全なライフサイクル（表示、クリック、閉じるなど）を追跡します。

​

高度なセットアップと機能

• 🔁 別のサービスからOneSignalへの移行
• 🌍 位置情報トラッキング
• 🔗 ディープリンク
• 🔌 統合
• 🧩 Mobile Service Extensions
• 🛎️ アクションボタン
• 🌐 多言語メッセージング
• 🛡️ Identity Verification
• 📊 カスタムアウトカム
• 📲 Live Activities

​

Mobile SDKのセットアップとリファレンス