메시지 분석 데이터 인터페이스


메시지 분석 데이터 인터페이스

1474942992867943.jpg


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

공식 계정 로그인 인증 메커니즘의 권한 집합 부문에서 메시지 분석 데이터 인터페이스는 메시지 관리 권한에 속합니다.

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

참고:

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据,将查询不到在此之前的日期,即使有查到,也是不可信的脏数据;
2、请开发者在调用接口获取数据后,将数据保存在自身数据库中,即加快下次用户的访问速度,也降低了微信侧接口调用的不必要损耗。

메시지 분석 데이터 인터페이스는 공개 플랫폼 공식 웹사이트의 데이터 통계 모듈에서 메시지 분석 데이터를 얻는 데 사용되는 인터페이스를 의미합니다. 구체적인 인터페이스 목록은 다음과 같습니다. 아직 키워드 데이터 인터페이스):

인터페이스 이름최대 시간 범위인터페이스 호출 주소(https를 사용해야 함)
메시지 전송 프로필 데이터 가져오기(getupstreammsg)7https://api.weixin.qq.com/ datacube/getupstreammsg?access_token=ACCESS_TOKEN
메시지 배포 시간 공유 데이터 가져오기(getupstreammsghour)1https://api.weixin.qq.com/datacube/getupstreammsghour?access_token=ACCESS_TOKEN
받기 메시지 전송 주간 데이터(getupstreammsgweek)30https://api.weixin.qq.com/datacube/getupstreammsgweek?access_token=ACCESS_TOKEN
월별 메시지 전송 데이터 가져오기(getupstreammsgmonth)30https: //api.weixin.qq.com/datacube/getupstreammsgmonth?access_token=ACCESS_TOKEN
메시지 전송 분포 데이터 가져오기(getupstreammsgdist)15https://api.weixin.qq.com/datacube/getupstreammsgdist? access_token=ACCESS_TOKEN
메시지 발송 분포 주간 데이터 가져오기(getupstreammsgdistweek)30https://api.weixin.qq.com/datacube/getupstreammsgdistweek?access_token=ACCESS_TOKEN
메시지 발송 분포 월별 데이터 가져오기(getupstreammsgdistmonth) 30https://api.weixin.qq.com/datacube/getupstreammsgdistmonth?access_token=ACCESS_TOKEN

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

주간 데이터 및 월간 데이터의 경우 월간/주간 정기 데이터의 날짜는 월/주 1일(매월 1일 또는 월요일)에 표시됩니다. 특정 월/주가 지난 후에 인터페이스를 호출해야만 해당 기간의 데이터를 얻을 수 있습니다. 예를 들어 (11월 1일 - 11월 5일)을 (begin_date 및 end_date)로 사용하여 12월 1일 월별 데이터 인터페이스를 호출하면 11월 1일의 월별 데이터(즉, 11월의 월별 데이터)를 얻을 수 있습니다.

인터페이스 호출 요청 설명

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

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

Call 매개 변수 설명

end_date

반환 지침

메시지 전송 개요 데이터 인터페이스를 얻으려면 해당 인터페이스 주소를 호출하고 다음 데이터 패킷을 POST해야 합니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "msg_type": 1, 
           "msg_user": 282, 
           "msg_count": 817
       }
	//后续还有同一ref_date的不同msg_type的数据,以及不同ref_date(在时间范围内)的数据
   ]
}

메시지 배포 시간 공유 데이터 인터페이스를 얻으려면 해당 인터페이스 주소를 입력하고 다음 데이터 패킷을 POST합니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 0, 
           "msg_type": 1, 
           "msg_user": 9, 
           "msg_count": 10
       }
	//后续还有同一ref_hour的不同msg_type的数据,以及不同ref_hour的数据,ref_date固定,因为最大时间跨度为1
   ]
}

Get 메시지 전송 주간 데이터 인터페이스의 반환 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-08", 
           "msg_type": 1, 
           "msg_user": 16, 
           "msg_count": 27
       }
		//后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据
   ]
}

메시지 전송 월간 데이터 인터페이스의 반환 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-11-01", 
           "msg_type": 1, 
           "msg_user": 7989, 
           "msg_count": 42206
       }
	//后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据
   ]
}

메시지 전송 분산 데이터 인터페이스의 반환 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据
   ]
}

메시지 전송 가져오기 분산 주간 데이터 인터페이스의 반환 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据
   ]
}

메시지를 가져오고 반환된 내용을 보냅니다. 분산 월간 데이터 인터페이스의 JSON 데이터 패킷은 다음과 같습니다.

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据
   ]
}

Return 매개 변수 설명

매개변수 가 필수인가요? 설명
access_token통화 인터페이스 자격 증명
begin_date은 데이터를 가져오는 시작 날짜입니다. gin_date와 gin_date의 차이점 end_date는 "최대 시간 범위"보다 작아야 합니다. 예를 들어 최대 시간 범위가 1인 경우 start_date와 end_date의 차이는 0에서 1보다 작아야 합니다. 그렇지 않으면 오류가 보고됩니다.
데이터 가져오기의 종료 날짜입니다. end_date 허용되는 최대 값은 어제입니다
msg_usermsg_countcount_intervalint_page_read_countori_page_read_user입니다.

오류가 발생하면 WeChat은 오류 코드 및 기타 정보를 반환합니다. 특정 오류 코드 문의는 전역 반환 코드 설명

을 참조하세요.
매개변수 설명
ref_date데이터의 날짜는 start_date와 end_date 사이여야 합니다.
ref_hour데이터의 시간은 각각 [00을 나타냅니다. 0, 1 00) ~ [2300,2400), 즉 매일의 첫 번째 시간과 마지막 시간
msg_type 메시지 유형의 의미는 다음과 같습니다.

1은 텍스트를 나타냅니다. 2는 그림을 나타냅니다. 3은 음성을 나타냅니다. 4 비디오 6은 타사 애플리케이션을 나타냅니다. 메시지(링크 메시지)

업스트림으로 메시지를 보낸 사용자 수(공개 계정으로 전송)
전송된 총 메시지 수 upstream
당일 발송 메시지량 분포 간격, 0은 '0', 1은 '1~5', 2는 '6~10', 3은 '10회 이상'을 의미
이미지와 텍스트 페이지를 읽은 횟수
원본 페이지(이미지 페이지에서 "원본 읽기"를 클릭하여 입력한 페이지)의 독자 수입니다. 원본 페이지가 없을 경우 여기의 데이터는 0