Skip to content

購入記録

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

米ドル以外の通貨でレポートされた購入は、レポートされた日付の為替レートに基づいて米ドル単位でBrazeに表示されます。通貨換算を防ぐには、通貨をUSDにハードコードしてください。

購入と売上の記録

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

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

1

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

代わりにGoogle Tag Managerを使用したい場合は、Purchaseタグタイプを使用してlogPurchaseメソッドを呼び出すことができます。このタグを使用して、Brazeへの購入をトラッキングします。オプションで購入プロパティを含めることもできます。そのためには以下を行います。

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

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

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

プロパティの追加

Int、Double、String、Bool、またはDateの値が入力されたディクショナリを渡すことで、購入に関するメタデータを追加できます。

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

1

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

サイトで標準のeコマースイベントデータレイヤーアイテムを使用してGoogle Tag Managerに購入を記録する場合は、E-commerce Purchaseタグタイプを使用できます。このアクションタイプでは、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つのフィールドを購入プロパティテーブルに追加するだけです。プロパティを指定しない場合、BrazeへのlogPurchase呼び出しで購入プロパティは送信されません。

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
New Stuff!