Transferencia y esquemas de datos

En esta página, se describen los tipos de transferencia de datos y los esquemas de datos disponibles para Telecom Subscriber Insights.

Telecom Subscriber Insights ofrece dos tipos de transferencia de datos y varios esquemas de datos. Presentas conjuntos de datos que se ajustan a los esquemas de datos y, luego, Telecom Subscriber Insights usa los datos que proporcionas para crear ofertas para tus clientes.

Tipos de transferencia de datos

Las Estadísticas de suscriptores de Telecom ofrecen los siguientes tipos de transferencia de datos:

• Datos de uso y resumen de la cuenta Telecom Subscriber Insights requiere actualizaciones periódicas de los datos de uso y los datos de resumen de la cuenta. Los datos de uso y del resumen de la cuenta se pueden transferir en tiempo real, casi en tiempo real o de forma periódica. Los datos en tiempo real o casi en tiempo real se publican en un tema de Pub/Sub que se configura durante los pasos de configuración inicial. Los datos de uso y del resumen de la cuenta también se pueden enviar periódicamente, por lo general, una vez al día. Esto se logra escribiendo los datos en un bucket de Cloud Storage que se configura durante la configuración inicial.

• Estado del plan de datos. Telecom Subscriber Insights también requiere información sobre el estado actual del plan de datos de cada suscriptor. Estos datos se comparten con Telecom Subscriber Insights a través de la API de Google Mobile Data Plan Sharing.

Tablas de datos

En la siguiente sección, se describen las tablas y los esquemas de Estadísticas de suscriptores de telecomunicaciones que puedes usar para enviar datos a Estadísticas de suscriptores de telecomunicaciones. Antes de enviar los datos, asegúrate de que tus conjuntos de datos cumplan con los esquemas que se describen en las siguientes secciones.

Conjuntos de datos disponibles

En la siguiente tabla, se describen las tablas de conjuntos de datos disponibles en Telecom Subscriber Insights.

Nombre del conjunto de datos y vínculo al esquema	Definición
Registros de uso	Es una instantánea de los registros de uso de los suscriptores y el historial de saldo de un plan determinado.
Resumen de la cuenta	Un resumen de las cuentas de suscriptores y los planes que compraron.
Eventos de CPID	Eventos registrados por identificador de plan de operador (CPID) si tienes un servidor de CPID configurado

Definiciones del esquema del conjunto de datos

En las siguientes secciones, se describen las definiciones de esquema para cada una de las tablas disponibles en 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."
  }
]

---

Resumen de la cuenta

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

---