LINE通知メッセージの統計情報を取得する
本ドキュメントに記載の機能は、所定の申請等を行った法人ユーザーのみがご利用いただけます。自社のLINE公式アカウントでご利用になりたいお客様は、担当営業までご連絡いただくか、弊社パートナーにお問い合わせください。
概要
LINE通知メッセージ（テンプレート）とLINE通知メッセージ（フレキシブル）では、ユニット名を指定してメッセージを送信することで、統計情報をユニットごとに取得できます。
取得できる統計情報、ユニット名の制限、統計情報を取得する方法などについて詳しくは、『Messaging APIドキュメント』の「送信したメッセージの統計情報を取得する」を参照してください。
ユニット名を指定する
LINE通知メッセージを送信するときに、customAggregationUnitsプロパティにユニット名を指定します。指定方法について詳しくは、『LINE通知メッセージAPIリファレンス』の以下の項目を参照してください。
LINE通知メッセージでユニット名を指定する際の注意点
LINE通知メッセージでユニット名を指定する際は、次の2点に注意してください。
同じ用途のLINE通知メッセージに対して同じユニット名を継続的に使用する
プライバシーを保護するため、集計された統計情報の値が20未満だった場合などは、個人の操作に関する統計情報の値はnullになります。LINE通知メッセージは1人のユーザーに対して送信されるため、同じユニット名を付与してメッセージを送った対象のユーザー数が少ない場合、あるいは集計の対象期間が短い場合は統計情報がnullになりやすくなります。
同じ用途のLINE通知メッセージに同じユニット名を継続して使用し、週次や月次など、より長い期間で統計情報を確認することを検討してください。統計情報がnullになる条件について詳しくは、『Messaging APIドキュメント』の「集計される統計情報についての注意点」を参照してください。
統計情報は実際にメッセージが送信されてから更新される
LINE通知メッセージでは、APIで送信リクエストを行った時点ではなく、実際にメッセージがユーザーへ送信されたタイミングで、統計情報やユニット名に関する以下の更新が行われます。
- 統計情報の更新が始まり、14日間（1,209,600秒間）継続する。
- 指定したユニット名が、当月中に付与したユニット名の種類数としてカウントされる。
- 指定したユニット名が、当月中に付与したユニット名の一覧に含まれる。
たとえば、ユーザーのLINE通知メッセージの受信設定が未設定の場合は、ユーザーが受信に同意した後にメッセージが送信されます。この場合、メッセージが実際に送信されるまでは、「当月中に付与したユニット名の種類数を取得する」および「当月中に付与したユニット名のリストを取得する」エンドポイントの結果に反映されません。