그래픽 및 텍스트 분석 데이터 인터페이스


그래픽 및 텍스트 분석 데이터 인터페이스

1474942575482346.jpg

WeChat 공개 플랫폼은 2015년 1월 6일에 데이터 인터페이스에 대한 초대 전용 내부 테스트를 시작했습니다. 데이터 인터페이스를 통해 개발자는 공개 플랫폼 공식 웹사이트의 통계 모듈과 유사하면서도 보다 유연한 데이터를 얻을 수 있으며 필요에 따라 고급 처리를 수행할 수도 있습니다.

공식 계정 로그인 인증 메커니즘의 권한 집합 부문에서 이미지 및 텍스트 분석 데이터 인터페이스는 그룹 전송 및 알림 권한에 속합니다.

모든 공용 계정 개발자에게 데이터 인터페이스를 공개하는 시기는 별도로 공지됩니다.

참고:

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

그래픽 분석 데이터 인터페이스는 공개 플랫폼 공식 웹사이트의 데이터 통계 모듈에서 그래픽 분석 데이터를 얻는 데 사용되는 인터페이스를 의미합니다.

인터페이스 이름최대 기간 인터페이스 호출 주소(https를 사용해야 함)
그룹 텍스트의 일일 데이터 가져오기(getarticlesummary) 1https://api.weixin.qq. /datacube/getarticlesummary?access_token=ACCESS_TOKEN
그룹 텍스트의 전체 데이터 가져오기(getarticletotal)1https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN
그래픽 및 텍스트 통계 데이터 가져오기(getuserread)3https://api.weixin.qq.com/datacube/getuserread?access_token=ACCESS_TOKEN
그래픽 및 텍스트 통계 시간 공유 데이터 가져오기(getuserreadhour) 1 https://api.weixin.qq.com/datacube/getuserreadhour?access_token=ACCESS_TOKEN
이미지 및 텍스트 공유 및 데이터 전달 받기(getusershare)7https://api.weixin .qq.com/datacube/getusershare?access_token=ACCESS_TOKEN
이미지 및 텍스트 공유 가져오기 및 시간 공유 데이터 전달(getusersharehour) 1https://api.weixin.qq.com /datacube/ getusersharehour?access_token=ACCESS_TOKEN

최대 시간 범위는 인터페이스 호출 중 데이터를 얻을 수 있는 최대 시간 범위를 나타냅니다. 예를 들어 최대 시간 범위는 7일이며, 이는 한 번에 최대 7일의 데이터를 얻을 수 있음을 의미합니다. "Get access_token"을 통해 access_token의 실제 값을 획득하시기 바랍니다.


인터페이스 호출 요청 설명

그래픽 및 텍스트 분석 데이터 인터페이스(인터페이스 목록의 모든 인터페이스 포함)는 다음 샘플 데이터 패킷을 해당 인터페이스 호출 주소에 게시해야 합니다.

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

Call 매개 변수 설명

# 🎜 🎜#access_tokenis통화 인터페이스 자격 증명begin_date데이터의 시작 날짜를 얻으려면 Begin_date와 end_date의 차이가 "최대 시간 범위"보다 작아야 합니다. (예를 들어 최대 시간 범위가 1인 경우 start_date와 end_date의 차이는 1보다 작기 전에는 0일 수 있습니다. 그렇지 않으면 오류가 보고됩니다. end_date은 #🎜의 종료 날짜입니다. 🎜#
Parameter필수인가요설명
#🎜🎜 #이다 # 🎜🎜#
데이터를 가져오려면 최대 end_date 설정이 허용됩니다. 값은 어제입니다

반환 지침

일반적인 상황에서 그룹 텍스트의 일일 데이터를 얻기 위한 인터페이스의 반환 JSON 데이터 패킷은 다음과 같습니다.

{ 
    "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
        } 
 	 //后续会列出该日期内所有被阅读过的文章(仅包括群发的文章)在当天的阅读次数等数据
    ]
}

일반적인 상황에서 대량 텍스트 및 그래픽의 전체 데이터를 얻기 위해 인터페이스에서 반환되는 JSON 데이터 패킷은 다음과 같습니다. (자세한 내용은 각 날짜에 해당하는 값은 최대 기사의 총량입니다. 그날의 볼륨이 아님). 또한 다음과 같이 대량 텍스트 및 그래픽의 일일 데이터를 가져오는 것(getarticlesummary)과 대량 텍스트 및 그래픽의 전체 데이터를 가져오는 것(getarticletotal)의 차이점에 주의할 필요가 있습니다. #🎜 🎜#

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之间的群发文章的数据
   ]
}

일반적인 상황에서는 그림을 얻습니다. 그래픽 통계 데이터 인터페이스의 반환된 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "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之间的数据
   ]
}

일반적인 상황에서 그래픽의 반환된 JSON 데이터 패킷은 다음과 같습니다. 및 텍스트 통계 시간 공유 데이터 인터페이스는 다음과 같습니다.

{ 
   {
   "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小时的数据
   ]
}

정상 상황 아래에서 이미지 및 텍스트 공유 및 전달 데이터 인터페이스에 대해 반환된 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "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之间的数据
   ]
}
# 🎜🎜# 일반적인 상황에서 이미지 및 텍스트 공유 및 전달 일일 데이터 인터페이스에 대해 반환되는 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "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此处固定
   ]
}

Return 매개 변수 설명

#🎜🎜 #

#🎜 🎜 #데이터의 날짜는 start_date와 end_date 사이여야 합니다.ref_hour데이터의 시간은 000부터 2300까지를 나타냅니다. 각각 [000,100) ~ [2300,2400), 즉 매일의 첫 번째 시간과 마지막 시간입니다stat_date#🎜🎜 #title 그래픽 메시지 제목 int_page_read_user그래픽 페이지 (페이지를 클릭하시면 그룹 텍스트 카드로 들어가실 수 있습니다.) ) 독자 수int_page_read_count사진 및 본문 페이지의 독자 수# 🎜🎜##🎜🎜 #ori_page_read_user원문 페이지(그림과 글에서 "원문 읽기"를 클릭하여 들어간 페이지)의 독자 수 페이지) 원본 텍스트 페이지가 없는 경우 여기의 데이터는 0입니다.ㅋㅋㅋ 숫자 공유한 사람 수공유 횟수intpagefromsessionreaduser public account 세션 독자 수intpagefromsessionreadcount 공개 계정 세션 독자 수intpagefromhistmsgreaduser 기록 메시지 페이지 독자 수intpagefromfeedreaduser 친구 서클의 독자 수intpagefromfriendsreaduser 친구가 전달한 독자 수intpagefromfriendsreadcount 친구가 전달한 독자 수 intpagefromotherreaduser number of reader of other scene feedsharefromsessioncnt 공개 계정 세션이 친구 서클에 전달한 횟수 Feedsharefromfeeduser 친구의 서클을 친구의 서클에 전달한 사람 수 feedsharefromfeedcnt 친구의 서클이 친구의 서클을 전달한 횟수 feedsharefromothercnt다른 시나리오의 모멘트에 전달된 횟수
ParameterDescription
ref_date
#🎜🎜 #통계 날짜, getarticletotal 인터페이스에서 ref_date는 기사 그룹이 발행된 날짜를 나타내며 stat_date는 데이터 통계 날짜입니다. 🎜🎜#참고: 여기서 msgid는 실제로 msgid(대량 전송 인터페이스가 호출된 후 반환된 msg_data_id인 그래픽 메시지 ID)와 인덱스(메시지 시퀀스 인덱스)로 구성됩니다. 예를 들어 12003_3, 여기서 12003은 msgid입니다. 3은 대량 메시지의 ID입니다. 이 그래픽 메시지 그룹에 총 5개의 기사가 있다고 가정하면(여러 그래픽 메시지가 있을 수 있으므로) 3은 5개의 기사 중 세 번째를 의미합니다.
share_count
add_to_fav_user

수집한 사람 수
add_to_fav_count수집 횟수
받기 그룹 문자 메시지에 대한 전체 데이터 인터페이스의 세부 필드 설명
intpagefromhistmsgreadcount 기록 메시지 페이지의 독자 수intpagefromfeedreadcount 친구 서클의 독자 수
intpagefromotherreadcount 다른 장면을 읽은 횟수 feedsharefromsessionuser 친구 서클에 공개 계정 세션을 전달한 사람 수
feedsharefromotheruser 다른 장면에서 친구의 서클에 전달한 횟수 Moments의 사람 수

target_user수신자 수는 일반적으로 전체 팬 수와 거의 동일합니다. (수신할 수 없는 사람은 제외해야 함) 블랙리스트나 기타 비정상적인 상황으로 인한 메시지) 팬 여러분)
user_source이 필드는 사진 및 텍스트 읽기 시간 공유를 얻을 때만 사용할 수 있습니다. 사용자가 그림을 읽기 위해 입력하는 위치를 나타내는 데이터입니다. 0: 대화 1. 친구 3. Tencent Weibo 4. 기타 WeChat은 오류 코드 및 기타 정보를 반환합니다. 글로벌 반환 코드 설명#🎜 🎜#