Datenaufnahme und Datenschemas

Auf dieser Seite werden die Arten der Datenerfassung und die für Telecom Subscriber Insights verfügbaren Datenschemas beschrieben.

Telecom Subscriber Insights bietet zwei Arten der Datenerfassung und mehrere Datenschemas. Sie stellen Datasets bereit, die den Datenschemas entsprechen. Telecom Subscriber Insights verwendet dann die von Ihnen bereitgestellten Daten, um Angebote für Ihre Kunden zu erstellen.

Arten der Datenaufnahme

Für Telecom Subscriber Insights sind die folgenden Arten der Datenerfassung verfügbar:

Nutzungs- und Kontoübersichtsdaten: Für Telecom Subscriber Insights sind regelmäßige Aktualisierungen der Nutzungsdaten und der Kontoübersichtsdaten erforderlich. Nutzungs- und Kontoübersichtsdaten können in Echtzeit, nahezu in Echtzeit oder regelmäßig aufgenommen werden. Echtzeitdaten oder Daten in nahezu Echtzeit werden in einem Pub/Sub-Thema veröffentlicht, das bei der Ersteinrichtung konfiguriert wird. Die Nutzungs- und Kontoübersichtsdaten können auch regelmäßig, in der Regel einmal täglich, übertragen werden. Dazu werden die Daten in einen Cloud Storage-Bucket geschrieben, der bei der Ersteinrichtung konfiguriert wird.
Status des Datentarifs: Für Telecom Subscriber Insights sind auch Informationen zum aktuellen Datenvolumenstatus jedes Abonnenten erforderlich. Diese Daten werden über die Google Mobile Data Plan Sharing API an Telecom Subscriber Insights weitergegeben.

Datentabellen

Im folgenden Abschnitt werden die Tabellen und Schemas für Telecom Subscriber Insights beschrieben, mit denen Sie Daten in Telecom Subscriber Insights übertragen können. Bevor Sie Daten übertragen, müssen Sie dafür sorgen, dass Ihre Datasets den in den folgenden Abschnitten beschriebenen Schemas entsprechen.

Verfügbare Datasets

In der folgenden Tabelle werden die Dataset-Tabellen beschrieben, die in Telecom Subscriber Insights verfügbar sind.

Dataset-Name und Schemalink	Definition
Nutzungsdatensätze	Ein Snapshot der Nutzungsdatensätze und des Guthabenverlaufs eines bestimmten Tarifs.
Kontoübersicht	Eine Zusammenfassung der Abonnentenkonten und der Abos, die sie erworben haben.
CPID-Ereignisse	Ereignisse, die pro CPID (Carrier Plan Identifier) protokolliert werden, wenn Sie einen konfigurierten CPID-Server haben.

Dataset-Schemadefinitionen

In den folgenden Abschnitten werden die Schemadefinitionen für die einzelnen verfügbaren Tabellen für Telecom Subscriber Insights beschrieben.

Nutzungsdatensätze

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

Kontoübersicht

[
  {
    "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-Ereignisse

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

Datenaufnahme und Datenschemas Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.