現在、SDK の内部ロジックは、下位互換性を確保するために従来の名前を新しい名前にマッピングしています。今後のリリースとの互換性を維持するため、MoEngage は新しい構文に更新することを推奨します。
グローバル API のマッピング
新しい実装にはすべて、標準化されたcamelCase の命名規則を使用してください。
InitData の設定
従来の snake_case の
InitData プロパティは非推奨になりました。これらを使用すると、コンソールに警告メッセージが記録されます。API メソッド
統合スクリプトと内部の呼び出しを更新して、以下の標準化されたメソッドを使用してください。注意:
track、identifyUser、getUserIdentities など、既存の camelCase のメソッドや単一の単語のメソッドは変更されません。影響を受けるプラットフォーム
この移行は、以下のプラットフォームやパッケージマネージャーを含め、MoEngage Web SDK を利用するすべての統合に影響します。- Google Tag Manager (GTM)
- Shopify
- VTEX
- NPM/CDN
- Flutter Web
統合のシナリオ
移行方法は、MoEngage SDK の統合タイプによって異なります。以下から該当するシナリオを特定し、必要な対応を確認してください。固定バージョン
重要: 新しいcamelCase メソッドは、従来の SDK バージョンでは使用できません。ソースコード内の SDK バージョンを 2.71.00 以降 に更新するまで、コードをリファクタリングしないでください。
新規の統合
camelCase メソッドを使用して SDK を実装してください。これにより、統合がモダンな JavaScript 標準とネイティブに互換性を持ち、コンソールの警告を防ぐことができます。
CDN/NPM
script タグが最新バージョンを取得する場合、SDK は従来の呼び出しを新しいロジックに自動的にマッピングします。推奨事項: クリーンな開発環境を維持し、ブラウザコンソールでの非推奨の警告を回避するため、これらの呼び出しを
camelCase にリファクタリングしてください。トラブルシューティング
SDK メソッドを検証したり、残っている従来のコードを特定したりするには、デバッグログを有効にして、ブラウザのコンソールで非推奨の警告を直接確認できます。-
SDK のログを有効にする: まず、次のメソッドを呼び出して MoEngage SDK の詳細ログを有効にする必要があります。ログを確認するには、このメソッドを事前に実行しておく必要があります。
- コンソールログを確認する: ブラウザの開発者ツールを開き、Console タブに移動します。非推奨のメソッドがまだ使用されている場合、SDK はエラーまたは警告メッセージを出力します。