Interface de données d'analyse graphique et textuelle

La plateforme publique WeChat a lancé le test interne sur invitation uniquement de l'interface de données le 6 janvier 2015. Grâce à l'interface de données, les développeurs peuvent obtenir des données similaires mais plus flexibles au module de statistiques du site officiel de la plateforme publique, et peuvent également effectuer des traitements avancés si nécessaire.

Dans la division des ensembles d'autorisations du mécanisme d'autorisation de connexion au compte officiel, l'interface de données d'analyse d'images et de texte appartient aux autorisations d'envoi et de notification de groupe.

Le moment d'ouvrir l'interface de données à tous les développeurs de comptes publics sera notifié séparément.

Veuillez noter :

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
3、额外注意，获取图文群发每日数据接口的结果中，只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计，过小的阅读量的图文消息无法统计。

L'interface de données d'analyse graphique fait référence à l'interface utilisée pour obtenir des données d'analyse graphique dans le module de statistiques de données du site officiel de la plateforme publique est la suivante :

Nom de l'interface	Durée maximale	Adresse d'appel de l'interface (doit utiliser https)
Obtenir les données quotidiennes du texte du groupe (getarticlesummary)	1	https://api.weixin.qq com. /datacube/getarticlesummary?access_token=ACCESS_TOKEN
Obtenir les données totales du texte du groupe (getarticletotal)	1	https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN
Obtenez des données statistiques graphiques et textuelles (getuserread)	3	https://api.weixin.qq.com/datacube/getuserread?access_token=ACCESS_TOKEN
Obtenez des données statistiques graphiques et textuelles de temps partagé (getuserreadhour)	1	https://api.weixin.qq.com/datacube/getuserreadhour?access_token=ACCESS_TOKEN
Obtenez le partage d'images et de textes et le transfert de données (getusershare)	7	https://api.weixin .qq.com/ datacube/getusershare?access_token=ACCESS_TOKEN
Obtenez le partage d'images et de textes et transférez des données en temps partagé (getusersharehour)	1	https://api.weixin.qq.com/datacube/getusersharehour?access_token=ACCESS_TOKEN

La durée maximale fait référence à la plage de temps maximale pendant laquelle des données peuvent être obtenues lors d'un appel d'interface. Par exemple, la durée maximale est de 7, ce qui signifie que jusqu'à 7 jours de données peuvent être obtenues à la fois. Veuillez obtenir la valeur réelle de access_token via "Get access_token".

Description de la demande d'appel d'interface

L'interface de données d'analyse graphique et textuelle (y compris toutes les interfaces de la liste d'interfaces) doit POST l'exemple de paquet de données suivant à l'adresse d'appel d'interface correspondante :

{ 
    "begin_date": "2014-12-08", 
    "end_date": "2014-12-08"
}

Description du paramètre d'appel

end_date

Instructions de retour

Dans des circonstances normales, le paquet de données JSON de retour de l'interface pour obtenir les données quotidiennes de textes et de graphiques de masse est le suivant :

{ 
    "list": [ 
        { 
            "ref_date": "2014-12-08", 
            "msgid": "10000050_1", 
            "title": "12月27日 DiLi日报", 
            "int_page_read_user": 23676, 
            "int_page_read_count": 25615, 
            "ori_page_read_user": 29, 
            "ori_page_read_count": 34, 
            "share_user": 122, 
            "share_count": 994, 
            "add_to_fav_user": 1, 
            "add_to_fav_count": 3
        } 
 	 //后续会列出该日期内所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据
    ]
}

Dans des circonstances normales, le paquet de données JSON de retour de l'interface pour obtenir les données totales de texte et de graphiques en masse sont les suivantes (veuillez noter que, dans le détail, la valeur correspondant à chaque jour est le volume total d'articles jusqu'à ce jour (et non le volume de ce jour)). Une attention particulière doit être accordée à la différence entre l'obtention des données quotidiennes de texte et de graphiques en masse (getarticlesummary) et l'obtention des données totales de texte et de graphiques en masse (getarticletotal) comme suit :

1、前者获取的是某天所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据。
2、后者获取的是，某天群发的文章，从群发日起到接口调用日（但最多统计发表日后7天数据），每天的到当天的总等数据。例如某篇文章是12月1日发出的，发出后在1日、2日、3日的阅读次数分别为1万，则getarticletotal获取到的数据为，距发出到12月1日24时的总阅读量为1万，距发出到12月2日24时的总阅读量为2万，距发出到12月1日24时的总阅读量为3万。

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-14", 
           "msgid": "202457380_1", 
           "title": "马航丢画记", 
           "details": [ 
               { 
                   "stat_date": "2014-12-14", 
                   "target_user": 261917, 
                   "int_page_read_user": 23676, 
                   "int_page_read_count": 25615, 
                   "ori_page_read_user": 29, 
                   "ori_page_read_count": 34, 
                   "share_user": 122, 
                   "share_count": 994, 
                   "add_to_fav_user": 1, 
                   "add_to_fav_count": 3,
                    "int_page_from_session_read_user": 657283, 
                    "int_page_from_session_read_count": 753486, 
                    "int_page_from_hist_msg_read_user": 1669, 
                    "int_page_from_hist_msg_read_count": 1920, 
                    "int_page_from_feed_read_user": 367308, 
                    "int_page_from_feed_read_count": 433422, 
                    "int_page_from_friends_read_user": 15428, 
                    "int_page_from_friends_read_count": 19645, 
                    "int_page_from_other_read_user": 477, 
                    "int_page_from_other_read_count": 703, 
                    "feed_share_from_session_user": 63925, 
                    "feed_share_from_session_cnt": 66489, 
                    "feed_share_from_feed_user": 18249, 
                    "feed_share_from_feed_cnt": 19319, 
                    "feed_share_from_other_user": 731, 
                    "feed_share_from_other_cnt": 775
               }, 
	//后续还会列出所有stat_date符合“ref_date（群发的日期）到接口调用日期”（但最多只统计7天）的数据
           ]
       },
	//后续还有ref_date（群发的日期）在begin_date和end_date之间的群发文章的数据
   ]
}

Dans des circonstances normales, les données JSON renvoyées Le paquet de données JSON de l'interface pour obtenir des données statistiques graphiques et textuelles est le suivant :

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "int_page_read_user": 45524, 
           "int_page_read_count": 48796, 
           "ori_page_read_user": 11, 
           "ori_page_read_count": 35, 
           "share_user": 11, 
           "share_count": 276, 
           "add_to_fav_user": 5, 
           "add_to_fav_count": 15
       }, 
	//后续还有ref_date在begin_date和end_date之间的数据
   ]
}

Dans des circonstances normales, le paquet de données JSON renvoyé par l'interface pour obtenir des données statistiques graphiques et textuelles en temps partagé est le suivant :

{ 
   {
   "list": [
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 0, 
           "int_page_read_user": 6391, 
           "int_page_read_count": 7836, 
           "ori_page_read_user": 375, 
           "ori_page_read_count": 440, 
           "share_user": 2, 
           "share_count": 2, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 1, 
           "int_page_read_user": 1, 
           "int_page_read_count": 1, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 2, 
           "int_page_read_user": 3, 
           "int_page_read_count": 3, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 4, 
           "int_page_read_user": 42, 
           "int_page_read_count": 100, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }
 	//后续还有ref_hour逐渐增大,以列举1天24小时的数据
   ]
}

Dans des circonstances normales , le paquet de données JSON renvoyé par l'interface pour obtenir les données de transfert de partage de graphiques et de texte est le suivant :

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "share_scene": 1, 
           "share_count": 207, 
           "share_user": 11
       }, 
       { 
           "ref_date": "2014-12-07", 
           "share_scene": 5, 
           "share_count": 23, 
           "share_user": 11
       }
	//后续还有不同share_scene（分享场景）的数据，以及ref_date在begin_date和end_date之间的数据
   ]
}

Dans des circonstances normales, le paquet de données JSON renvoyé est le suivant :

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 1200, 
           "share_scene": 1, 
           "share_count": 72, 
           "share_user": 4
       }
	//后续还有不同share_scene的数据，以及ref_hour逐渐增大的数据。由于最大时间跨度为1，所以ref_date此处固定
   ]
}

Le paquet de données JSON de retour de l'image et du texte L'interface de partage et de transfert de données quotidiennes est la suivante : rrreee

Description du paramètre de retour🎜🎜

Le paramètre	est-il obligatoire ?	Description
access_token	est la	les identifiants de l'interface d'appel
begin_date	est la date de début pour obtenir les données, beLa différence entre gin_date et end_date doit être inférieur à "Durée maximale" (par exemple, lorsque la durée maximale est de 1, la différence entre start_date et end_date ne peut être que de 0 pour être inférieure à 1), sinon une erreur sera signalée
est la date de fin de	obtention des données, end_date La valeur maximale autorisée est hier

Paramètre	Description
ref_date	La date des données doit être comprise entre start_date et end_date
ref_hour	L'heure des données, comprise entre 000 et 2300, représente respectivement [ 000, 1 00) à [2300,2400), c'est-à-dire la première heure et la dernière heure de chaque jour
stat_date	La date statistique dans l'interface getarticletotal, ref_date fait référence à la date de publication du groupe d'articles, et stat_date est la date des statistiques de données
msgid	Veuillez noter : le msgid ici est en fait composé de msgid (identifiant d'image et de message texte, qui est le msg_data_id renvoyé après l'appel de l'interface d'envoi de groupe) et d'index (séquence de messages index), par exemple 12003_3, où 12003 est msgid , c'est-à-dire l'identifiant d'un message envoyé dans un groupe ; 3 est index ; supposons que le message graphique envoyé dans ce groupe contienne un total de 5 articles (car il peut y en avoir plusieurs). images et textes), 3 représente le troisième parmi les 5
title	Le titre du message graphique
int_page_read_user	Le nombre de lecteurs de la page graphique (la page saisie en cliquant sur le groupe carte texte)
int_page_read_count	Le nombre de lectures de la page graphique
ori_page_read_user	page de texte originale (La page saisie en cliquant sur "Lire le texte original" sur la page d'image et de texte). il n'y a pas de page de texte originale, les données ici sont 0
ori_page_read_count	Le nombre de fois que la page originale a été lue
share_scene	Scène partagée 1 représente le transfert par des amis 2 représente les Moments 3 représente Tencent Weibo 255 représente les autres
share_user	Le numéro de personnes partageant
share_count	Le nombre de fois partagé
add_to_fav_user	Le nombre de personnes qui l'ont collecté
add_to_fav_count	Le nombre de fois qu'il a été collecté
Obtenez les champs détaillés dans l'interface de données totales pour les messages texte de groupe Explication	intpagefromsessionreaduser public account Le nombre de lecteurs de la session intpagefromsessionreadcount Le nombre de lecteurs de la session du compte public intpagefromhistmsgreaduser Le nombre de lecteurs de la page de message historique intpagefromhistmsgreadcount Le nombre de lecteurs de la page de messages historiques intpagefromfeedreaduser Le nombre de lecteurs dans le cercle d'amis intpagefromfeedreadcount Le nombre de lecteurs dans le cercle d'amis intpagefromfriendsreaduser Le nombre de lecteurs transférés par des amis intpagefromfriendsreadcount Le nombre de lecteurs transférés par des amis intpagefromotherreaduser Le nombre de lecteurs d'autres scènes intpagefromotherreadcount Le nombre de lectures d'autres scènes feedsharefromsessionuser Le nombre de personnes qui ont transmis la session du compte public au cercle d'amis feedsharefromsessioncnt Le nombre de fois où la session du compte public a été transmise au cercle d'amis feedsharefromfeeduser Le nombre de personnes qui ont transféré le cercle d'amis vers le cercle d'amis feedsharefromfeedcnt Le nombre de fois que le cercle d'amis a transféré le cercle d'amis feedsharefromotheruser Le nombre de transferts vers le cercle d'amis à partir d'autres scènes Nombre de personnes dans Moments feedsharefromothercntNombre de fois transférées vers Moments dans d'autres scénarios
target_user	Le nombre de destinataires est généralement approximativement égal au nombre total de fans (les fans qui ne peuvent pas recevoir de messages en raison de listes noires ou d'autres circonstances anormales doivent être exclus)
user_source	Lors de l'obtention du temps de lecture graphique -partage de données Ce champ existe uniquement et représente l'endroit où l'utilisateur entre pour lire l'image et le texte. 0 : Conversation ; 1. Amis ; 2. Moments ; 3. Tencent Weibo ; 4. Page de messages historiques ; 5. Autres

Lorsqu'une erreur se produit, WeChat renvoie le code d'erreur et d'autres informations. , veuillez consulter : Description du code de retour global