Google Tag マネージャー for Webについて

Google Tag マネージャー（GTM）を使えば、プロダクションコードのリリースやエンジニアリングリソースを必要とせずに、Webサイトのタグをリモートで追加、削除、編集できます。BrazeはWeb SDK用に以下のテンプレートを提供しています。

Brazeアクションタグのタグシーケンス

Braze初期化タグは、Braze SDKメソッド（braze.getUser()、braze.logCustomEvent()、braze.logPurchase()など）を呼び出すすべてのタグよりも先に発火する必要があります。SDKが初期化される前にこれらのメソッドが発火すると、Uncaught TypeError: Cannot read properties of undefined (reading 'getUser') のようなエラーが発生する可能性があります。

Google Tag マネージャーでタグシーケンスを設定するには：

1. Braze SDKメソッドを呼び出すタグ（Custom HTMLタグやBrazeアクションタグなど）を開きます。
2. Advanced Settings > Tag Sequencingに移動します。
3. A tag that fires before [this tag] is firedを選択します。
4. Braze Initializationタグを選択します。

これにより、他のタグがBrazeメソッドを呼び出す前に、SDKが完全に読み込まれます。

詳細については、カスタムイベントのタグシーケンスの検証を参照してください。

トラブルシューティング

Web SDKのセッションが誤ったユーザーに紐付けられる

GTMがBrazeの初期化タグやイベントタグを、アプリがサインイン済みユーザーを特定する前に発火させると、セッションやイベントが誤ったプロファイルに紐付けられる場合があります。Web SDKを初期化し、サインイン済みユーザーのexternal_idを指定してchangeUser()を呼び出し、その後イベントのロギングや属性の設定を行うタグの前にopenSession()を呼び出してください。GTMのタグシーケンスや同意トリガーを使用して、認証フローが完了した後にのみBrazeタグが実行されるようにしてください。

ShopifyまたはスクリプトタグでインストールしたWeb SDKのコンソールログ

Shopifyアプリの埋め込みはコンソールログをオフにしてWeb SDKを読み込みます。GTM初期化タグまたはinitialize()オプションでログを設定してください。Brazeダッシュボードには、これらのローダーに対するログ制御は含まれていません。

ブラウザコンソールにBrazeのログが表示される場合は、本番環境に公開する前にGTM初期化タグまたはカスタムHTMLからenableLogging: trueを削除してください。初期化後は、toggleLogging()または?brazeLogging=true URLパラメーターを使用してください。Web SDKの全オプションについては、詳細ログを参照してください。

Brazeが初期化されない場合やイベントが期待どおりに表示されない場合は、GTMコンテナが公開済みであること、トリガーとタグの発火順序がSDKのライフサイクルと初期化戦略と合致していること、テストデバイスがBrazeエンドポイントをブロックしていないことを確認してください。

初期化の失敗については、Brazeタグまたはカスタムタグプロバイダーが期待されるactionTypeとパラメーターを受信していることを確認してください（このページのAndroid、Swift、Webタブを参照）。GTMから発火されたイベントを検証する際の詳細ログについては、それらのタブからリンクされているプラットフォーム統合ガイドの説明に従って、各プラットフォームのSDKデバッグログを有効にしてください。