Ingestão e esquemas de dados

Nesta página, descrevemos os tipos de ingestão de dados e os esquemas de dados disponíveis para o Telecom Subscriber Insights.

O Telecom Subscriber Insights oferece dois tipos de ingestão de dados e vários esquemas de dados. Você apresenta conjuntos de dados que estão em conformidade com os esquemas de dados, e o Telecom Subscriber Insights usa os dados fornecidos para criar ofertas para seus clientes.

Tipos de ingestão de dados

Os insights de assinantes de telecomunicações oferecem os seguintes tipos de ingestão de dados:

• Dados de uso e resumo da conta. O Telecom Subscriber Insights exige atualizações regulares dos dados de uso e do resumo da conta. Os dados de uso e resumo da conta podem ser ingeridos em tempo real, quase em tempo real ou periodicamente. Os dados em tempo real ou quase em tempo real são publicados em um tópico do Pub/Sub configurado durante as etapas de configuração inicial. Os dados de uso e do resumo da conta também podem ser enviados periodicamente, geralmente uma vez por dia. Isso é feito gravando os dados em um bucket do Cloud Storage configurado durante a configuração inicial.

• Status do plano de dados. O Telecom Subscriber Insights também exige informações sobre o status atual do plano de dados de cada assinante. Esses dados são compartilhados com o Telecom Subscriber Insights usando a API Google Mobile Data Plan Sharing.

Tabela de dados

A seção a seguir descreve as tabelas e os esquemas do Telecom Subscriber Insights que podem ser usados para enviar dados ao produto. Antes de enviar dados, verifique se os conjuntos de dados estão de acordo com os esquemas descritos nas seções a seguir.

Conjuntos de dados disponíveis

A tabela a seguir descreve as tabelas de conjuntos de dados disponíveis no Telecom Subscriber Insights.

Nome do conjunto de dados e link do esquema	Definição
Registros de uso	Um snapshot dos registros de uso do assinante e do histórico de saldo de um determinado plano.
Resumo da conta	Um resumo das contas de assinantes e dos planos que eles compraram.
Eventos de CPID	Eventos registrados por identificador de plano da operadora (CPID, na sigla em inglês) se você tiver um servidor CPID configurado.

Definições de esquema do conjunto de dados

As seções a seguir descrevem as definições de esquema para cada uma das tabelas disponíveis do Telecom Subscriber Insights.

Registros de uso

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

---

Resumo da conta

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

---

Eventos de CPID

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

---