Skip to content

購入のロギング

Braze SDK を使用してアプリの購入をログインする方法を学習することで、経時的およびソース間で収益を判断できます。これにより、ユーザのライフタイム値 に基づいて、カスタムイベント、カスタム属性、および購入イベントを使用して、ユーザをセグメント化できます[。

仕入および収益の記録

購入と収益を記録するには、アプリでの正常な購入後に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への購入を追跡します。オプションで、購入プロパティを含めます。そのためには:

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

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

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

プロパティの追加

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

数量の追加

デフォルトでは、quantity1 に設定されます。ただし、顧客が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
「このページはどの程度役に立ちましたか?」
New Stuff!