Braze Web SDKタグ構成ガイド
この記事では、タグ管理アカウントでBraze Web SDKタグを構成する方法について説明します。
サポートされているバージョン
- 6.8
- 5.5
- 4.8
- 3.5
Braze Web SDKタグは、タグテンプレートのバージョン3.3以前をサポートしています。タグのパフォーマンスと機能を最大限に活用するため、最新のタグテンプレートに更新することをお勧めします。
タグに関するヒント
注文IDが存在する場合、購入イベントが発生します。
次のEコマース拡張パラメータをサポートしています。
- 顧客ID(
_ccustidを上書き) - 市区町村(
_ccityを上書き) - 国(
_ccountryを上書き) - 注文ID(
_corderを上書き) - 小計(
_csubtotalを上書き) - 通貨(
_ccurrencyを上書き) - 製品ID(
_cprodを上書き) - 製品数量(
_cquanを上書き)
- 顧客ID(
マッピングを使用して、標準構成値を動的に上書きします。
タグの構成
タグマーケットプレイスに移動して、新しいタグを追加します。詳しくは、タグについてを参照してください。
タグを追加する際は、次の項目を構成します。
コードバージョン
- 使用するBraze Web SDKのメジャー・マイナーバージョンを入力します。
- たとえば、バージョン4.8.1をデプロイする場合は、4.8と入力します。
- コードバージョン4.0以降では、Internet Explorerはサポートされなくなりました。
- Braze Web SDKの最新バージョンについては、変更履歴を参照してください。
APIキー
- BrazeダッシュボードのManage App Group構成で確認できる、一意の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エンドポイントを参照してください。
ログを有効化
- 有効にすると、デバッグ情報がWebコンソールに記録されます。
読み込みルール
読み込みルールでは、サイト上でこのタグのインスタンスを読み込むタイミングと場所を決定します。
データマッピング
データマッピングは、データレイヤー変数の値をベンダータグ内の対応する変数に送信します。詳しくは、データマッピングについてを参照してください。
Braze Web SDKタグの宛先変数は、タグの「データマッピング」タブに組み込まれています。次の表に、使用可能な宛先カテゴリと各宛先名の説明を示します。
標準
| 送信先名 | 説明 |
|---|---|
api_key |
|
code_version |
|
initOpt.allow_crawler |
|
initOpt.app_ver |
|
initOpt.base_url |
|
initOpt.no_cookies |
|
initOpt.no_fntawsm |
|
initOpt.enable_htmlmsgs |
|
initOpt.enable_logging |
|
initOpt.localization |
|
initOpt.min_trggrinterval |
|
initOpt.msg_innewtab |
|
initOpt.card_innewtab |
|
initOpt.explicit_dissmisal |
|
initOpt.safari_pushid |
|
initOpt.srvcewrkr_location |
|
initOpt.session_timeout |
|
initOpt.devicePropertyAllowlist |
|
initOpt.enableSdkAuthentication |
|
initOpt.sdk_auth_signature |
|
initOpt.allow_user_supplied_javascript |
|
initOpt.content_security_nonce |
|
initOpt.disable_push_token_maintenance |
|
initOpt.in_app_message_zindex |
|
Eコマース
Braze Web SDKタグではEコマースが有効になっているため、デフォルトのEコマース拡張機能マッピングが自動的に使用されます。拡張機能マッピングを上書きする場合、またはEコマース変数が拡張機能で提供されていない場合を除き、通常、このカテゴリーで手動マッピングを行う必要はありません。
| 送信先名 | 説明 |
|---|---|
order_id |
|
order_subtotal |
|
order_currency |
|
customer_id |
|
customer_city |
|
customer_country |
|
product_id |
|
product_quantity |
|
イベント
ページ上で特定のイベントをトリガーするには、これらの宛先にマッピングします。
イベントをトリガーするには、次の手順を実行します。
- ドロップダウンリストからイベントを選択します。
- 定義済みのリストから選択するか、カスタムイベントを作成できます。
- カスタムイベントの場合は、イベントを識別するための名前を入力します。
- トリガーフィールドに、マッピングする変数の値を入力します。
- さらにイベントをマッピングするには、**+**ボタンをクリックし、手順1と2を繰り返します。
- 適用をクリックします。
次の表は、指定された値がデータレイヤーで検出されたときにトリガーされるイベントを示しています。
| 宛先名 | 説明 |
|---|---|
Purchase |
|
Alias |
|
addToSubscriptionGroup |
|
AddAtt |
|
IncAtt |
|
RmvAtt |
|
SetAtt |
|
SetAvatar |
|
SetLoc |
|
SetDOB |
|
SetEmail |
|
SetEmailSub |
|
SetPushSub |
|
SetFirst |
|
SetLast |
|
SetCity |
|
SetCountry |
|
SetLang |
|
SetPhone |
|
SetGender |
|
removeFromSubscriptionGroup |
|
setCustomLocationAttribute |
|
SetLineId |
|
Ecommerce |
|
WipeData |
|
RefreshFeatureFlags |
|
LogFeatureFlagImpression |
|
RefreshContentCards |
|
ShowContentCards |
|
LogContentCardImpressions |
|
LogContentCardClick |
|
RequestPushPermission |
|
UnregisterPush |
|
FlushData |
|
RefreshBanners |
|
LogBannerImpressions |
|
LogBannerClick |
|
InsertBanner |
|
Custom |
|
パラメータ
以前にマッピングしたイベントにデータを渡すには、以下の送信先にマッピングします。パラメータは、事前定義済みイベントでのみ使用されます。カスタムイベントでパラメータを渡す方法については、以下の「カスタムイベントデータ」セクションを参照してください。
事前定義済みイベントにパラメータを渡すには、次の手順を実行します。
- 「Event」フィールドで、ドロップダウンリストからイベントを選択します。
- 「Parameter」フィールドで、ドロップダウンリストからパラメータを選択します。
- カスタムパラメータの場合は、カスタムイベントを識別するための名前を入力します。
- + Add をクリックします。
| 送信先名 | 説明 |
|---|---|
product_id |
|
product_quantity |
|
order_id |
|
order_subtotal |
|
order_currency |
|
purchase_properties |
|
alias |
|
label |
|
key |
|
value |
|
inc_value |
|
custom_attributes |
|
line_id |
|
feature_flag_id |
|
banner_placement_ids |
|
banner_placement_id |
|
banner_click_id |
|
banner_parent_selector |
|
content_cards |
|
content_card |
|
ecommerce_event_name |
|
ecommerce_properties |
|
avatar_url |
|
longitude |
|
latitude |
|
accuracy |
|
altitude |
|
altitude_accuracy |
|
year |
|
month |
|
day |
|
email |
|
notification_type |
|
first_name |
|
subscriptionGroupId |
|
last_name |
|
gender |
|
customer_city |
|
customer_country |
|
localization |
|
phone_number |
|
カスタムイベントデータ
以前に「イベント」タブでマッピングしたカスタムイベントとともにカスタムパラメーターを渡す場合は、カスタムイベントデータの送信先にマッピングします。
カスタムイベントデータ変数をマッピングするには、次の手順を実行します。
- イベント名に、イベントタブで指定したとおりにカスタムイベントの名前を入力します。
- パラメーターに、送信するパラメーターの名前を入力します。
- + 追加をクリックします。
Cookieの同意
ユーザーの同意状態に基づいてBraze SDKを有効または無効にするには、Cookieの同意の送信先にマッピングします。同意による制御は、SDKの初期化前に実行されます。
| 値 | 説明 |
|---|---|
grant | SDKを有効にし、データ収集の続行を許可します。SDKは通常どおり初期化され、セッションが開始されます。 |
revoke | 初期化前にSDKを無効にします。データは収集されず、セッションも開始されません。 |
ベンダーのドキュメント
最終更新日 :: 2026年November月10日