iOS の購入のロギング

アプリ内での購入を記録して、売上を経時的にトラッキングしたり、売上源を横断してトラッキングしたりできます。また、ユーザーを生涯価値でセグメント化することもできます。

Braze では、複数の通貨での購入がサポートされています。米ドル以外の通貨でレポートする購入は、レポートされた日付の為替レートに基づいて米ドル単位でダッシュボードに表示されます。

実装前に、ベストプラクティスのカスタムイベント、カスタム属性、および購入イベントによって提供されるセグメンテーションオプションの例と、イベント命名規則のメモを必ず確認しておいてください。

購入と売上のトラッキング

この機能を使用するには、アプリ内購入が正常に完了した後でこのメソッド呼び出しを追加します。

• objective-c
• swift

1
2
3
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"))

• サポートされている通貨コードは USD、CAD、EUR、GBP、JPY、AUD、CHF、NOK、MXN、NZD、CNY、RUB、TRY、INR、IDR、ILS、SAR、ZAR、AED、SEK、HKD、SPD、DKK などです。
  • これ以外の通貨コードを指定すると警告が記録され、SDK でその他のアクションは実行されません。
• 商品 ID は最大 255 文字です。
• 商品 ID が空の場合、購入は Braze に記録されないことに注意してください。

プロパティ {#properties-purchases} の追加

購入に関するメタデータを追加するには、イベントプロパティ配列を渡すか、NSNumber、NSString、または NSDate の値が挿入された NSDictionary を渡します。

詳細については、iOS クラスのドキュメントを参照してください。

数量の追加

顧客が 1 回のチェックアウト手続きで同じ購入を複数回行う場合は、購入に数量を追加できます。これを行うには、数量として NSUInteger を渡します。

• SDK で購入を記録するには、数量入力が [0, 100] の範囲内である必要があります。
• 数量入力のないメソッドは、デフォルトの数量の値が 1 になります。
• 数量入力のあるメソッドにはデフォルト値がないため、SDK で購入を記録するために数量入力を受け取る必要があります。

詳細については、iOS クラスのドキュメントを参照してください。

• objective-c
• swift

1
2
3
4
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]
withProperties:@{@"key1":"value1"}];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"), withProperties: ["key1":"value1"])

注文レベルで購入を記録する

商品レベルではなく、注文レベルで購入を記録するには、注文名または注文カテゴリに product_id を使用します。詳細については、購入オブジェクトの仕様を参照してください。

予約済みのキー

以下のキーは予約されているため、購入プロパティとして使用できません。

• time
• product_id
• quantity
• event_name
• price
• currency

REST API

REST API を使用して購入を記録することもできます。詳細については、ユーザー API のドキュメントを参照してください。