search

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

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

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

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

circle-info

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

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

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

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

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

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

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

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

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

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

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

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

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

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

各アイテムには id。数量と評価は、特に記載がない限り対象外です。

triangle-exclamation

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

hashtag
アイテムを表示

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

hashtag
アイテムを保存

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

hashtag
アイテムの保存を解除

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

hashtag
アイテムを完了

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

hashtag
アイテムの完了を解除

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

hashtag
アイテムを評価

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

hashtag
アイテムの評価を解除

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

hashtag
カートに追加

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

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

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

hashtag
カートを更新

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

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

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

hashtag
購入

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

hashtag
パラメーターの順序

trackPurchase(items, purchase_id, price_value)

このメソッドは位置パラメーターを使用するため、値はこの順序で渡す必要があります:

  • items

  • purchase_id

  • price_value

hashtag
購入フィールド

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

  • purchase_id – 一意の注文識別子

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

hashtag
通貨の取り扱い

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

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

例:

  • USD: "344.33"

  • JPY: "5000"

hashtag
必須フィールドの要約

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

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

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

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

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

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

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

前へSDK メソッド次へFlutter SDK 変更履歴

最終更新