コンテンツにスキップ

購入記録

Braze SDKを使用してアプリ内購入を記録する方法について説明します。これにより、売上を経時的にトラッキングしたり、売上源を横断してトラッキングしたりできます。カスタムイベント、カスタム属性、および購入イベントを使用して、LTVに基づいてユーザーをセグメント化できます。

米ドル以外の通貨でレポートされた購入は、レポートされた日付の為替レートに基づいて米ドル単位でBrazeに表示されます。ダッシュボードでの通貨換算、キャッシュ、および為替レートの更新タイミングについては、通貨換算を参照してください。通貨換算を防ぐには、通貨コードをUSDに設定して購入を記録してください。

購入と売上の記録

購入と売上を記録するには、アプリ内で購入が正常に完了した後にlogPurchase()を呼び出します。商品識別子が空の場合、購入はBrazeに記録されません。

標準的なWeb SDKの実装では、以下のメソッドを使用できます。

braze.logPurchase(product_id, price, "USD", quantity);

代わりにGoogle Tag マネージャーを使用する場合は、Purchaseタグタイプを使用してlogPurchaseメソッドを呼び出すことができます。このタグを使用して、Brazeへの購入をトラッキングし、オプションで購入プロパティを含めることもできます。設定方法は以下の通りです。

  1. Product IDフィールドとPriceフィールドは必須です。
  2. Add Rowボタンを使用して購入プロパティを追加します。

Brazeアクションタグの設定ダイアログボックス。設定には「tag type」「external ID」「price」「currency code」「quantity」「purchase properties」が含まれています。

Braze.getInstance(context).logPurchase(
   String productId,
   String currencyCode,
   BigDecimal price,
   int quantity
);
Braze.getInstance(context).logPurchase(
  productId: String,
  currencyCode: String,
  price: BigDecimal,
  quantity: Int
)
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price)
[AppDelegate.braze logPurchase:"product_id"
                      currency:@"USD"
                         price:price];
var properties = {};
properties["KEY"] = "VALUE";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);
braze.logPurchase(productId, currencyCode, price, quantity, properties: properties);
Braze.logPurchase(productId, price, currencyCode, quantity, properties);
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity)
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal));

プロパティの追加

購入に関するメタデータを追加するには、Int、Double、String、Bool、またはDate値を含むDictionaryを渡します。

標準的なWeb SDKの実装では、以下のメソッドを使用できます。

braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});

サイトが標準的なeコマースイベントのデータレイヤーアイテムを使用してGoogle Tag マネージャーに購入を記録している場合、E-commerce Purchaseタグタイプを使用できます。このアクションタイプは、itemsのリストで送信された各アイテムに対して、Brazeに個別の「購入」を記録します。

購入プロパティリストにキーを指定することで、購入プロパティとして含めたい追加のプロパティ名を指定することもできます。Brazeは、リストに追加した購入プロパティについて、記録される個々のitem内を検索します。

たとえば、以下のeコマースペイロードがあるとします。

items: [{
  item_name: "5 L WIV ECO SAE 5W/30",
  item_id: "10801463",
  price: 24.65,
  item_brand: "EUROLUB",
  quantity: 1
}]

item_brandとitem_nameのみを購入プロパティとして渡したい場合は、購入プロパティテーブルにこの2つのフィールドを追加するだけです。プロパティを指定しない場合、BrazeへのlogPurchase呼び出しで購入プロパティは送信されません。

BrazeProperties purchaseProperties = new BrazeProperties();
purchaseProperties.addProperty("key", "value");
Braze.getInstance(context).logPurchase(..., purchaseProperties);
val purchaseProperties = BrazeProperties()
purchaseProperties.addProperty("key", "value")
Braze.getInstance(context).logPurchase(..., purchaseProperties)
let purchaseProperties = ["key": "value"]
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price, properties: purchaseProperties)
NSDictionary *purchaseProperties = @{@"key": @"value"};
[AppDelegate.braze logPurchase:@"product_id"
                      currency:@"USD"
                         price:price
                   properties:purchaseProperties];
var properties = {};
properties["key"] = "value";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);
braze.logPurchase(productId, currencyCode, price, quantity, properties: {"key": "value"});
Braze.logPurchase(productId, price, currencyCode, quantity, { key: "value" });
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity, {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})
Dictionary<string, object> purchaseProperties = new Dictionary<string, object>
{
    { "key", "value" }
};
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal), purchaseProperties);

数量の追加

デフォルトでは、quantityは1に設定されています。ただし、顧客が1回の会計で同じ商品を複数回購入する場合は、購入に数量を追加できます。数量を追加するには、Int値をquantityに渡します。

REST APIの使用

REST APIを使用して購入を記録することもできます。詳細については、ユーザーデータエンドポイントを参照してください。

注文の記録

商品レベルではなく、注文レベルで購入を記録したい場合、注文名または注文カテゴリをproduct_idとして使用できます。詳細については、購入オブジェクトの仕様を参照してください。

予約キー

以下のキーは予約されており、購入プロパティとして使用できません。

  • time
  • product_id
  • quantity
  • event_name
  • price
  • currency

サポートされている通貨

Brazeは以下の通貨記号をサポートしています。これ以外の通貨記号を指定すると警告が記録され、購入はBrazeに記録されません。

  • AED、AFN、ALL、AMD、ANG、AOA、ARS、AUD、AWG、AZN
  • BAM、BBD、BDT、BGN、BHD、BIF、BMD、BND、BOB、BRL
  • BSD、BTC、BTN、BWP、BYR、BZD
  • CAD、CDF、CHF、CLF、CLP、CNY、COP、CRC、CUC、CUP、CVE、CZK
  • DJF、DKK、DOP、DZD
  • EEK、EGP、ERN、ETB、EUR
  • FJD、FKP
  • GBP、GEL、GGP、GHS、GIP、GMD、GNF、GTQ、GYD
  • HKD、HNL、HRK、HTG、HUF
  • IDR、ILS、IMP、INR、IQD、IRR、ISK
  • JEP、JMD、JOD、JPY
  • KES、KGS、KHR、KMF、KPW、KRW、KWD、KYD、KZT
  • LAK、LBP、LKR、LRD、LSL、LTL、LVL、LYD
  • MAD、MDL、MGA、MKD、MMK、MNT、MOP、MRO、MTL、MUR、MVR、MWK、MXN、MYR、MZN
  • NAD、NGN、NIO、NOK、NPR、NZD
  • OMR
  • PAB、PEN、PGK、PHP、PKR、PLN、PYG
  • QAR
  • RON、RSD、RUB、RWF
  • SAR、SBD、SCR、SDG、SEK、SGD、SHP、SLL、SOS、SRD、STD、SVC、SYP、SZL
  • THB、TJS、TMT、TND、TOP、TRY、TTD、TWD、TZS
  • UAH、UGX、USD、UYU、UZS
  • VEF、VND、VUV
  • WST
  • XAF、XAG、XAU、XCD、XDR、XOF、XPD、XPF、XPT
  • YER
  • ZAR、ZMK、ZMW、ZWL
New Stuff!