Skip to content

Shopify標準統合とサードパーティタグツール

このページでは、Google Tag ManagerのようなサードパーティツールをShopify標準統合で使用し、Braze Web SDKを初期化して読み込む方法をご案内します。

Shopifyオンラインストアの場合は、Brazeの標準統合方法を使用して、サイトでBraze SDKをサポートすることを推奨します。ただし、Google Tag Managerのようなサードパーティツールの使用を希望される場合があることも理解しています。BrazeのShopifyコネクターでサードパーティツールを使用する場合は、Braze統合とアプリ埋め込みがチェックアウトプロセス中にSDKを管理することに留意してください。

要件

  • サードパーティツールとShopifyコネクター間でAPIキーを統一する: APIキーは、Brazeとサードパーティツールの両方で一貫している必要があります。これにより、重複ユーザーの作成を防ぎ、SDK間の互換性を維持できます。
    • APIキーの場所: 標準統合パスでオンボーディングした後、統合により「Shopify」という名前のBraze Webアプリが自動的に作成されます。サードパーティツールの設定で使用するAPIキーを統合内から取得してください。
  • サードパーティツールとShopifyコネクター間でSDKバージョンを統一する: SDKのバージョンは、サードパーティツール内で5.4に設定する必要があります。誤ったバージョン番号を使用すると、古いバージョンには存在しないSDKメソッドがあるため、互換性の問題が発生する可能性があります。
  • SDK初期化のタイミングを統一する: Shopifyの標準統合設定で、セッション開始時またはアカウントログイン時に初期化するSDKを選択できます。この設定は、サードパーティツールとBrazeの間で一貫している必要があります。不整合があると、ユーザーやデータ同期に下流の問題が発生する可能性があります。

サードパーティツールとの統合設定

提供されたステップから外れると予期しない問題が発生する可能性があるため、必ず手順に従ってください。

  1. Shopify標準統合セットアップで提供されているステップに従います。Braze Web SDKを有効にする際に、サードパーティツールを使用してShopifyサイトにBraze Web SDKを追加することを示すチェックボックスをオンにします。

サードパーティツールを使用してBraze Web SDKを追加することを示すチェックボックスがある「Braze SDK settings」セクション。

  1. Settings > App Settingsに移動し、Shopify Webアプリを選択して、API key for Shopify on Webをコピーします。
  2. APIキーをサードパーティツールのWeb SDK設定に貼り付け、SDKバージョンを5.4に設定します。

Shopifyデータの取得とユーザーの同期

Web SDKがサードパーティツールを通じてShopifyサイトのフロントエンドでアクセス可能である限り、標準統合は期待どおりにShopifyデータを取得し、ユーザーを同期します。

考慮事項と免責事項

  • 初期化設定: サードパーティツールで初期化設定を変更した場合、ユーザーとデータの同期に影響が出る可能性があります。たとえば、Cookie同意フォームが承認されたときにSDKを初期化するように選択した場合、ユーザーが同意するまでBrazeは匿名ユーザーやデータのトラッキングを受信しません。
  • dataLayerを通じて直接属性を設定することはサポートされていません: 属性を設定するには、dataLayerではなくwindow.brazeを使用してください。
  • 重複ユーザーの可能性: APIキーがBrazeとサードパーティツールで一致しない場合、重複ユーザーが作成される可能性があります。
  • SDKの非互換性: 正しくないバージョン番号を使用すると、SDKメソッドで問題が発生する可能性があります。
New Stuff!