파트너 센터 분석 - 리소스
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
Analytics API를 사용하면 사용자 환경에 표시되는 데이터에 프로그래밍 방식으로 액세스할 수 있습니다.
필수 조건
- 자격 증명(파트너 센터 인증에서 설명). 이러한 시나리오는 사용자 자격 증명으로만 인증을 지원합니다.
CSP 프로그램: Azure 사용 현황 분석
다음 시나리오에서는 Analytics API를 사용하여 모든 파트너 센터 Azure 사용 현황 분석 정보를 검색하는 방법을 보여 줍니다.
이 시나리오는 Azure 사용량 리소스 컬렉션에서 분석 정보를 반환합니다.
Azure 사용량 리소스
Azure 사용량에 대한 모든 분석 데이터를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| CustomerTenantId | string | 고객 테넌트 식별자입니다. |
| customerName | string | 고객 이름입니다. |
| subscriptionId | string | 구독 식별자입니다. |
| subscriptionName | string | 구독 이름입니다. |
| usageDate | string | 사용 날짜입니다. |
| resourceLocation | string | 예를 들어 데이터 센터, 서유럽의 위치입니다. |
| meterCategory | string | 예를 들어 미터 범주, 데이터 관리입니다. |
| meterSubcategory | string | 미터 하위 범주(예: 지역 중복)입니다. |
| meterUnit | string | 미터 단위(예: 기가바이트 또는 시간)입니다. |
| reservationOrderId | string | Azure VM Reserved Instance에 대한 예약 순서입니다. |
| reservationId | string | 특정 RI 순서에 따라 예약된 인스턴스입니다. |
| serviceType | string | 가상 머신 유형을 나타냅니다. 예를 들어 Standard_E4s_v3. |
| quantity | long | 미터 단위에 사용되는 숫자를 나타냅니다. |
CSP 프로그램: 간접 재판매인 분석
다음 시나리오에서는 Analytics API를 사용하여 모든 파트너 센터 간접 재판매인 분석 정보를 검색하는 방법을 보여 줍니다.
이 시나리오는 간접 재판매인 리소스 컬렉션에서 분석 정보를 반환합니다.
간접 재판매인 리소스
간접 재판매인에 대한 모든 분석 데이터를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| partnerTenantId | string | 간접 재판매인 데이터를 검색하려는 파트너의 테넌트 ID입니다. |
| id | string | 간접 재판매인 ID입니다. |
| name | string | 간접 재판매인 데이터를 검색할 파트너의 이름입니다. |
| market | string | 간접 재판매인 데이터를 검색하려는 파트너의 시장입니다. |
| firstSubscriptionCreationDate | UTC 날짜/시간 형식의 문자열 | 간접 재판매인 데이터를 검색하려는 첫 번째 구독의 생성 날짜입니다. |
| latestSubscriptionCreationDate | UTC 날짜/시간 형식의 문자열 | 최신 구독의 생성 날짜입니다. |
| firstSubscriptionEndDate | UTC 날짜/시간 형식의 문자열 | 처음으로 구독이 종료되었습니다. |
| latestSubscriptionEndDate | UTC 날짜/시간 형식의 문자열 | 구독이 종료된 최신 날짜입니다. |
| firstSubscriptionSuspendedDate | UTC 날짜/시간 형식의 문자열 | 처음으로 구독이 일시 중단되었습니다. |
| latestSubscriptionSuspendedDate | UTC 날짜/시간 형식의 문자열 | 구독이 일시 중단된 최신 날짜입니다. |
| firstSubscriptionDeprovisionedDate | UTC 날짜/시간 형식의 문자열 | 처음으로 구독 프로비전을 해제했습니다. |
| latestSubscriptionDeprovisionedDate | UTC 날짜/시간 형식의 문자열 | 구독이 프로비전 해제된 최신 날짜입니다. |
| subscriptionCount | double | 모든 부가 가치 재판매인의 구독 수 |
| licenseCount | double | 모든 부가 가치 재판매인의 라이선스 수 |
| indirectResellerCount | double | 간접 재판매인 수 |
CSP 프로그램: 구독 분석
다음 시나리오에서는 Analytics API를 사용하여 모든 파트너 센터 구독 분석 정보를 검색하거나, 검색 쿼리로 필터링하거나, 날짜 또는 용어별로 그룹화하는 방법을 보여 줍니다.
이러한 모든 시나리오는 구독 리소스 컬렉션에서 분석 정보를 반환합니다.
구독 리소스
구독에 대한 모든 분석 데이터를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| customerTenantId | string | 고객 테넌트를 식별하는 GUID 형식 문자열입니다. |
| customerName | string | 고객 이름입니다. |
| customerMarket | string | 고객이 비즈니스를 수행하는 국가/지역입니다. |
| id | string | 구독 식별자입니다. |
| status | string | 구독 상태: "ACTIVE", "SUSPENDED" 또는 "DEPROVISIONED"입니다. |
| productName | string | 제품의 이름입니다. |
| subscriptionType | string | 구독 유형입니다. 참고: 이 필드는 대/소문자를 구분합니다. 지원되는 값은 "Office", "Azure", "Microsoft365", "Dynamics", "EMS"입니다. |
| autoRenewEnabled | 부울 값 | 구독이 자동으로 갱신되는지 여부를 나타내는 값입니다. |
| partnerId | string | PartnerID입니다. 직접 재판매인의 경우 이 매개 변수는 파트너의 PartnerID입니다. 간접 재판매인의 경우 이 매개 변수는 간접 재판매인의 PartnerID입니다. |
| friendlyName | string | 구독 이름입니다. |
| partnerName | string | 구독을 구매한 파트너의 이름 |
| providerName | string | 간접 재판매인에 대한 구독 트랜잭션인 경우 공급자 이름은 구독을 구입한 간접 공급자입니다. |
| effectiveStartDate | UTC 날짜/시간 형식의 문자열 | 구독이 시작되는 날짜입니다. |
| commitmentEndDate | UTC 날짜/시간 형식의 문자열 | 구독이 종료되는 날짜입니다. |
| currentStateEndDate | UTC 날짜/시간 형식의 문자열 | 구독의 현재 상태 변경되는 날짜입니다. |
| trialToPaidConversionDate | UTC 날짜/시간 형식의 문자열 | 구독이 평가판에서 유료로 변환되는 날짜입니다. 기본값은 null합니다. |
| trialStartDate | UTC 날짜/시간 형식의 문자열 | 구독의 평가판 기간이 시작된 날짜입니다. 기본값은 null합니다. |
| trialEndDate | UTC 날짜/시간 형식의 문자열 | 구독의 평가 기간이 종료되는 날짜입니다. 기본값은 null합니다. |
| lastUsageDate | UTC 날짜/시간 형식의 문자열 | 구독이 마지막으로 사용된 날짜입니다. 기본값은 null합니다. |
| deprovisionedDate | UTC 날짜/시간 형식의 문자열 | 구독 프로비전을 해제한 날짜입니다. 기본값은 null합니다. |
| lastRenewalDate | UTC 날짜/시간 형식의 문자열 | 구독이 마지막으로 갱신된 날짜입니다. 기본값은 null합니다. |
| licenseCount | 번호 | 총 라이선스 수입니다. |
| subscriptionCount | 번호 | 구독 수입니다. 참고: 이 값은 집계 쿼리의 응답에만 표시됩니다. |
검색 분석
참고 항목
검색 분석을 가져오는 데 CSP 프로그램 멤버 자격은 필요하지 않습니다.
다음 시나리오에서는 Analytics API를 사용하여 모든 파트너 센터 검색 분석 정보를 검색하는 방법을 보여 줍니다.
이 시나리오는 검색 리소스 컬렉션 에서 분석 정보를 반환합니다.
리소스 검색
검색에 대한 모든 분석 데이터를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| companyName | string | 청구 회사 이름입니다. |
| contactButtonClicked | 부울 | 연락처 단추를 클릭했는지를 나타냅니다. |
| 키워드(keyword)Country | string | 검색에 지정된 국가/지역입니다. |
| detailsViewed | 부울 | 검색 세부 정보가 표시되었는지를 나타냅니다. |
| 키워드(keyword)IndustryFocus | string | 의료와 같이 검색할 업계입니다. |
| partnerId | string | PartnerID입니다. 직접 재판매인의 경우 이 매개 변수는 파트너의 PartnerID입니다. 간접 재판매인의 경우 이 매개 변수는 간접 재판매인의 PartnerID입니다. |
| partnerMarket | string | 파트너가 비즈니스를 수행하는 로캘입니다. |
| 키워드(keyword)프로덕트 | string | 검색에 지정된 제품입니다. |
| referralSubmitted | 부울 | 조회가 제출되었는지를 나타냅니다. |
| searchDate | UTC 날짜/시간 형식의 문자열 | 검색 쿼리가 발생한 날짜입니다. |
| 키워드(keyword)SearchText | string | 검색에 지정된 텍스트입니다. |
| searchResultPageViews | long | 파트너가 검색 결과에 나온 횟수입니다. 집계에서만 응답의 일부입니다. |
| contactClicks | long | 연락처 단추를 클릭한 횟수입니다. 집계에서만 응답의 일부입니다. |
| referralCount | long | 검색에서 생성된 조회 수입니다. 집계에서만 응답의 일부입니다. |
| profileViews | long | 파트너 프로필을 본 횟수입니다. 집계에서만 응답의 일부입니다. |
조회 분석
참고 항목
CSP 프로그램 멤버 자격은 조회 분석을 가져오는 데 필요하지 않습니다.
다음 시나리오에서는 Analytics API를 사용하여 모든 파트너 센터 조회 분석 정보를 검색하는 방법을 보여 줍니다.
이 시나리오는 조회 리소스 컬렉션에서 분석 정보를 반환합니다.
참고 항목
추천 분석은 21Vianet에서 운영하는 파트너 센터에서 사용할 수 없습니다.
조회 리소스
조회에 대한 모든 분석 데이터를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| id | string | 고객 테넌트 식별자입니다. |
| status | string | 조회가 고객으로 이어졌는지를 나타냅니다. |
| customerMarket | string | 고객이 비즈니스를 수행하는 국가/지역입니다. |
| customerName | string | 고객 이름입니다. |
| customerOrgSize | string | 고객 조직의 직원 수를 나타내는 범위입니다. 예를 들어 "10to50employees"입니다. |
| acceptedDate | UTC 날짜/시간 형식의 문자열 | 추천이 수락된 날짜입니다. |
| acknowledgedDate | UTC 날짜/시간 형식의 문자열 | 추천이 승인된 날짜입니다. |
| archivedDate | UTC 날짜/시간 형식의 문자열 | 추천이 보관된 날짜입니다. |
| declinedDate | UTC 날짜/시간 형식의 문자열 | 추천이 거절된 날짜입니다. |
| expiredDate | UTC 날짜/시간 형식의 문자열 | 조회가 만료된 날짜입니다. |
| lostDate | UTC 날짜/시간 형식의 문자열 | 추천이 손실된 날짜입니다. |
| missedDate | UTC 날짜/시간 형식의 문자열 | 추천을 놓친 날짜입니다. |
| createdDate | UTC 날짜/시간 형식의 문자열 | 조회가 만들어진 날짜입니다. |
| skippedDate | UTC 날짜/시간 형식의 문자열 | 추천을 건너뛴 날짜입니다. |
| wonDate | UTC 날짜/시간 형식의 문자열 | 추천을 획득한 날짜입니다. |
| partnerMarket | string | 파트너가 비즈니스를 수행하는 국가/지역입니다. |