HOME画面に設置することで、アプリを開くことなく、アプリの一部機能を利用できる機能の総称です。
Yappliのアプリでは、タップするとアプリ内の指定した機能に直接遷移可能なショートカット画像を設置することができます。

ウィジェットではアプリを起動せずに画像コンテンツを表示できますので、アプリユーザーに人気のコンテンツ画像を定期的に更新することでアプリ起動を促し、アクティブユーザーを増加させる効果が期待できます。

また、表示できるコンテンツは最大20件となります。

ウィジェットの更新処理は以下のタイミングで実行されます。

1. アプリ起動時
2. 管理画面のウィジェット設定画面で設定した更新開始時間
3. 日本時間 毎日 AM 5:00の定期更新

アプリを起動しない場合でも管理画面で設定した更新開始時間、定期更新時間にコンテンツ更新が実行されます。

ユーザーがアプリを起動していない状態でもウィジェットを定期的に更新するために、コンテンツ更新時に次回の更新時間が決定する仕様となっています。

そのため、ウィジェットの設定タブの更新頻度・コンテンツ管理タブ内の設定を更新した場合には、再構築時ではなく、管理画面で設定保存後、上記のいずれかのタイミングでウィジェットが更新された時に変更内容が反映されます。

ウィジェット設定タブ

更新頻度

ユーザーがアプリを起動していない場合でも、ウィジェットは必ず毎日AM 5:00に定期更新処理が実施されます。それに加え、ご希望の更新頻度を設定いただけます。

更新頻度の変更を実施した場合は、最初のウィジェット更新（ユーザーがアプリ起動した時、変更前の更新開始時間、もしくは翌日AM 5:00のうちいずれか早い時間）のタイミングで管理画面で変更した更新開始時間が反映されます。

設定変更後の更新開始時間でウィジェット更新が実施されるのは変更後、次々回以降のウィジェット更新からとなります。

以下に例を記載したため、ご参考ください。なお、アプリ外の端末側での更新処理については、反映まで管理画面の設定画面から最大で1時間のタイムラグが発生する場合がございます。ご了承ください。

（例1）CMS上で更新頻度が「毎日」「21:00」に設定されており、アプリユーザーが8/2 19:00にウィジェット設定をした場合

　8/2 19:00 端末側でウィジェットを設定
　8/2 21:00 端末側の更新処理が実施される
　8/3 5:00 端末側の更新処理が実施される
　8/3 21:00 端末側の更新処理が実施される

（例2）8/4 22:00に、CMS上で更新頻度を「毎日」「21:00」から「毎日」「17:00」と変更した場合

　8/5 5:00 端末側の更新処理が実施される→管理画面の設定が反映されるので、次回以降は「毎日」「 5:00」「 17:00」に実施される
　8/5 17:00 端末側の更新処理が実施される
　8/6 5:00 端末側の更新処理が実施される
　8/7 17:00 端末側の更新処理が実施される

（例3）8/6(土) 22:00に、CMS上で更新頻度を「毎日」「21:00」から「曜日指定・火」「17:00」とした場合
　8/7(日) 5:00 端末側の更新処理が実施される→管理画面の設定が反映されるので、次回以降は「毎日」「5:00」と「毎週火曜日」「17:00」に実施される
　8/8(月) 5:00 端末側の更新処理が実施される
　8/9(火) 5:00 端末側の更新処理が実施される
　8/9(火) 17:00 端末側の更新処理が実施される

※8/9(火) 17:00に画像更新したい場合は、コンテンツ設定の配信開始時間を 8/9 16:45に設定しておくと、間の定期更新では更新されず、8/9 17:00に画像が更新されるようになります。

（例4）8/23(火) 14:00に、CMS上で更新頻度を「毎日」「21:00」から「曜日指定・火」「17:00」とした場合（17:00までアプリを起動した端末）

　8/23(火) 15:00 ユーザーがアプリを起動。端末側の更新処理が実施される→管理画面の設定が反映されるので、次回以降は「毎日」「5:00」と「毎週火曜日」「17:00」に実施される
　8/23(火) 17:00 端末側の更新処理が実施される
　8/24(水) 5:00 端末側の更新処理が実施される
※8/23(火) 17:00に画像更新したい場合は、コンテンツ設定の配信開始時間を 8/23 16:45に設定しておくと、8/23 17:00に画像が更新されます。コンテンツ設定の配信開始時間を 8/23 15:00より以前に設定している場合、8/23 15:00にユーザーがアプリを起動した時点で画像が更新されます。

（例5）8/23(火) 14:00に、CMS上で更新頻度を「毎日」「21:00」から「曜日指定・火」「17:00」とした場合（17:00までにアプリを起動しなかった端末）

　8/23(火) 21:00 端末側の更新処理が実施される→管理画面の設定が反映されるので、次回以降は「毎日」「5:00」と「毎週火曜日」「17:00」に実施される
　8/24(水)以降 毎日 5:00 端末側の更新処理が実施される
　8/30(火) 17:00 端末側の更新処理が実施される

※8/23(火) 17:00に画像を更新したい場合でも、次回の更新処理は8/23(火) 21:00となるため、21:00に更新となります。

コンテンツ設定タブ

ウィジェットのリンク先

変更内容は端末側のウィジェット更新時に反映されますが、コンテンツを削除・リンク先を変更・リンク先のコンテンツを作成後に一度も再構築を実施していない場合は、遷移後に真っ白な画面が表示されてしまいます。

上記いずれかに該当する場合は、端末側のウィジェット更新時間（変更前の更新開始時間もしくは翌日AM 5:00のうちいずれか早い時間）までに設定及び再構築が必要になります。

配信開始日時 / 配信終了日時

端末側のウィジェット更新処理は、ウィジェットタブの更新開始時間に更新されます。
本項目は更新時にコンテンツの有効/無効を判定するための設定日時です。

ウィジェット更新開始時間までに配信開始日時となっても次回ウィジェット更新開始日時まで画像はウィジェットに表示されません。
ウィジェット更新開始時間までに配信終了日時となっても次回ウィジェット更新開始日時まで画像はウィジェットに表示されたままとなります。

ウィジェットの更新については、以下4点にご注意ください。

①配信開始/配信終了時間は画像切り替えのタイマーではありません

ウィジェットの情報は端末からのリクエストで更新されます。

配信開始時間に設定した時間に更新が反映されるわけではなく、更新時の画像の有効/無効判定に使用されます。

・配信開始時間になる　→　次の更新で有効な画像と判定
・配信終了時間になる　→　次の更新で無効な画像と判定

②再構築は事前に必ず行うこと

ウィジェットは端末からのリクエストで更新されますが、タップ時に遷移するリンク先はアプリ内機能となりますので、ウィジェット更新前に再構築し、本番アプリ内に反映させていないと、デッドリンクとなります。

③コンテンツ設定作業を中断する時は、配信開始日に未来の日程を入れて保存しておくこと

ウィジェット更新はアプリ起動時にも発生します。

更新リクエストが発生すると、再構築の有無とは関係なくウィジェットの設定内容が反映されます。有効期間となる日時を配信開始日に設定したまま「保存」すると、更新リクエスト発生時に即時反映されます。

設定作業を中断し一時保存する際には、配信開始日に未来の日程を入れて、無効な画像として保存してください。

④「無効」後の挙動について

端末のホーム画面に設置されたウィジェットの削除は、端末側の操作で可能です。

ウィジェット機能自体を取り下げたい場合、利用開始時と同様に、管理画面の設定を「無効」にした上で、アップデート申請を行う必要があります。

「無効」となったアプリのバージョンが公開された後、端末側がアプリをアップデートすると、ウィジェットが表示されなくなります。

端末側がアプリをバージョンアップしない限り、ウィジェットの更新は実行されますので、コンテンツ設定で無効な画像のみになるように設定し、プレースホルダー画像が表示される状態にしておくことを推奨します。

1. ホーム画面を長押しし、編集モードにします。

2. 画面左上の「＋」ボタンからウィジェット一覧画面を表示します。

3. 設置するウィジェットをドラッグ&ドロップしで、ホームに設置します。
   もしくは、ウィジェットをタップし、ウィジェット詳細画面に遷移します。ページ下部の「ウィジェットを追加ボタン」より設定できます。

ご注意

• ウィジェット一覧画面・詳細画面は、端末側で管理されている画面となります。表示される画像（プレースホルダー画像や取得した画像）や画像の表示順序は端末に依存するため、変更できません。

Androidは各メーカー・端末によって、ホーム画面を管理するアプリケーションが異なります。

ウィジェット一覧画面の有無・表示方法、ウィジェットの設置方法が端末によって異なるため、詳細は各端末の操作方法・説明書をご確認ください。

あくまで一例ですが、端末により以下のような設置方法があることを確認しています。

ホーム画面を長押し

ホーム画面長押しでウィジェット一覧画面の選択肢が表示されます。

一覧画面より設置したいアプリのウィジェットを選択してホーム画面に設置します。

アプリアイコンを長押し

アプリアイコンを長押しすると「ウィジェット」という選択肢が表示されます。

選択するとウィジェットの説明画面が表示され、HOMEに設置可能です。