Commerce & カタログアイテムイベント

SDK を使用したアクティビティトラッキングとコマースインタラクションの設定方法。

このガイドでは、iOS SDK を使用して、コマースおよびカタログ関連のユーザー操作を Pushly に送信する方法を説明します。これらのイベントは、カート放棄通知、保存済みアイテムのリマインダー、収益属性、カタログ駆動のレコメンデーションキャンペーンなどの機能を支えます。

以下に説明するイベントを送信する前に、Pushly iOS SDK を読み込み、初期化しておく必要があります。

以下の手順では、商品カタログ/フィードを弊社チームに提供していることを前提としています。このプロセスの詳細については、アカウントマネージャーまでお問い合わせください。

サポートされるインタラクションタイプ

Pushlyは、以下のCommerceおよびカタログ操作をサポートしています:

• view_item – ユーザーが商品詳細ページを閲覧する

• save_item – ユーザーが商品を保存またはお気に入り登録する

• unsave_item – ユーザーが保存済みから削除する、またはお気に入り解除する

• complete_item – ユーザーがアイテムを完了する

• uncomplete_item – ユーザーが完了済みアイテムを未完了に戻す

• rate_item – ユーザーがアイテムを評価する

• unrate_item – ユーザーがアイテムの評価を削除する

• add_to_cart – ユーザーがアイテムをカートに追加する

• update_cart – ユーザーがカートの内容または数量を変更する

• purchase – ユーザーが取引を完了する

各インタラクションでは、カタログ設定に応じて、3種類の識別子のいずれかを使ってアイテムを参照できます。

各アイテムには id. 数量と評価は、特に記載がない限り省略可能です。

以下のコードスニペットはすべて実行する必要があります 後 にSDKが初期化された後で。

アイテムを表示

ユーザーが商品詳細ページを閲覧したときにこのイベントを送信します。

Swift

PushSDK.UserProfile.viewItem(item: CatalogItem(id: "ITEM_ID"))

Objective-C

アイテムを保存

ユーザーがアイテムを保存、お気に入り登録、またはブックマークしたときにこのイベントを使用します。これにより、保存アイテムのリマインダーキャンペーンを有効にできます。

Swift

PushSDK.UserProfile.saveItem(item: CatalogItem(id: "ITEM_ID"))

Objective-C

アイテムの保存を解除

ユーザーが保存リスト、お気に入り、またはブックマークからアイテムを削除したときにこのイベントを使用します。

Swift

PushSDK.UserProfile.unsaveItem(
    item: CatalogItem(id: "ITEM_ID")
)

Objective-C

アイテムを完了

ユーザーが意図した体験を終えた後、アイテムを完了済みとしてマークします。

Swift

PushSDK.UserProfile.completeItem(
    item: CatalogItem(id: "ITEM_ID")
)

Objective-C

アイテムの完了を解除

アイテムの完了状態を元に戻すには、このイベントを使用します。

Swift

PushSDK.UserProfile.uncompleteItem(
    item: CatalogItem(id: "ITEM_ID")
)

Objective-C

アイテムを評価

「 rate_item イベントには、任意の rating プロパティ。指定されている場合、 rating は0から100までの数値である必要があり、 0〜100 の範囲内で、 小数点以下1桁まで.

Swift

PushSDK.UserProfile.rateItem(
    item: CatalogItem(id: "ITEM_ID", rating: 95)
)

Objective-C

アイテムの評価を解除

ユーザーがアイテムから評価を削除したときにこのイベントを使用します。

Swift

PushSDK.UserProfile.unrateItem(
    item: CatalogItem(id: "ITEM_ID")
)

Objective-C

カートに追加

ユーザーがアイテムをカートに追加するたびにこのイベントを送信します。Pushlyは複数回の呼び出しにわたってカートの状態を集計します。

Swift

PushSDK.UserProfile.addToCart(
    item: CatalogItem(id: "ITEM_ID", quantity: 2)
)

Objective-C

必要に応じて add_to_cart 訪問者のカート内のすべてのアイテムを追跡するために、必要な回数だけ実行してください。購入されていないカート内の任意のアイテムに対して、カート放棄通知を送信できます。

購入が行われると、訪問者のカートは空になり、購入済みアイテムに関する通知は訪問者に送信されなくなります。

カートを更新

数量の調整やアイテムの削除など、購入を完了せずにユーザーがカートを変更したときにこのイベントを使用します。

カートからアイテムを削除するには、 update_cart メソッドを、現在のカート情報全体（削除したアイテムを除く）とともに呼び出します:

Swift

PushSDK.UserProfile.updateCart(withItems: [
    CatalogItem(id: "ITEM_1", quantity: 1),
    CatalogItem(id: "ITEM_2", quantity: 2)
])

Objective-C

または、カートが完全に空の場合は空の配列を指定します:

Swift

PushSDK.UserProfile.updateCart(withItems: [])

Objective-C

購入

チェックアウト成功後にこのイベントを送信します。これにより、カート放棄状態が解除され、収益アトリビューションが有効になります。

Swift

PushSDK.UserProfile.trackPurchase(
    次のアイテム: [
        CatalogItem(id: "ITEM_1"),
        CatalogItem(id: "ITEM_2", quantity: 2)
    ],
    purchaseId: "ORDER_123",
    priceValue: "49.99"
)

Objective-C

購入フィールド

• priceValue – 購入総額。通貨はドメインに設定されたもの

• purchaseId – 一意の注文識別子

もし purchase イベントがアイテムデータなしで送信された場合でも、Pushlyはユーザーのカート状態をクリアします。

通貨の取り扱い

price_value プラットフォームのドメイン設定でドメインに設定された通貨で指定する必要があります。

ピリオド（.すべての通貨で、小数点区切り文字としてロケールに関係なく ) を使用します。カンマは使用しないでください。

例:

• USD: "344.33"

• JPY: "5000"

必須フィールドの要約

• id はすべてのアイテムで必須です

• quantity は、カートまたは購入数量を追跡する場合にのみ必須です

• rating は、アイテムを評価する場合にのみ必須です

実装のベストプラクティス

イベントの取りこぼしを避けるため、ページライフサイクルの早い段階でSDKを初期化してください。

Pushlyが行動を正しく関連付けられるように、すべてのインタラクションタイプで一貫したアイテムIDを使用してください。

トリガー purchase 誤ったカート放棄通知を避けるため、可能な限り信頼できる確認ステップからイベントを発生させてください。