Importazione e schemi dei dati

Questa pagina descrive i tipi di importazione dati e gli schemi dei dati disponibili per Telecom Subscriber Insights.

Telecom Subscriber Insights offre due tipi di importazione dati e diversi schemi di dati. Presenti set di dati conformi agli schemi dei dati e poi Telecom Subscriber Insights utilizza i dati che fornisci per creare offerte per i tuoi clienti.

Tipi di importazione dati

Telecom Subscriber Insights offre i seguenti tipi di importazione dati:

• Dati di utilizzo e riepilogo dell'account. Telecom Subscriber Insights richiede aggiornamenti regolari dei dati di utilizzo e dei dati di riepilogo dell'account. I dati di utilizzo e del riepilogo dell'account possono essere importati in tempo reale, quasi in tempo reale o periodicamente. I dati in tempo reale o quasi in tempo reale vengono pubblicati in un argomento Pub/Sub configurato durante i passaggi di configurazione iniziali. I dati di riepilogo dell'utilizzo e dell'account possono anche essere inviati periodicamente, in genere una volta al giorno, e questo viene eseguito scrivendo i dati in un bucket Cloud Storage configurato durante la configurazione iniziale.

• Stato del piano dati. Telecom Subscriber Insights richiede anche informazioni sullo stato attuale del piano dati di ogni abbonato. Questi dati vengono condivisi con Telecom Subscriber Insights utilizzando l'API Google Mobile Data Plan Sharing.

Tabelle dati

La sezione seguente descrive le tabelle e gli schemi di Telecom Subscriber Insights che puoi utilizzare per inviare dati a Telecom Subscriber Insights. Prima di eseguire il push dei dati, assicurati che i tuoi set di dati siano conformi agli schemi descritti nelle sezioni seguenti.

Set di dati disponibili

La tabella seguente descrive le tabelle dei set di dati disponibili in Telecom Subscriber Insights.

Nome del set di dati e link allo schema	Definizione
Record di utilizzo	Uno snapshot dei record di utilizzo degli abbonati e della cronologia del saldo di un determinato piano.
Riepilogo dell'account	Un riepilogo degli account abbonati e dei piani che hanno acquistato.
Eventi CPID	Eventi registrati per identificatore del piano dell'operatore (CPID) se hai un server CPID configurato.

Definizioni dello schema del set di dati

Le sezioni seguenti descrivono le definizioni dello schema per ciascuna delle tabelle disponibili per Telecom Subscriber Insights.

Record di utilizzo

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

---

Riepilogo account

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

---

Eventi CPID

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

---