概要
Domo Japan Connector for LINE (Messaging API)を使用すると
LINE Messaging APIを使用して、LINE公式アカウントの分析情報を抽出することができます。
Domo Japan Connector for LINE(Messaging API)では、メッセージ送信数、友だち数、友だち属性などの統計情報にアクセスできます。
LINE公式アカウントにログインしているユーザー(アクセストークン)に応じたデータが返されます。
Reportを以下の3種類から選択します。
- Delivery:メッセージの送信数
- Followers:友だち数
- Demographic:友だちの属性情報に基づく統計情報
DeliveryとFollowersのReportは日付の指定を行うことができます。
設定できる日付の指定は以下の通り。表記は日本語のみです。
日付の選択
DeliveryとFollowersは以下の3通りの日付選択が可能です。
- 「単一の日付」
- 「日付範囲」
- 「期間」
「単一の日付」
特定の日付のデータを取得します。
「日付」
「日付タイプ」 「相対」 「遡る日数」 本日から何日前の日付を入力
「特定」 「日付」 カレンダーから特定日を指定
「日付範囲」
指定した何日から何日までのデータを取得します。
「開始日」
「日付タイプ」 「特定」 「日付」
「相対」 「遡る日数」
「終了日」
「日付タイプ」 「特定」 「日付」
「相対」 「遡る日数」
「期間」
設定済みの期間でデータを取得します。
取得できる期間は以下の通りです。
「今日」
「今週」
「今月」
「昨日」
「前の週」
「前の月」
前提条件
Domo Japan Connector for LINE(Messaging API)を利用するためには、LINEの公式アカウントを作成し、LINE Messaging Apiを利用できる状態にしておく必要があります。詳細は以下をご参照ください。
https://developers.line.biz/ja/docs/messaging-api/getting-started/
https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings_messaging_api/
LINE Official Accountへの接続
ここでは、「Domo Japan Connector for LINE(Messaging API)」ページの「Credentials(接続)」と「Details(取得できる情報)」のオプションについて説明します。このページの他のコンポーネントである「データセットのスケジューリング と名前と説明」は、ほとんどのコネクタタイプで共通であり、「データコネクターを使用してDataSetを追加する」で詳しく説明されています 。
クレデンシャル(接続)
https://developers.line.biz/ja/docs/messaging-api/getting-started/
https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings_messaging_api/
上記のサイトの手順に従って、Messaging APIのChannel access token
Channel access token (long-lived)を取得してください。
一度LINE Messaging APIの認証情報を入力すれば、Domo Japan Connector for LINE(Messaging API)のデータセットを新規に作成する際に、同じアカウントを使用することができます。。コネクタアカウントは、データセンターの[アカウント]タブで管理できます。このタブの詳細については、「Connector のユーザーアカウントを管理する」を参照してください。
詳細(取得できる情報)
ここでは、選択したReportごとに取得する列やデータタイプについて説明します。
1. Delivery
status String
集計処理の状態。以下のいずれかの値です。
- ready:メッセージ数を取得できます。
- unready:dateに指定した日付のメッセージ数の集計がまだ完了していません。しばらくしてからリクエストを再実行してください。通常、集計処理は翌日中に完了します。
- out_of_service:dateに指定した日付が、集計システムの稼働開始日(2017年03月01日)より前です。
Broadcast Number
LINE公式アカウントと友だちになっているすべてのユーザーに送信されたプッシュメッセージ(ブロードキャストメッセージ)の数。
Targeting Number
LINE公式アカウントと友だちになっているユーザーの中から属性で絞り込んで送信されたプッシュメッセージ(ターゲティングメッセージ、セグメントメッセージ)の数。
autoResponse Number
送信された応答メッセージの数。
welcomeResponse Number
送信されたあいさつメッセージの数。
chat Number
LINE Official Account Managerの「チャット基本画面 (opens new window)」から送信されたメッセージの数。
apiBroadcast Number
「ブロードキャストメッセージを送る」で送信されたメッセージの数。
apiPush Number
「プッシュメッセージを送る」で送信されたメッセージの数。
apiMulticast Number
「マルチキャストメッセージを送る」で送信されたメッセージの数。
apiNarrowcast Number
「ナローキャストメッセージを送る」で送信されたメッセージの数。
apiReply Number
「応答メッセージを送る」で送信されたメッセージの数。
broadcast以降のプロパティは、dateに指定した日付に送信されたメッセージの数です。なお、statusの値がreadyの場合にのみレスポンスに含まれます。
https://developers.line.biz/ja/reference/messaging-api/#get-number-of-delivery-messages
2. Followers
status String
集計処理の状態。以下のいずれかの値です。
- ready:数値を取得できます。
- unready:dateに指定した日付の友だち数の集計がまだ完了していません。しばらくしてからリクエストを再実行してください。通常、集計処理は翌日中に完了します。
- out_of_service:dateに指定した日付が、集計システムの稼働開始日(2016年11月01日)より前です。
followers Number
dateに指定した日付までに、アカウントが友だち追加された回数。アカウントがブロックされたり、あなたを友だち追加したユーザーがLINEアカウントを削除したりしても、この値は減少しません。
targetedReaches Number
dateに指定した日付時点の、性別や年齢、地域で絞り込んだターゲティングメッセージの配信先となりうる友だちの総数。LINEおよびその他のLINEサービスの利用頻度が高く、属性の高精度な推定が可能な友だちが含まれます。
blocks Number
dateに指定した日付時点で、アカウントをブロックしているユーザーの数。ブロックが解除されると、この値は減少します。
followers以降のプロパティは、statusの値がreadyの場合にのみレスポンスに含まれます。
https://developers.line.biz/ja/reference/messaging-api/#get-number-of-followers
3. Demographic
available Boolean
友だちの属性情報に基づく統計情報が利用できる場合は、true
genders Array
性別ごとの割合
genders[].gender String
ユーザーの性別に基づいて、以下の値が返されます。
- male
- female
- unknown
genders[].percentage Number
割合
ages Array
年齢ごとの割合
ages[].age String
ユーザーの年齢に基づいて、以下の値が返されます。
- from0to14
- from15to19
- from20to24
- from25to29
- from30to34
- from35to39
- from40to44
- from45to49
- from50
- unknown
ages[].percentage Number
割合
areas Array
地域ごとの割合
areas[].area String
ユーザーの国や地域に基づいて、以下の値が返されます。
JP
- 北海道
- 青森
- 岩手
- 宮城
- 秋田
- 山形
- 福島
- 茨城
- 栃木
- 群馬
- 埼玉
- 千葉
- 東京
- 神奈川
- 新潟
- 富山
- 石川
- 福井
- 山梨
- 長野
- 岐阜
- 静岡
- 愛知
- 三重
- 滋賀
- 京都
- 大阪
- 兵庫
- 奈良
- 和歌山
- 鳥取
- 島根
- 岡山
- 広島
- 山口
- 徳島
- 香川
- 愛媛
- 高知
- 福岡
- 佐賀
- 長崎
- 熊本
- 大分
- 宮崎
- 鹿児島
- 沖縄
- unknown
TW
- 台北市
- 新北市
- 桃園市
- 台中市
- 台南市
- 高雄市
- 基隆市
- 新竹市
- 嘉義市
- 新竹縣
- 苗栗縣
- 彰化縣
- 南投縣
- 雲林縣
- 嘉義縣
- 屏東縣
- 宜蘭縣
- 花蓮縣
- 台東縣
- 澎湖縣
- 金門縣
- 連江縣
- unknown
TH
- Bangkok
- Pattaya
- Northern
- Central
- Southern
- Eastern
- NorthEastern
- Western
- unknown
ID
- Bali
- Bandung
- Banjarmasin
- Jabodetabek
- Makassar
- Medan
- Palembang
- Samarinda
- Semarang
- Surabaya
- Yogyakarta
- Lainnya
- unknown
areas[].percentage Number
割合
appTypes Array
OSごとの割合
appTypes[].appType String
ユーザーが使用するOSに基づいて、以下の値が返されます。
- ios
- android
- others
appTypes[].percentage Number
割合
subscriptionPeriods Array
友だち期間ごとの割合
subscriptionPeriods[].subscriptionPeriod String
ユーザーとの友だち期間に基づいて、以下の値が返されます。
- within7days
- within30days
- within90days
- within180days
- within365days
- over365days
- unknown
subscriptionPeriods[].percentage Number
割合
各Arrayの要素は、availableの値がtrueの場合にのみレスポンスに含まれます。
https://developers.line.biz/ja/reference/messaging-api/#get-demographic
コメント
0件のコメント
サインインしてコメントを残してください。