Ingestion de données et schémas de données

Cette page décrit les types d'ingestion de données et les schémas de données disponibles pour Telecom Subscriber Insights.

Telecom Subscriber Insights propose deux types d'ingestion de données et plusieurs schémas de données. Vous présentez des ensembles de données conformes aux schémas de données, puis Telecom Subscriber Insights utilise les données que vous fournissez pour créer des offres pour vos clients.

Types d'ingestion de données

Telecom Subscriber Insights propose les types d'ingestion de données suivants :

• Données sur l'utilisation et récapitulatif du compte Telecom Subscriber Insights nécessite des mises à jour régulières des données d'utilisation et des données récapitulatives des comptes. Les données d'utilisation et de récapitulatif du compte peuvent être ingérées en temps réel, en temps quasi réel ou périodiquement. Les données en temps réel ou quasi temps réel sont publiées dans un sujet Pub/Sub configuré lors des étapes de configuration initiale. Les données d'utilisation et de récapitulatif du compte peuvent également être envoyées périodiquement, généralement une fois par jour. Pour ce faire, les données sont écrites dans un bucket Cloud Storage configuré lors de la configuration initiale.

• État du forfait de données. Telecom Subscriber Insights nécessite également des informations sur l'état actuel du forfait de données de chaque abonné. Ces données sont partagées avec Telecom Subscriber Insights à l'aide de l'API Google Mobile Data Plan Sharing.

Tables de données

La section suivante décrit les tableaux et les schémas Telecom Subscriber Insights que vous pouvez utiliser pour transférer des données vers Telecom Subscriber Insights. Avant d'envoyer des données, assurez-vous que vos ensembles de données sont conformes aux schémas décrits dans les sections suivantes.

Ensembles de données disponibles

Le tableau suivant décrit les tables de l'ensemble de données disponibles dans Telecom Subscriber Insights.

Nom de l'ensemble de données et lien vers le schéma	Définition
Enregistrements d'utilisation	Instantané des enregistrements d'utilisation des abonnés et de l'historique du solde d'un forfait donné.
Récapitulatif du compte	Récapitulatif des comptes d'abonnés et des forfaits qu'ils ont souscrits.
Événements CPID	Événements enregistrés par identifiant de forfait opérateur (CPID) si vous avez configuré un serveur CPID.

Définitions du schéma de l'ensemble de données

Les sections suivantes décrivent les définitions de schéma pour chacune des tables disponibles pour les insights sur les abonnés aux télécoms.

Enregistrements d'utilisation

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

---

Récapitulatif du compte

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

---

Événements CPID

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

---