データの取り込みとデータ スキーマ

このページでは、Telecom Subscriber Insights で使用可能なデータ取り込みのタイプとデータスキーマについて説明します。

Telecom Subscriber Insights は、2 種類のデータ取り込みと複数のデータスキーマを提供します。データスキーマに準拠したデータセットを提示すると、Telecom Subscriber Insights は提供されたデータを使用して顧客向けの提案を作成します。

データ取り込みのタイプ

Telecom Subscriber Insights では、次の種類のデータ取り込みが可能です。

• 使用量とアカウントの概要データ。Telecom Subscriber Insights では、使用状況データとアカウントの概要データを定期的に更新する必要があります。使用状況とアカウントの概要データは、リアルタイム、準リアルタイム、または定期的に取り込むことができます。リアルタイム データまたはほぼリアルタイム データは、初期設定の手順で構成された Pub/Sub トピックにパブリッシュされます。使用状況とアカウントの概要データは、通常 1 日 1 回、定期的にプッシュすることもできます。これは、初期設定時に構成された Cloud Storage バケットにデータを書き込むことで実現されます。

• データプランのステータス。Telecom Subscriber Insights では、各サブスクライバーの現在のデータプランのステータスに関する情報も必要です。このデータは、Google Mobile Data Plan Sharing API を使用して Telecom Subscriber Insights と共有されます。

データテーブル

次のセクションでは、Telecom Subscriber Insights にデータを push するために使用できる Telecom Subscriber Insights のテーブルとスキーマについて説明します。データを push する前に、データセットが次のセクションで説明するスキーマに準拠していることを確認してください。

利用可能なデータセット

次の表に、Telecom Subscriber Insights で使用可能なデータセット テーブルを示します。

データセット名とスキーマリンク	定義
使用状況レコード	特定のプランの加入者の使用状況の記録と残高履歴のスナップショット。
アカウントの概要	定期購入者のアカウントと購入したプランの概要。
CPID イベント	CPID サーバーが構成されている場合、携帯通信会社プラン ID（CPID）ごとに記録されるイベント。

データセット スキーマの定義

以降のセクションでは、Telecom Subscriber Insights で使用可能な各テーブルのスキーマ定義について説明します。

使用状況レコード

[
  {
    "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;
}

---