Skip to content

購入記録

Braze SDK を使用してアプリ内購入をログに記録する方法について説明します。これにより、時間の経過やさまざまなソースにわたる収益を把握できるようになります。これにより、カスタムイベント、カスタム属性、および購入イベントを使用して、生涯価値に基づいてユーザーをセグメント化できます。

レポートされた米ドル以外の通貨は、レポート日の為替レートに基づき、Brazeでは米ドルで表示される。コンバージョンを防ぐため、通貨を米ドルに固定する。

購入と売上のロギング

購入と収益を記録するには、アプリでの正常な購入後にlogPurchase() を呼び出します。製品 ID が空の場合、購入は Braze に記録されません。

標準のWeb SDK 実装では、以下の方法を使用できます。

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

代わりにGoogleタグマネージャを使用したい場合は、Purchaseタグタイプを使用して、logPurchaseメソッドを呼び出すことができます。このタグを使用して、Brazeへの購入を追跡します。オプションで、購入プロパティを含めます。そのために必要なこと:

  1. 商品ID価格フィールドsが必要です。
  2. 購入プロパティを追加するには、Add Row ボタンを使用します。

Braze アクションタグ構成設定を示すダイアログボックス。設定項目には「タグタイプ」「external ID」「価格」「通貨コード」「数量」「購入プロパティ」が含まれる。

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));

プロパティの追加

IntDoubleStringBool、または 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_branditem_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);

数量の追加

デフォルトでは、quantity1 に設定されます。ただし、顧客が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,BYRBZD
  • CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK
  • DJF, DKK, DOP, DZD
  • EEKEGP,ERN,ETBEUR
  • FJD, FKP
  • GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD
  • HKDHNL,HRK,HTGHUF
  • 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,LVLLYD
  • MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MTL, MUR, MVR, MWK, MXN, MYR, MZN
  • NADNGN,NIO,NOK,NPRNZD
  • 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,UYUUZS
  • VEF, VND, VUV
  • WST
  • XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT
  • YER
  • ZAR, ZMK, ZMW, ZWL
New Stuff!