購入記録
Braze SDK を使用してアプリ内購入をログに記録する方法について説明します。これにより、時間の経過やさまざまなソースにわたる収益を把握できるようになります。これにより、カスタムイベント、カスタム属性、および購入イベントを使用して、生涯価値に基づいてユーザーをセグメント化できます。
note:
リストされていないラッパーSDK の場合は、代わりに関連するネイティブAndroid またはSwift メソッドを使用します。
レポートされた米ドル以外の通貨は、レポート日の為替レートに基づき、Brazeでは米ドルで表示される。コンバージョンを防ぐため、通貨を米ドルに固定する。
購入と売上のロギング
購入と収益を記録するには、アプリでの正常な購入後にlogPurchase() を呼び出します。製品 ID が空の場合、購入は Braze に記録されません。
標準のWeb SDK 実装では、以下の方法を使用できます。
1
| braze.logPurchase(product_id, price, "USD", quantity);
|
代わりにGoogleタグマネージャを使用したい場合は、Purchaseタグタイプを使用して、logPurchaseメソッドを呼び出すことができます。このタグを使用して、Brazeへの購入を追跡します。オプションで、購入プロパティを含めます。そのために必要なこと:
- 商品IDと価格フィールドsが必要です。
- 購入プロパティを追加するには、Add Row ボタンを使用します。

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));
|
warning:
productID の最大文字数は 255 文字です。さらに、製品 ID が空の場合、購入は Braze に記録されないことに注意してください。
プロパティの追加
Int、Double、String、Bool、または Date の値が入力されたディクショナリを渡すことで、購入に関するメタデータを追加できます。
標準のWeb SDK 実装では、以下の方法を使用できます。
1
| braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});
|
サイトで標準の [e コマースイベント] データ層アイテムを使用して購入を Google Tag Manager に記録する場合は、e コマース購入タグタイプを使用できます。このアクションタイプでは、items のリストで送信されたアイテムごとに個別の「購入」を Braze に記録します。
購入プロパティリストでキーを指定することで、購入プロパティとして含める追加のプロパティの名前を指定することもできます。Brazeは、一覧に追加した購入プロパティーのログに記録されている個々のitem 内を検索します。
たとえば、次の e コマースペイロードがあるとします。
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
}]
|
item_brand と item_name だけを購入プロパティとして渡す場合は、これら2つのフィールドを購入プロパティテーブルに追加するだけです。プロパティを指定しない場合、[logPurchase] Braze の呼び出しで購入プロパティは送信されません。
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
BSDBTC,BTN,BWP,BYR 、 BZD
CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK
DJF, DKK, DOP, DZD
EEKEGP,ERN,ETB 、 EUR
FJD, FKP
GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD
HKDHNL,HRK,HTG 、 HUF
IDR, ILS, IMP, INR, IQD, IRR, ISK
JEP, JMD, JOD, JPY
KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT
LAKLBP,LKR,LRD,LSL,LTL,LVL 、 LYD
MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MTL, MUR, MVR, MWK, MXN, MYR, MZN
NADNGN,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
UAHUGX,USD,UYU 、 UZS
VEF, VND, VUV
WST
XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT
YER
ZAR, ZMK, ZMW, ZWL