Braze Web SDK タグ構成ガイド

サポートされているバージョン

Braze Web SDK タグは、タグテンプレートバージョン 3.3 およびそれ以前をサポートしています。最高のタグパフォーマンスと機能性を得るために、最新のタグテンプレートへの更新をお勧めします。

タグのヒント

注文IDが存在する場合、購入イベントが発火します。
以下の E-Commerce 拡張パラメータをサポートしています：
- 顧客ID（_ccustidを上書き）
- 市区町村（_ccityを上書き）
- 国（_ccountryを上書き）
- 注文ID（_corderを上書き）
- 小計（_csubtotalを上書き）
- 通貨（_ccurrencyを上書き）
- 商品ID（_cprodを上書き）
- 商品数量（_cquanを上書き）
標準構成値を動的に上書きするためにマッピングを使用します。

タグ構成

まず、Tealiumのタグマーケットプレイスにアクセスし、プロファイルにBraze Web SDKタグを追加します（タグの追加方法?）。

タグを追加した後、以下の構成を構成します：

コードバージョン
- 使用したいBraze Web SDKのメジャー.マイナーバージョンを入力します。
- 例えば、バージョン2.6.1をデプロイする場合は、2.6と入力します。
- Braze Web SDKの最新バージョンは、changelogを参照してください。
APIキー
- Brazeダッシュボードのアプリグループ管理構成で利用可能なユニークなAPIキー。
ベースURL
- 割り当てられたBrazeクラスターを指すAPIエンドポイント。
- 4.0の例：https://js.appboycdn.com/web-sdk/4.0/braze.no-amd.min.js
- 3.5およびそれ以前のバージョンの例：https://js.appboycdn.com/web-sdk/3.5/appboy.no-amd.min.js
- オプションのリストについては、Braze SDK Endpointsを参照してください。
ログの有効化
- 有効にすると、ウェブコンソールにデバッグ情報が記録されます。

ロードルール

ロードルールは、このタグのインスタンスをサイトのどこに、いつロードするかを決定します。

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。（詳細を学ぶ）

Braze Web SDKタグの宛先変数は、タグのデータマッピングタブに組み込まれています。以下の表は、利用可能な宛先カテゴリをリストし、各宛先名を説明しています。

標準

宛先名	説明
`initOpt.allow_crawler`	クローラーを許可 Brazeによってウェブクローラーの活動が記録されます。オプションは `true` または `false`。
`initOpt.app_ver`	アプリバージョンデータを関連付けるアプリのバージョン。
`initOpt.base_url`	ベースURL Brazeが提供するカスタムエンドポイントへの完全なURL。
`initOpt.no_cookies`	クッキーなし Brazeがユーザー情報をクッキーに保存するのを防ぎます。オプションは `true` または `false`。
`initOpt.no_fntawsm`	フォントアウェサムなし Brazeが `FontAwesome` をロードするのを防ぎます。オプションは `true` または `false`。
`initOpt.enable_htmlmsgs`	メッセージ内のHTMLを有効化 Brazeユーザーがアプリ内メッセージを介してHTMLを送信できるようにします。オプションは `true` または `false`。
`initOpt.enable_logging`	ログの有効化ウェブコンソールにBrazeのエラーメッセージが表示されることを許可します。オプションは `true` または `false`。
`initOpt.localization`	ローカリゼーションブラウザのデフォルト言語を上書きするISO 639-1言語コード。
`initOpt.min_trggrinterval`	アクション間の最小間隔別のトリガーアクションが発生するまでの時間（秒単位）。デフォルト値は `30`。
`initOpt.msg_innewtab`	新しいタブでアプリ内メッセージを開くアプリ内メッセージのリンクを新しいタブまたはウィンドウで開くように強制します。オプションは `true` または `false`。
`initOpt.card_innewtab`	新しいタブでニュースフィードカードを開くニュースフィードカードのリンクを新しいタブまたはウィンドウで開くように強制します。オプションは `true` または `false`。
`initOpt.explicit_dissmisal`	明示的な解除を要求ユーザーがメッセージを解除するためにボタンをクリックすることを強制します。オプションは `true` または `false`。
`initOpt.safari_pushid`	SafariウェブサイトプッシュID Safariプッシュ証明書からのID。
`initOpt.srvcewrkr_location`	サービスワーカーの場所ルートディレクトリにない場合の `service-worker.js` ファイルへのパス。
`initOpt.session_timeout`	セッションタイムアウトセッションがタイムアウトするまでの時間（分単位）。デフォルト値は `30`。
`initOpt.enableSdkAuthentication`	現在のユーザーの最後に知られているJSONウェブトークンをBrazeサーバーへのネットワークリクエストに追加します。この構成はバージョン3.5以降で利用可能です。オプションは `true` または `false`。

Eコマース

Braze Web SDKタグはEコマース対応であり、デフォルトのEコマース拡張マッピングを自動的に使用します。このカテゴリで手動でマッピングする必要は通常ありませんが、拡張マッピングを上書きするか、Eコマース変数が拡張に提供されていない場合は必要になることがあります。

宛先名	説明
`order_id`	注文ID `_corder`を上書きします。
`order_subtotal`	小計 `_csubtotal`を上書きします。
`order_currency`	通貨 `_ccurrency`を上書きします。
`customer_id`	顧客ID `_ccustid`を上書きします。
`customer_city`	顧客の市 `_ccity`を上書きします。
`customer_country`	顧客の国 `_ccountry`を上書きします。
`product_id`	配列商品IDのリスト `_cprod`を上書きします。
`product_quantity`	配列数量のリスト `_cquan`を上書きします。

イベント

ページ上で特定のイベントをトリガーするためにこれらの宛先にマップします。

イベントをトリガーするには、以下の手順を使用します：

ドロップダウンリストからイベントを選択します。

事前定義されたリストから選択するか、カスタムイベントを作成できます。
カスタムイベントの場合、それを識別する名前を入力します。

トリガーフィールドにマッピングされる変数の値を入力します。
より多くのイベントをマップするには、**+**ボタンをクリックして手順1と2を繰り返します。
適用をクリックします。

次の表は、データレイヤーに提供された値が見つかったときにイベントトリガーをリストします。

宛先名	説明
`Purchase`	購入ログ現在のユーザーによってアプリ内購入が行われます。注文IDが存在する場合、購入イベントは自動的に構成されます。
`Alias`	ユーザーエイリアスの追加現在のユーザーの新しいエイリアスが追加されます。
`addToSubscriptionGroup`	ユーザーをメールまたはSMSのサブスクリプショングループに追加します。この構成はバージョン3.5以降で利用可能です。
`AddAtt`	カスタム属性を配列に追加カスタム属性配列に新しい属性が追加されます。
`IncAtt`	カスタム属性のインクリメント現在のカスタム属性配列にある属性を増やします。
`RmvAtt`	カスタム属性を配列から削除カスタム属性配列から属性を削除します。
`SetAtt`	ユーザー属性の構成現在のユーザーの新しいカスタム属性を構成します。
`SetAvatar`	アバターの構成現在のユーザーのアバターURLを構成します。バージョン4.0以降では利用できません。
`SetLoc`	最後の位置の構成現在のユーザーの最後に知られている位置を構成します。
`SetDOB`	生年月日の構成現在のユーザーの生年月日（日、月、年）を構成します。
`SetEmail`	メールの構成現在のユーザーのメールを構成します。
`SetEmailSub`	メールサブスクリプションタイプの構成現在のユーザーのメールサブスクリプションの通知タイプを構成します。
`SetPushSub`	プッシュサブスクリプションタイプの構成現在のユーザーのプッシュ通知の通知タイプを構成します。
`SetFirst`	名の構成現在のユーザーの名を構成します。
`SetLast`	姓の構成現在のユーザーの姓を構成します。
`SetCity`	ホームシティの構成現在のユーザーの市を構成します。
`SetCountry`	国の構成現在のユーザーの国を構成します。
`SetLang`	言語の構成現在のユーザーの言語を構成します。
`SetPhone`	電話番号の構成現在のユーザーの電話番号を構成します。
`SetGender`	性別の構成現在のユーザーの性別を構成します。
`Custom`	カスタム現在のユーザーによって作成されたカスタムイベントを送信します。

パラメータ

これらの目的地にマッピングして、以前にマッピングしたイベントにデータを渡します。パラメータは事前定義されたイベントでのみ使用されます。カスタムイベントでパラメータを渡す方法については、以下のカスタムイベントデータセクションを参照してください。

事前定義されたイベントにパラメータを渡すには、以下の手順を使用します：

イベントフィールドで、ドロップダウンリストからイベントを選択します。
パラメータフィールドで、ドロップダウンリストからパラメータを選択します。
カスタムパラメータの場合、カスタムイベントを識別する名前を入力します。
+ 追加をクリックします。

目的地名	説明
`product_id`	商品ID アプリ内で購入された商品のユニークID。 `_cprod`を上書きします。
`product_quantity`	商品数量アプリ内で購入された商品の数量。これはeコマースの値`_cquan`を上書きします。
`order_id`	注文ID アプリ内購入のユニークID。 `_corder`を上書きします。
`order_subtotal`	注文小計アプリ内購入の小計。 `_csubtotal`を上書きします。
`order_currency`	注文通貨アプリ内購入のISO 4217通貨コード。 `_ccurrency`を上書きします。
`purchase_properties`	購入プロパティアプリ内購入の追加プロパティのオブジェクト。
`alias`	ユーザーエイリアス現在のユーザーの識別子。
`label`	エイリアスラベルエイリアスのソースなど、エイリアスのラベル。
`key`	カスタム属性キーカスタム属性の識別子。送信するパラメータの名前を入力します。
`value`	カスタム属性値カスタム属性の値。送信するパラメータの名前を入力します。
`inc_value`	カスタム属性増分値カスタムユーザー属性を増分する値。送信するパラメータの名前を入力します。減少させるには負の数を使用します。デフォルト値は`1`です。
`avatar_url`	アバター画像URL 現在のユーザーが選択したアバターのURL。バージョン4.0以降では利用できません。
`longitude`	ユーザーの経度ユーザーの位置の検証済み経度、度単位。値は`-180`から`180`までです
`latitude`	ユーザーの緯度ユーザーの位置の検証済み緯度、度単位。値は`-90`から`90`までです
`accuracy`	位置精度ユーザーの経度と緯度の精度、メートル単位。
`altitude`	ユーザーの高度ユーザーの位置の高度、メートル単位。
`altitude_accuracy`	高度精度ユーザーの高度の精度、メートル単位。
`year`	ユーザーの誕生年現在のユーザーの誕生日に関連する年。
`month`	ユーザーの誕生月現在のユーザーの誕生日に関連する月。
`day`	ユーザーの誕生日現在のユーザーの誕生日に関連する日。
`email`	ユーザーのメール現在のユーザーの検証済みメールアドレス。
`notification_type`	通知購読タイプ現在のユーザーの選択された通知タイプ。オプション: `opted_in`, `subscribed`, `unsubscribed`
`first_name`	ユーザーの名前現在のユーザーの名前。
`subscriptionGroupId`	サブスクリプショングループID。サブスクリプショングループのユニークな識別子。
`last_name`	ユーザーの姓現在のユーザーの姓。
`gender`	ユーザーの性別現在のユーザーの性別コード。オプションは男性(`m`)、女性(`f`)、その他(`o`)です。
`customer_city`	ユーザーの居住都市現在のユーザーの居住都市。 `_ccity`を上書きします。
`customer_country`	ユーザーの国現在のユーザーの国。 `_ccountry`を上書きします。
`localization`	ユーザーの言語現在のユーザーの表示言語のISO 639-1言語コード。
`phone_number`	ユーザーの電話番号現在のユーザーの電話番号。数字、スペース、`+`、`.`、`-`、`(`、`)`の文字のみ許可されます

カスタムイベントデータ

イベントタブで以前にマッピングしたカスタムイベントにカスタムパラメータを渡したい場合、カスタムイベントデータの送信先にマップします。

カスタムイベントデータ変数をマップするには、以下の手順に従ってください：

イベント名に、イベントタブで指定されたカスタムイベントの名前を正確に入力します。
パラメータに、送信したいパラメータの名前を入力します。
+ 追加をクリックします。

ベンダー文書

Braze Web SDK