管理画面

英語に対応しています。

管理画面上部メニュー「ログインユーザー名」＞「ページ設定」ページの言語より変更可能です。

 

各ページで表示している項目、定義についてまとめました。
分析の内容によって使い分けしてください。

管理画面（配信一覧）

 

 

#	名前	説明
①	配信対象人数	配信対象となった人数  ※配信時、アプリアンインストールされている端末に対する配信も含まれます 配信できた数を知りたい場合は、レポートの配信結果をご確認ください。
②	開封数(率)	・プッシュ通知受信時のポップアップが開封された数 ・1アプリ（1端末/メッセージ毎）につき1度のみ計測となります
③	閲覧数(率)	FANSHIP SDKで提供している標準のコンテンツ（お知らせ詳細画面）を閲覧した数 同じ人が何度も閲覧した場合、重複してカウント（延べ数）されるため開封率より高くなります。
④	サイト閲覧数(率)	「URLを開く」ボタンとHTML配信内のリンクをタップした合計数。 重複カウント（延べ数）されるため、配信人数以上になる場合があります。

 

• 配信対象人数以外は、日次集計です

 

 

管理画面（配信結果）

 

 

#	名前	説明
①	配信ユーザー数	プッシュ通知（APNs/FCMへのリクエスト）が完了した数 （コンテンツ配信は含みません）
②	プッシュ開封数(率)	・プッシュ通知受信時のポップアップが開封された数。 ・1アプリ（1端末/メッセージ毎）につき1度のみ計測となります。
③	詳細閲覧数	FANSHIP SDKで提供している標準のコンテンツ（お知らせ詳細画面）を閲覧したユニークユーザー数

 

• すべて日次集計です
  
  

 

FANSHIPレポート管理画面（配信結果）

 

 

#	名前	説明
①	配信	プッシュ通知（APNs/FCMへのリクエスト）が完了した数
②	開封	・プッシュ通知受信時のポップアップが開封された数。 ・1アプリ（1端末/メッセージ毎）につき1度のみ計測となります。
③	閲覧	FANSHIP SDKで提供している標準のコンテンツ（お知らせ詳細画面）を閲覧したユニークユーザー数
④	遷移	FANSHIP SDKで提供している標準のコンテンツ（お知らせ詳細画面）を閲覧したユニークユーザー数
⑤	開封率	開封/配信
⑥	閲覧率	閲覧/配信
⑦	遷移率	遷移/配信

 

• すべて日次集計です

 

 

SDK（端末） → サーバーへのログの送信は、iOSは1時間～最大数時間、Androidは最大1時間程度のタイムラグが発生する場合があります。

SDKからサーバーへログが送られるタイミング は以下となります。

【iOS】

• アプリがアクティブになったとき（アプリをフォアグラウンドにしたとき）
• バックグラウンドフェッチが発動したとき（このタイミングはOS側に依存しますが、通常、数時間に1回程度の頻度で発生します）
• 位置情報をオンにして組み込んでいるケースでは、ネットワーク測位が観測されたとき（ユーザーがある程度の距離を移動すれば、自動的に発生します）
  (SDK最新版 3.5.6以上では アプリがバックグラウンドになった時も送信）

【Android】

• アプリがアクティブになったとき（アプリをフォアグラウンドにしたとき）
• 1時間間隔で送信
  （6.0以上のOSの場合でDozeモードに入った場合は、想定通りの動作をしなくなります）

サーバーで正常に処理されれば、管理画面にはすぐに反映されます

※フォアグラウンド = アプリが立ち上がっている状態
※バックグラウンドフェッチ = バックグラウンドにある状態で一定期間毎に特定の処理を実行

以下すべてを満たした場合のこととなります。

• 「設定 > プライバシー > 位置情報サービス > アプリ名」が「常に許可」「このAppの使用中のみ許可」のどちらか
• 「設定 > アプリ名」において「位置情報を送信する」がオン
• 「設定 > 機内モード」がオフ

popinfo ID が無効になっている場合、このエラーメッセージが表示されます。
token が正しく取得できていない可能性がありますので、以下の点をご確認ください。

【iOS】

• SDKとXcodeのバージョンの組み合わせが正しいかを、組み込みガイドの「開発環境の確認」にてご確認ください。
• 製品用のビルド証明書でAdHocビルドをしており、ビルド時の設定が間違っている。
• デバイストークンの払い出しが行われているかどうかの確認をお願いします。
  SDKに内包されている ファイル AppDelegate.swift ( Objective Cの場合は、AppDelegate.m )
  以下の部分にログ等をいれると、OSからのデバイストークン成功したかどうかの確認ができます。

// [★必須4:ここから] APNsトークンを popinfoReceiver に登録します

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {

self.popinfoReceiver.registerToken(deviceToken)

}

// [★必須5:ここから] APNsトークン失敗時のエラーを確認できるようにします

func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {

NSLog("didFailToRegisterForRemoteNotificationsWithError = \(error)")

}

 

【Android】

• FANSHIP組み込む以前バージョンもFirebase関連のライブラリを組み込んでおり、FANSHIPのガイド通りにFirebase周りが実装されてない可能性があります。
  ※Firebase関連のライブラリはFCMを使ってなくても初回起動時に自動でトークンを取得します。
• アプリアップデートにおいてもトークン更新処理は行われないことが多いため、アプリ内で取得してFANSHIPへ渡す実装をする必要があります。このようなFirebase周りの組み込み実装のミスが起こっているケースがございますので、ご確認ください。
• AndroidManifest.xml に以下を設定し、アプリを起動すると、popinfo ID の取得～PUSH 通知受信準備完了（通知受信可能状態）までの処理の結果が画面上にトーストで表示されますので、試してみてください。

　<meta-data
　android:name="POPINFO_DEBUG"
　android:value="true" />

 

他、以下に当てはまらないかご確認ください。

• 端末がGCM、またはFCMに対応していない
• 端末の時刻が正しくないため、Playストアと同期が取れない
• Playストアのバージョンが古い
• 端末にGoogleアカウントが設定されていない
• AndroidManifest の記述が正しくない
• Sender IDが正しくない
• AndroidManifestファイルの修正、およびFCMサーバーキーと設定ファイルの再設定
• 正しいFirebase コンソールプロジェクトからダウンロードした google-services.json を内包していない

【iOS、Android共通】

アプリを再インストールし、プッシュ通知許諾ダイアログにて「許諾ON」とすることで解消される場合もございます。アプリをインストールした直後や、許諾変更直後は状況によりサーバー側への反映にタイムラグが発生することがございますので、時間をおいて再度ご確認ください。

■ 配信人数

配信対象人数。

全体配信の場合、以下の「プッシュ受信許可」の人数が配信対象となります。プッシュ通知が届いた人ではありません。 

 

<iOS>

■ 開封数 カウントの条件

1. 以下①~③のバナー、もしくは通知（OSが表示）をタップし、FANSHIP SDK標準詳細画面へ遷移した場合

 

2. 以下①、②のバナー、もしくは通知（OSが表示）をスライドし「表示」をタップしてFANSHIP SDK標準詳細画面へ遷移した場合

  

3. 標準組込でアプリを立ち上げていて、通知がきた場合に表示されるダイアログ（SDKが表示）が表示された場合

 

アプリを立ち上げている状態のため、「閉じる」ボタンを押下しても開封数はカウントされます。

 

■ 閲覧数 カウントの条件 

1. 以下①~③のバナー、もしくは通知（OSが表示）をタップし、FANSHIP SDK標準詳細画面へ遷移した場合

 

2. 以下①、②のバナー、もしくは通知（OSが表示）をスライドし「表示」をタップしてFANSHIP SDK標準詳細画面へ遷移した場合

 

3. 標準組込でアプリを立ち上げていて、通知がきた場合に表示されるダイアログ（SDKが表示）の「表示」ボタンを押し、FANSHIP SDK標準詳細画面へ遷移した場合

 

4. 詳細一覧から、詳細画面へ遷移した場合

 

■ サイト閲覧数 カウントの条件

詳細画面の「①URLを開く」ボタンをタップした数と、HTML配信の「 ②リンクURL」をタップした数の合計数

 

 

<Android>

■ 開封数 カウントの条件

1. 以下①~④の通知をタップし、FANSHIP SDK標準詳細画面へ遷移した場合

 

※ポップアップダイアログの「閉じる」を押した場合はカウントされません。

 

■ 閲覧数 カウントの条件

1. 以下①~④の通知をタップし、FANSHIP SDK標準詳細画面へ遷移した場合

 

※ポップアップダイアログの「閉じる」を押した場合はカウントされません。

2. 詳細一覧から、詳細画面へ遷移した場合

 

■ サイト閲覧数 カウントの条件

1. 詳細画面の「①URLを開く」ボタンをタップした数と、HTML配信の「 ②リンクURL」をタップした数の合計数

 

APIで 401 Unauthorized というエラーが返却される、管理画面で「セッションが切れました」というエラーが返却され強制ログアウトのは認証エラーが発生しているためです。

 

原因

• tokenを都度取り直している（古い token は無効化されます）
• 複数台サーバで、tokenを奪い合っている

対策（管理画面）

 

認証トークンの発行を行うと、古いトークンが無効化されるため、
APIで利用されるログインIDと、管理画面にログインするIDは別のものをご利用ください。

対策（API）

永続的な認証トークンを作成し、都度ログインAPIを叩かないようにしていただくことを推奨しています。

https://docs.fanship.jp/mapi/login.html

API用の追加ID発行や、IDが分からないなどの場合お手数ですが、アプリ名・または普段ご利用のログインIDを添えてサポートまでお問い合わせください。

 

 

 

＜表示されるエラー画面＞

 

 

ヘッダーが無い場合、エラーが表示されます。

作成したCSVのファイルの中身のヘッダーに「popinfo_id」をつけてください。

例）

 

 

参考：FANSHIP 管理画面マニュアルーセグメント登録

 

 

申し訳ございません。できません。

セグメントは、日次集計で、前日分までが翌朝8時までに反映される仕組みとなるため、
「当日インストールしたユーザー」というセグメントを作成することは不可です。

• AppStore、GooglePlayのストアでのアプリダウンロード数は、ユニークデバイス数になります。
  そのため、1つの端末で複数回、ダウンロード、初回起動をしても「1」とカウントされます。
• FANSHIPの管理画面「アプリ初回起動数」は、生存している popinfo ID の数をカウントしています。
  そのため、同じユーザーがアプリインストールとアンインストールを繰り返した場合、
  複数カウントされます。
  
  ①アプリインストール → 立ち上げ → アンインストール
  ②アプリインストール → 立ち上げ → アンインストール
  ③アプリインストール → 立ち上げ
  
  上記の場合、初回起動数は「3」になります。

 

参考：

管理画面マニュアル＞ユーザー情報
https://docs.fanship.jp/dashboard/report/enduser.html