サンキューページモバイル統合

サンキューページ（TYP）は、Eコマースパートナーが平均注文額を増加させるのに役立ちます。これは、購入者が支払い情報を再入力することなく関連商品を現在の注文に追加できるようにするためです。支払いページと確認ページの間に配置されるこのあまり活用されていない瞬間は、購入者が主要な取引を完了した直後に追加購入を検討する可能性が非常に高いため、追加購入を促す絶好の機会を提供します。

サンキューレイアウトは、購入アクションの直後、確認ページの直前に表示されるオーバーレイです。これは、取引を最終確定する前に追加購入を促す効果的な「最後のチャンス」のアップセル機会として機能します。

SDKの統合と初期化

Rokt SDKをアプリケーションに統合するには、iOS および Android の指示に従ってください。

TYPの表示

アプリケーションでTYPを表示するには、Rokt.execute関数を利用できます。これはiOSおよびAndroidのドキュメントで示されています。

カートアイテム(cartItem)とのユーザーインタラクションを認識する必要がある場合は、選択したプラットフォームに対応するRokt.executeWithEventsを使用して統合する必要があります。

Swift

Rokt.executeWithEvents(viewName: viewName,
                       attributes: attributes, 
        		   	   placements: placements,
                       onEvent: { event in
                			if let instancePurchase = event as CartItemInstantPurchase {
							// カートアイテムの詳細を使用して注文を処理し、追加の支払い額を取得する必要があります
            				}
            		   })

SwiftUI

RoktLayout(sdkTriggered: .constant(true),
           viewName: viewName,
           locationName: location,
           attributes: attributes) { roktEvent in
    if let instancePurchase = event as CartItemInstantPurchase {
        cartItemEvent = instancePurchase
        // カートアイテムの詳細を使用して注文を処理し、追加の支払い額を取得する必要があります
    }
}

Kotlin

Rokt.executeWithEvents(
	viewName = viewName,
	attributes = attributes,
	placeholders = placeholders
).collect { event ->
	if (event is CartItemInstantPurchase) {
		// カートアイテムの詳細を使用して注文を処理し、追加の支払い額を取得する必要があります
	}
}

JetpackCompose

RoktLayout(
	sdkTriggered = sdkTriggered,
	viewName = viewName,
	attributes = attributes,
	location = location,
) { event ->
	if (event is CartItemInstantPurchase) {
		// カートアイテムの詳細を使用して注文を処理し、追加の支払い額を取得する必要があります
	}
}

CartItemInstantPurchase イベント

ユーザーがカタログアイテムを即購入するためにサンキューページでカタログアイテムを押したとき、CartItemInstantPurchase イベントが以下のデータと共にトリガーされます。

パラメータ	型	説明
placementId	String	イベントに関連付けられた配置の一意の識別子。
cartItemId	String	カートアイテムの一意の識別子。
catalogItemId	String	カタログアイテムの一意の識別子。
currency	String	アイテム価格の通貨コード。
description	String	選択されたカタログアイテムの簡単な説明。
providerData	String	アイテムプロバイダーによって提供される追加データ。
name	String?	ユーザーが選択したカタログアイテムの名前。
linkedProductId	String?	関連する製品にアイテムをリンクするためのID、該当する場合。
quantity	Decimal?	ユーザーが選択したアイテムの数量。
totalPrice	Decimal?	アイテムの合計価格、単価に数量を掛けたものとして計算されます。
unitPrice	Decimal?	選択されたアイテムの単価。

ループを閉じる

購入フローを完了し、既存の注文を更新するか、インスタント購入用の新しい注文を作成したら、ループを閉じるために Rokt.purchaseFinalized を呼び出す必要があります。

Swift

// placementId には、CartItemInstantPurchase イベントで返された placementId を渡します
// catalogItemId には、CartItemInstantPurchase イベントで返された catalogItemId を渡します
// success には、ユーザーの購入結果を渡します。成功したかどうかを示します
Rokt.purchaseFinalized(placementId: placementId, catalogItemId: catalogItemId, success: success)

Kotlin

// placementId には、CartItemInstantPurchase イベントで返された placementId を渡します
// catalogItemId には、CartItemInstantPurchase イベントで返された catalogItemId を渡します
// success には、ユーザーの購入結果を渡します。成功したかどうかを示します
Rokt.purchaseFinalized(placementId = placementId, catalogItemId = catalogItemId, success = success)