Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

コマースとカタログアイテムのイベント

SDKを使ってアクティビティ追跡とコマースのやり取りを設定する方法。

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

以下のイベントを送信する前に、Pushly Android 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 が初期化されたあとに。

商品を閲覧

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

商品を保存

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

保存解除

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

完了済みアイテム

ユーザーは、想定された体験を完了した後、そのアイテムを完了済みとしてマークします。

完了を取り消す

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

商品を評価

この rate_item イベントには任意の 評価 プロパティが含まれます。指定する場合は、 評価 数値は 0～100 の範囲内で、 小数点以下1桁まで。整数値も有効です。

この 評価 値は、製品本来の尺度を反映する必要があります。ユースケースに合う範囲を自由に使用してください（例: 星評価なら 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 はカートまたは購入数量を追跡する場合にのみ必須です

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

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

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

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

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

前へSDKコールバック
次へライブアクティビティ

最終更新