購入記録

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

注

リストされていないラッパーSDKの場合は、代わりに関連するネイティブAndroidまたはSwiftメソッドを使用してください。

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

購入と売上の記録

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

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

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

1
2
3
4
5
6
Braze.getInstance(context).logPurchase(
   String productId,
   String currencyCode,
   BigDecimal price,
   int quantity
);

1
2
3
4
5
6
Braze.getInstance(context).logPurchase(
  productId: String,
  currencyCode: String,
  price: BigDecimal,
  quantity: Int
)

1
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price)

1
2
3
[AppDelegate.braze logPurchase:"product_id"
                      currency:@"USD"
                         price:price];

1
2
3
var properties = {};
properties["KEY"] = "VALUE";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1
braze.logPurchase(productId, currencyCode, price, quantity, properties: properties);

1
Braze.logPurchase(productId, price, currencyCode, quantity, properties);

1
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity)

1
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal));

警告

productIDは最大255文字までです。また、商品識別子が空の場合、購入はBrazeに記録されません。

プロパティの追加

購入に関するメタデータを追加するには、Int、Double、String、Bool、またはDateの値が格納されたDictionaryを渡します。

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

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

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

1
2
3
BrazeProperties purchaseProperties = new BrazeProperties();
purchaseProperties.addProperty("key", "value");
Braze.getInstance(context).logPurchase(..., purchaseProperties);

1
2
3
val purchaseProperties = BrazeProperties()
purchaseProperties.addProperty("key", "value")
Braze.getInstance(context).logPurchase(..., purchaseProperties)

1
2
let purchaseProperties = ["key": "value"]
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price, properties: purchaseProperties)

1
2
3
4
5
NSDictionary *purchaseProperties = @{@"key": @"value"};
[AppDelegate.braze logPurchase:@"product_id"
                      currency:@"USD"
                         price:price
                   properties:purchaseProperties];

1
2
3
var properties = {};
properties["key"] = "value";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1
braze.logPurchase(productId, currencyCode, price, quantity, properties: {"key": "value"});

1
Braze.logPurchase(productId, price, currencyCode, quantity, { key: "value" });

1
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity, {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})

1
2
3
4
5
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