Domo Japan Connector for LINE(Messaging API)

概要

Domo Japan Connector for LINE (Messaging API)を使用すると
LINE Messaging APIを使用して、LINE公式アカウントの分析情報を抽出することができます。

Domo Japan Connector for LINE(Messaging API)では、メッセージ送信数、友だち数、友だち属性などの統計情報にアクセスできます。

LINE公式アカウントにログインしているユーザー（アクセストークン）に応じたデータが返されます。

Reportを以下の3種類から選択します。

1. Delivery：メッセージの送信数
2. Followers：友だち数
3. 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