​ テレコム サブスクリプション ​ データ型

​ テレコム サブスクリプション ​は、インターネット、モバイル、メディア、固定電話など、特定のテレコミュニケーション サブスクリプション タイプの詳細を説明する標準のExperience Data Model (XDM) データ型です。

NOTE
このドキュメントでは、データタイプについて説明します。 同じ名前のフィールドグループについては、​ テレコム サブスクリプション ​ フィールドグループ参照ガイド ​を参照してください。
通信業界とは関係のないサブスクリプションタイプを記述する場合は、代わりに汎用​ サブスクリプション ​ データタイプ ​を使用してください。

​ テレコム サブスクリプション構造

プロパティ
データタイプ
説明
devices
オブジェクトの配列
プランに関連付けられているデバイスやアクセサリのリストを示します。 各配列項目の想定される構造について詳しくは、以下のを参照してください。
subscriber
​ ユーザー
サブスクリプションの所有者を説明します。
ID
文字列
サブスクリプションインスタンスの一意のID。
billingPeriod
文字列
請求の間隔。
billingStartDate
日付
請求期間が開始される日付。 日付の形式(時間なし)は、ISO 8601標準(yyyy-MM-dd)に従う必要があります。
chargeMethod
文字列
顧客に請求する方法。
contractID
文字列
このサブスクリプションを管理する契約の一意のID。
country
文字列
サブスクリプションの契約条件と契約条件が適用される国。
endDate
日付
現在の購読期間終了日。 日付の形式(時間なし)は、ISO 8601標準(yyyy-MM-dd)に従う必要があります。
paymentDueDate
日付
サブスクリプションの支払い期日。 日付の形式(時間なし)は、ISO 8601標準(yyyy-MM-dd)に従う必要があります。
paymentMethod
文字列
定期支払の支払方法。
paymentStatus
文字列
アカウントの支払い状況。
planName
文字列
サブスクリプションの人間が読みやすい名前。
reason
文字列
サブスクリプションの使用に対するメンバーの一般的な意図。
renew
文字列
購読が終了日後も継続するという合意された方法。
startDate
日付
購読開始日。 日付の形式(時間なし)は、ISO 8601標準(yyyy-MM-dd)に従う必要があります。
status
文字列
サブスクリプションの現在のステータス。
subscriptionCategory
文字列
この種類のサブスクリプションの主要なトップレベルのカテゴリです。
subscriptionSKU
文字列
サブスクリプションの在庫保管単位(SKU)。
subscriptionSubCategory
文字列
サブスクリプションの特定のサブカテゴリー。
term
整数
サブスクリプション期間の数値。
termUnitOfTime
文字列
期間の時間の単位。
topUp
文字列
サブスクリプションの消耗品が請求期間中にどのように再購入されるかについて合意された条件を説明します。
type
文字列
サブスクリプションの対象人数に関する使用権限の範囲。

データタイプについて詳しくは、パブリック XDM リポジトリを参照してください。

devices devices

devicesはオブジェクトの配列で、各オブジェクトはサブスクリプションに関連付けられたデバイスまたはアクセサリを表します。

​ デバイス配列構造

プロパティ
データタイプ
説明
deviceFees
オブジェクト

ルータ、モデム、レシーバなどの項目に対するデバイス料金をキャプチャするオブジェクト。 次のプロパティが必要です。

  • amount: currencyCodeで表される金額。
  • conversionDate:通貨換算が行われた日付。
  • currencyCode: amountISO 4217通貨コード
ID
文字列
デバイスの一意のID。
OS
文字列
デバイスのオペレーティングシステム。
deviceInsurance
文字列
顧客がこのデバイスの保険にオプトインしたかどうかを示します。
manufacturer
文字列
デバイスの製造元。
name
文字列
デバイスの名前。
paymentOptions
文字列
デバイスが分割払いまたは全小売価格で支払われるかどうかを示します。
serialNumber
文字列
デバイスのシリアル番号。
status
文字列
デバイスステータス。
storageCapacity
文字列
デバイスのストレージ容量。
type
文字列
デバイスタイプ。
recommendation-more-help
experience-platform-help-xdm