購入のロギング
Braze SDK を使用してアプリの購入をログインする方法を学習することで、経時的およびソース間で収益を判断できます。これにより、ユーザのライフタイム値 に基づいて、カスタムイベント、カスタム属性、および購入イベントを使用して、ユーザをセグメント化できます[。
note:
リストされていないラッパーSDK の場合は、代わりに関連するネイティブAndroid またはSwift メソッドを使用します。
仕入および収益の記録
購入と収益を記録するには、アプリでの正常な購入後にlogPurchase()
を呼び出します。製品 ID が空の場合、購入は Braze に記録されません。
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];
|
標準のWeb SDK 実装では、以下の方法を使用できます。
1
| braze.logPurchase(product_id, price, "USD", quantity);
|
代わりにGoogleタグマネージャを使用したい場合は、Purchaseタグタイプを使用して、logPurchase
メソッドを呼び出すことができます。このタグを使用して、Brazeへの購入を追跡します。オプションで、購入プロパティを含めます。そのためには:
- 商品IDと価格フィールドsが必要です。
- 購入プロパティを追加するには、Add Row ボタンを使用します。

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));
|
1
| UBraze->LogPurchase(TEXT("product_id"), TEXT("USD"), price, quantity);
|
warning:
productID
最大255 文字まで指定できます。さらに、製品識別子が空の場合、購入はブレーズに記録されません。
プロパティの追加
Int
、Double
、String
、Bool
、または Date
の値が入力されたディクショナリを渡すことで、購入に関するメタデータを追加できます。
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];
|
標準のWeb SDK 実装では、以下の方法を使用できます。
1
| braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});
|
サイトが標準のeCommerceイベントデータレイヤーアイテムを使用して購入をGoogleタグマネージャーに記録する場合、E-commerce Purchaseタグタイプを使用できます。このアクションタイプでは、items
のリストで送信されたアイテムごとに個別の「購入」を Braze に記録します。
購入プロパティリストでキーを指定することで、購入プロパティとして含める追加のプロパティの名前を指定することもできます。Brazeは、一覧に追加した購入プロパティーのログに記録されている個々のitem
内を検索します。
たとえば、次のeCommerce ペイロードがあるとします。
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
| 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);
|
1
2
3
4
| TMap<FString, FString> PurchaseProperties;
PurchaseProperties.Add(TEXT("key"), TEXT("value"));
UBraze->LogPurchaseWithProperties(TEXT("product_id"), TEXT("USD"), price, quantity, PurchaseProperties);
|
数量の追加
デフォルトでは、quantity
は1
に設定されます。ただし、顧客が1回のチェックアウトで同じ購入を複数回行う場合は、購入に数量を追加できます。数量を追加するには、Int
値をquantity
に渡します。これは[0, 100]
の範囲内です。
REST API の使用
REST API を使用して購入を記録することもできます。詳細については、User Data Endpointsを参照してください。
ログ受注
商品レベルではなく、注文レベルで購入を記録したい場合、注文名または注文カテゴリを product_id
として使用できます。詳細については、購入オブジェクトの仕様を参照してください。
予約済みのキー
以下のキーは予約されているため、購入プロパティとして使用できません。
time
product_id
quantity
event_name
price
currency
対応通貨
サポートされている通貨記号です。他の通貨記号を入力すると、警告がログに記録され、購入はブレーズに記録されません。
USD
CAD
EUR
GBP
JPY
AUD
CHF
NOK
MXN
NZD
CNY
RUB
TRY
INR
IDR
ILS
SAR
ZAR
AED
SEK
HKD
SPD
DKK