コマースとカタログアイテムのイベント
SDKを通じてアクティビティ追跡とコマース連携を設定する方法。
このガイドでは、Android SDK を使用して、コマースおよびカタログ関連のユーザー操作を Pushly に送信する方法について説明します。これらのイベントは、カート放棄通知、保存済みアイテムのリマインダー、収益アトリビューション、カタログ駆動型レコメンデーションキャンペーンなどの機能を支えます。
以下のイベントを送信する前に、Pushly Android SDK を読み込み、初期化しておく必要があります。
以下の手順では、アイテムのカタログ／フィードを当社チームに提供していることを前提としています。このプロセスの詳細については、アカウントマネージャーにお問い合わせください。
対応しているインタラクションタイプ
Pushly は、以下のコマースおよびカタログ操作をサポートしています。
view_item – ユーザーがアイテム詳細ページを閲覧する
save_item – ユーザーがアイテムを保存またはお気に入りに追加する
unsave_item – ユーザーが保存済みアイテムを削除する、またはお気に入り解除する
complete_item – ユーザーがアイテムを完了する
uncomplete_item – ユーザーが完了済みアイテムを削除する
rate_item – ユーザーがアイテムを評価する
unrate_item – ユーザーがアイテムの評価を削除する
add_to_cart – ユーザーがアイテムをカートに追加する
update_cart – ユーザーがカートの内容または数量を変更する
purchase – ユーザーが取引を完了する
各インタラクションでは、カタログ設定に応じて 3 種類の識別子のいずれかを使ってアイテムを参照できます。
各アイテムには idが必要です。数量と評価は、特に記載がない限り任意です。
以下のコードスニペットはすべて 後 に、SDK の初期化が完了してから実行する必要があります。
アイテムを表示
ユーザーがアイテム詳細ページを閲覧したときにこのイベントを送信します。
アイテムを保存
ユーザーがアイテムを保存、お気に入り登録、またはブックマークしたときにこのイベントを使用します。これにより、保存済みアイテムのリマインダーキャンペーンを有効にできます。
保存解除アイテム
ユーザーがアイテムを保存済みリスト、お気に入り、またはブックマークから削除したときにこのイベントを使用します。
アイテムを完了
ユーザーが意図された体験を完了した後に、アイテムを完了済みとしてマークします。
アイテムの完了を解除
アイテムの完了状態を元に戻すには、このイベントを使用します。
アイテムを評価
この rate_item イベントには、任意の rating プロパティが含まれます。指定する場合、 rating は次の範囲の数値である必要があります 0 から 100 まで の範囲内で、 小数点以下 1 桁までです。整数値も有効です。
この rating 値は製品本来のスケールに合わせてください。用途に合う任意の範囲を使用できます（例: 星評価なら 1～5、スコアなら 0～10、割合形式の評価なら 1～100）。唯一の要件は、その値が 0～100 の範囲内であり、小数点以下 1 桁を超えないことです。
アイテムの評価を解除
ユーザーがアイテムの評価を削除したときにこのイベントを使用します。
カートに追加
ユーザーがアイテムをカートに追加したら、その都度このイベントを送信します。Pushly は複数回の呼び出しにわたってカート状態を累積します。
必要に応じて add_to_cart を何度でも呼び出し、訪問者のカート内のすべてのアイテムを追跡できます。購入されていない顧客のカート内アイテムについては、カート放棄通知が送信される場合があります。
購入が行われると、訪問者のカートは空になり、購入済みアイテムに関する通知は訪問者に送信されません。
カートを更新
ユーザーが購入を完了せずにカートを変更した場合、たとえば数量を調整したりアイテムを削除したりした場合に、このイベントを使用します。
カートからアイテムを削除するには、 update_cart メソッドに現在のカート全体の情報を渡します（削除したアイテムは含めません）。
また、カートが完全に空になった場合は、空の配列を指定します。
購入
チェックアウトが成功した後にこのイベントを送信します。これによりカート放棄状態がクリアされ、収益アトリビューションが有効になります。
購入フィールド
priceValue – 購入総額。ドメインに設定された通貨で指定します
purchaseId – 一意の注文識別子
もし purchase イベントがアイテムデータなしで送信された場合でも、Pushly はユーザーのカート状態をクリアします。
通貨の扱い
price_value は、プラットフォームのドメイン設定でドメインに対して構成された通貨で指定する必要があります。
小数点記号にはピリオド（.）を使用してください。ロケールに関係なく、すべての通貨でピリオドを使用します。カンマは使用しないでください。
例:
USD:
"344.33"JPY:
"5000"
必須フィールドの概要
idはすべてのアイテムで必須ですquantityは、カート数量または購入数量を追跡する場合にのみ必須ですratingは、アイテムを評価する場合にのみ必須です
実装のベストプラクティス
イベントの取りこぼしを防ぐため、SDK はページライフサイクルの早い段階で初期化してください。
すべてのインタラクションタイプで一貫したアイテム ID を使用し、Pushly が行動を正しく関連付けられるようにしてください。
トリガー purchase 偽のカート放棄通知を避けるため、可能な限り信頼できる確認ステップからイベントを送信してください。
最終更新