데이터 수집 및 데이터 스키마

이 페이지에서는 통신 구독자 통계에 사용할 수 있는 데이터 수집 유형과 데이터 스키마를 설명합니다.

Telecom Subscriber Insights는 두 가지 유형의 데이터 수집과 여러 데이터 스키마를 제공합니다. 데이터 스키마를 준수하는 데이터 세트를 제공하면 통신 구독자 통계에서 제공된 데이터를 사용하여 고객에게 제공할 혜택을 만듭니다.

데이터 수집 유형

Telecom Subscriber Insights는 다음과 같은 유형의 데이터 수집을 제공합니다.

• 사용량 및 계정 요약 데이터. Telecom Subscriber Insights를 사용하려면 사용 데이터와 계정 요약 데이터를 정기적으로 업데이트해야 합니다. 사용량 및 계정 요약 데이터는 실시간, 준실시간 또는 주기적으로 수집할 수 있습니다. 실시간 데이터 또는 거의 실시간 데이터는 초기 설정 단계 중에 구성된 Pub/Sub 주제에 게시됩니다. 사용량 및 계정 요약 데이터는 일반적으로 하루에 한 번씩 주기적으로 푸시될 수도 있으며, 이는 초기 설정 중에 구성된 Cloud Storage 버킷에 데이터를 작성하여 이루어집니다.

• 데이터 요금제 상태. 통신 구독자 통계에는 각 구독자의 현재 데이터 요금제 상태에 관한 정보도 필요합니다. 이 데이터는 Google Mobile Data Plan Sharing API를 사용하여 Telecom Subscriber Insights와 공유됩니다.

데이터 표

다음 섹션에서는 통신 구독자 통계에 데이터를 푸시하는 데 사용할 수 있는 통신 구독자 통계 테이블과 스키마를 설명합니다. 데이터를 푸시하기 전에 데이터 세트가 다음 섹션에 설명된 스키마를 준수하는지 확인하세요.

사용 가능한 데이터 세트

다음 표에서는 Telecom Subscriber Insights에서 사용할 수 있는 데이터 세트 테이블을 설명합니다.

데이터 세트 이름 및 스키마 링크	정의
사용 기록	특정 요금제의 구독자 사용 기록과 잔액 기록의 스냅샷입니다.
계정 요약	구독자 계정과 구매한 요금제의 요약입니다.
CPID 이벤트	구성된 CPID 서버가 있는 경우 이동통신사 요금제 식별자 (CPID)별로 로깅된 이벤트

데이터 세트 스키마 정의

다음 섹션에서는 통신 구독자 통계에 사용할 수 있는 각 테이블의 스키마 정의를 설명합니다.

사용 기록

[
  {
    "name": "sub_id",
    "type": "STRING",
    "mode": "REQUIRED",
    "description": "Subscriber identification. A privacy preserving subscriber identity for the subscriber."
  },
  {
    "name": "usage",
    "type": "RECORD",
    "mode": "REPEATED",
    "description": "It represents the current usage of the subscriber for a given plan.",
    "fields": [
      {
        "name": "plan_id",
        "type": "STRING",
        "mode": "REQUIRED",
        "description": "Unique plan identifier."
      },
      {
        "name": "current_usage",
        "type": "FLOAT",
        "mode": "NULLABLE",
        "description": "Describes the current usage of the plan. The unit is specified in usage_unit."
      },
      {
        "name": "usage_pct",
        "type": "FLOAT",
        "mode": "NULLABLE",
        "description": "Describes the percentage used of the allotment. Range: [0, 100]"
      },
      {
        "name": "allotted_usage",
        "type": "FLOAT",
        "mode": "NULLABLE",
        "description": "Describes the allotted usage of the plan. The unit is specified in usage_unit."
      },
      {
        "name": "start_date",
        "type": "TIMESTAMP",
        "mode": "NULLABLE",
        "description": "Plan start date."
      },
      {
        "name": "end_date",
        "type": "TIMESTAMP",
        "mode": "NULLABLE",
        "description": "Plan end date."
      },
      {
        "name": "usage_unit",
        "type": "STRING",
        "mode": "NULLABLE",
        "description": "Describes the unit of measure: messages, minutes, bytes."
      }
    ]
  },
  {
    "name": "qoe_metrics",
    "type": "RECORD",
    "mode": "NULLABLE",
    "description": "Describes the quality of experience of the subscriber.",
    "fields": [
      {
        "name": "uptime",
        "type": "INTEGER",
        "mode": "NULLABLE",
        "description": "How long the user has been connected to the network without interruption in seconds."
      },
      {
        "name": "network_score",
        "type": "FLOAT",
        "mode": "NULLABLE",
        "description": "The quality of the network network_score out of 100."
      }
    ]
  },
  {
    "name": "update_time",
    "type": "TIMESTAMP",
    "mode": "REQUIRED",
    "description": "Timestamp when this record was updated."
  }
]

---

계정 요약

[
  {
    "name": "sub_id",
    "type": "STRING",
    "mode": "REQUIRED",
    "description": "Subscriber identification. A privacy preserving subscriber identity for the subscriber."
  },
  {
    "name": "purchased_plans",
    "type": "RECORD",
    "mode": "REPEATED",
    "description": "List of all the purchased plans for the subscriber.",
    "fields": [
      {
        "name": "plan_name",
        "type": "STRING",
        "mode": "NULLABLE",
        "description": "Plan name"
      },
      {
        "name": "plan_id",
        "type": "STRING",
        "mode": "REQUIRED",
        "description": "Unique identifier for the plan"
      },
      {
        "name": "plan_description",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "promo_message",
        "type": "STRING",
        "mode": "NULLABLE",
        "description": "Additional promotional message for the user."
      },
      {
        "name": "language_code",
        "type": "STRING",
        "mode": "NULLABLE",
        "description": "The BCP-47 language code, such as en-US or sr-Latn."
      },
      {
        "name": "max_rate_kbps",
        "type": "INTEGER",
        "mode": "NULLABLE",
        "description": "The maximum bandwidth that the plan offers to the user."
      },
      {
        "name": "cost",
        "type": "RECORD",
        "mode": "NULLABLE",
        "description": "Cost of the purchased plans.",
        "fields": [
          {
            "name": "currency_code",
            "type": "STRING",
            "mode": "NULLABLE",
            "description": "The three-letter currency code defined in ISO 4217."
          },
          {
            "name": "units",
            "type": "FLOAT",
            "mode": "NULLABLE",
            "description": "The value of the amount."
          }
        ]
      },
      {
        "name": "duration_minutes",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "quota_bytes",
        "type": "INTEGER",
        "mode": "NULLABLE",
        "description": "Package quota in bytes."
      },
      {
        "name": "quota_minutes",
        "type": "INTEGER",
        "mode": "NULLABLE",
        "description": "Package quota in minutes."
      },
      {
        "name": "buy_time",
        "type": "TIMESTAMP",
        "mode": "NULLABLE",
        "description": "Timestamp when the user bought this plan."
      }
    ]
  },
  {
    "name": "update_time",
    "type": "TIMESTAMP",
    "mode": "REQUIRED",
    "description": "Updated timestamp."
  }
]

---

CPID 이벤트

message CpidGenEvent {
  optional string cpid = 1;
  optional string sub_id = 2;
  optional string timestamp = 3;
}

---