アプリ内購入モジュール
アプリ内購入モジュールは、アプリ内購入の自動追跡をアプリに追加します。
アプリ内購入とは何ですか?
アプリ内購入とは、アプリ内で購入する追加コンテンツ、サービス、またはサブスクリプションのことを指します。アプリ内購入の例としては以下のようなものがあります:
- 広告の削除のためのアップグレード
- ゲームクレジット
- バーチャル通貨
- 追加のゲームレベル
- さらなる機能の解放
アプリ内購入とはみなされない購入の例としては以下のようなものがあります:
- 電子商取引アプリでの衣服やその他のアイテムの購入。
- Apple Payを使用して購入を完了する。
Apple開発者ポータルのアプリ内購入について詳しく学びましょう。
インストール
Swift Package Manager、CocoaPods、またはCarthageを使用してアプリ内購入モジュールをインストールします。
Swift Package Manager (推奨)
Tealium Swiftライブラリをインストールする推奨方法はSwift Package Managerです:
- Xcodeプロジェクトで、File > Swift Packages > Add Package Dependencyを選択します。
- リポジトリURLを入力します:
https://github.com/tealium/tealium-swift
。 - バージョンルールを構成します。デフォルトの
"Up to next major"
が推奨されます。現在のTealium Swiftライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットします。 - インストールするモジュールのリストから
InAppPurchase
モジュールを選択します。Xcodeプロジェクトの各アプリターゲットのFrameworks > Libraries & Embedded Contentにモジュールを追加します。
iOSのSwift Package Managerインストールについて詳しく学びましょう。
CocoaPods
CocoaPodsを使用してアプリ内購入モジュールをインストールするには、以下のpodをPodfileに追加します:
pod 'tealium-swift/InAppPurchase'
iOSのCocoaPodsインストールについて詳しく学びましょう。
Carthage
Carthageを使用してアプリ内購入モジュールをインストールするには、以下の手順を実行します:
- XcodeでターゲットアプリのGeneral構成ペインに移動します。
- 次のフレームワークをEmbedded Binariesセクションに追加します:
TealiumInAppPurchase.xcframework
- アプリ内購入ライブラリをインポートするには、プロジェクトに次のインポート文を追加します:
import TealiumInAppPurchase
iOSのCarthageインストールについて詳しく学びましょう。
構成
アプリ内購入モジュールをインスタンス化するには、SDKを初期化する際にTealiumConfig
オブジェクトで指定する必要があります:
import TealiumCore
import TealiumInAppPurchase
let config = TealiumConfig(account: "ACCOUNT",
profile: "PROFILE",
environment: "ENVIRONMENT",
datasource: "DATASOURCE")
config.collectors = [Collectors.InAppPurchase]
tealium = Tealium(config: config) { _ in }
必要なコレクターを正しく指定する方法については、Collectorsのドキュメンテーションを参照してください。
データレイヤー
アプリ内購入モジュールは、イベントで以下の属性を送信します:
変数 | 説明 | 例 |
---|---|---|
purchase_order_id |
購入の注文ID。 | “1234567890” |
purchase_timestamp |
ISO 8601形式の購入のタイムスタンプ。 | “2022-01-17T14:42:28Z” |
purchase_quantity |
購入したアイテムの総数。 | “1” |
purchase_skus |
購入した製品IDの配列。 | [“com.example.level1”] |
autotracked |
イベントが自動的に追跡されたことを示すためにtrue に構成します。 |
true |
tealium_event |
イベントの名前。 | “in_app_purchase” |
最終更新日 :: 2024年March月29日