メインコンテンツへスキップ
プッシュ通知アイコンは、プッシュ通知に付随する小さな画像で、ブランド認識、コンテキストの明確さ、美的魅力を支援します。ユーザーエンゲージメントと通知の効果を高めるために重要です。

​
プッシュ通知アイコンのベストプラクティス

  • すべてのデバイスでより良いレンダリングのために透明なPNGを使用します。
  • アイコンが小さなサイズで単純で認識可能であることを確認してください。
  • サイズと配色に関するプラットフォーム固有のガイドラインに従います（たとえば、Androidステータスバーの透明な背景の白いアイコン）。
  • アイコンにテキストを含めることは避けてください。小さなサイズでは読めなくなる可能性があります。
  • よくデザインされたプッシュ通知アイコンを含めることで、通知の効果と魅力を大幅に向上させることができます。

​
Web通知アイコン

推奨サイズは256x256ピクセルです。ファイルタイプPNG、JPG、およびGIF（アニメーション化されていない）がサポートされています。 ダッシュボードWeb設定でアイコンをアップロードするか、画像へのURLを使用します。

​
iOS通知アイコン

iOS通知はアプリアイコンと同じ画像を使用し、アプリアイコンを変更しない限り変更できません。 iOSは、アイコンをユーザーのプロフィール画像に変更できる通信通知もサポートしています。

​
Android通知アイコン

Android（AmazonとHuaweiを含む）は、このガイドで詳しく説明するアイコンを設定するためのいくつかのオプションを提供します。 Androidは、アイコンをユーザーのプロフィール画像に変更できる会話通知もサポートしています。 Androidは、小さい通知アイコンと大きい通知アイコンの両方をサポートしています。

​
小さい通知アイコン

小さいアイコンは通知の左上に表示されます。デフォルトでは、OneSignalはベルアイコンを表示しますが、サブスクライバーがアプリからの通知であることを認識できるようにカスタマイズすることをお勧めします。
**ほとんどのAndroidデバイスはアイコンのアルファチャネルのみをサポートしています。**ステータスバーには単色で表示されますが、通知自体の左側にアクセントカラーを適用できます。

​
大きい通知アイコン

大きい通知アイコンは通知の右側に表示されます。大きいアイコンを設定しない場合、代わりに小さいアイコンが使用されます。OneSignalは、アイコンが切り取られないように、大きい通知アイコンを自動的にスケーリングします。大きいアイコンの推奨サイズは256x256ピクセルです。

​
Androidデフォルトアイコンを追加する方法

すべてのAndroidおよびAmazonアプリにデフォルトアイコンを追加することを強くお勧めします。
1

アイコンを生成する

リストされたサイズとアルファ透過度で各画像を追加する必要があります。アルファ透過度を持つ画像の生成に関するヘルプについては、Android Asset Studioの例のクリップアートリンクを参照してください。
  • Android asset studioを使用する
  • 手動でアイコンを作成する
推奨正しい設定で小さなアイコンを迅速かつ簡単に生成するには、Android Asset Studioを使用することをお勧めします。名前としてic_stat_onesignal_defaultを使用します。

​
デフォルトアイコン名、密度、サイズ

必須：アプリに各名前とピクセルサイズが存在する必要があります。
NameDensity (dp)Size (px)
ic_stat_onesignal_defaultMDPI24x24
ic_stat_onesignal_defaultHDPI36x36
ic_stat_onesignal_defaultXHDPI48x48
ic_stat_onesignal_defaultXXHDPI72x72
ic_stat_onesignal_defaultXXXHDPI96x96
ic_onesignal_large_icon_default.pngXXXHDPI256x256
2

プロジェクトパスを作成する

次のパスが存在することを確認してください。不足しているフォルダーを作成してください。必須：各画像は次のパスに存在する必要があります：
  • Android Native
  • Unity
  • Cordova/Ionic
  • React Native
  • .NET Maui
  • Flutter
  • res/drawable-mdpi/ (24x24)
  • res/drawable-hdpi/ (36x36)
  • res/drawable-xhdpi/ (48x48)
  • res/drawable-xxhdpi/ (72x72)
  • res/drawable-xxxhdpi/ (96x96)
  • res/drawable-xxxhdpi/ (256x256) (Large Icon)
Cordova 7.0より前のバージョンでは、アイコンリソースをconfig.xmlに追加するときに、上記のパスの代わりに<project-root>/platforms/android/res/drawable-{size}/を使用する必要があります
デフォルトのOneSignalベルアイコンが表示される場合、すべてのアイコンサイズを追加していません。すべてのアイコンサイズと正しいパスを追加してください。単色の正方形が表示される場合、画像を正しいパスに設定しましたが、画像にはアルファ透過度がありません。詳細については、このAndroid Asset Studioクリップアートの画像を使用してみてください。
SDKによって、プロジェクトは次のようになります：
新しいデフォルトアイコンですべて設定完了です。

​
デフォルト以外のアイコン

デフォルトアイコンを追加した後、デフォルト以外のアイコンをさらに追加することもできます。これにより、アプリが送信する通知のタイプに応じて異なるアイコンを表示できます。たとえば、「Jewel Breaker」のようなタイトルのゲームでは、ユーザーのレベルを表す送信される通知ごとに異なる色の宝石アイコンを持つことを望む場合があります。一方、ソーシャルネットワークでは、ユーザーが別のユーザーからメッセージを受信したときにチャットバブルアイコンを表示して、より一般的なシステム通知と区別することを望む場合があります。OneSignalは、メッセージごとにデフォルトアイコンをオーバーライドすることをサポートしています。
1

アイコンを生成する

上記の手順に従ってアイコンを生成し、SDKの適切なフォルダーに配置します。
2

デフォルト以外のアイコンに名前を付ける

デフォルト以外のアイコンを追加するには、上記で指定されたデフォルト名以外の名前を付ける必要があります。たとえば、1つにmessage_iconという名前を付けることができます。
3

デフォルト以外のアイコンで通知を送信する

デフォルトアイコンを作成するための上記の手順に従い、アプリを更新した場合、通知を送信するときにこれらのアイコンを参照できます。カスタムアイコンで通知を送信するには：

​
ダッシュボード

Messages > New Push > Platform Settings > Google Android Optionsに移動し、ファイル拡張子なしでアイコン名を設定します。大きい通知アイコンでは、アイコンが表示されるURLを指定することもできます。

​
REST API

small_iconおよびlarge_icon REST APIプロパティで通知アイコンを設定します。ファイル拡張子なしでアイコン名を設定します。詳細については、通知作成REST APIドキュメントを参照してください。

​
小さいアイコンのアクセントカラー

通知の小さいアイコンの周りに表示される色を変更できます。

​
小さいアイコンのアクセントカラーを設定する

デフォルトの色を設定するには、プロジェクトのres/values/strings.xmlファイルに次の行を追加します。 ダークモードに異なる色が必要な場合は、res/values-night/strings.xmlにもキーを追加してください。 HEX値を使用します。サポートについては、Android Asset Studioのカラースキームを使用してください。 
<resources>
    <string name="onesignal_notification_accent_color">FF00FF00</string>
</resources>
通知ごとに色を設定するには、通知作成 API呼び出しでandroid_accent_colorを設定するか、Messages > New Push > Platform Settings > Google Android OptionsのAccent colorフィールドに値を入力します。
最近アプリにアイコンリソースを追加した場合、アイコンを使用して通知を送信する前に数日待つことをお勧めします。これは、新しいアイコンを含む最新バージョンにアプリを更新するのに、ユーザーの大多数が数日または数週間かかる可能性があるためです。

​
カスタムの非アルファチャネル小さいアイコン画像

一部のデバイスメーカーは、画像をそのまま表示します（基本的にアルファチャネルルールを無視します）。すべてのデバイスで非アルファチャネル画像を使用する場合は、Androidのドキュメントに基づくカスタム通知レイアウトを設定できます。 アイコンはすべてのデバイスで一貫して見えない可能性があるため、アルファルールに従うことを強くお勧めします。Googleはこのように設計しました。アイコンは小さすぎて意味のある詳細を見ることができないため、単色を強制することで、一目で認識しやすいアイコンを強制するのに役立ちます。