この記事では、Android/iOS v5.0以降のTealiumを使用していることを前提としており、アプリを再デプロイする必要があります。以下は、ハイブリッドアプリの各コンポーネントに対する解決策の概要です。
| ハイブリッドアプリ | |||
| ネイティブコード コンポーネント | ネイティブコードは、次のURLでWebビューをロードします：&session_id=SESSION
| Webビュー コンポーネント | |
|---|---|---|---|
| iQモバイルプロファイル （非表示のWebビューで実行） | ネイティブコード | ウェブサイト用iQプロファイル | |
カスタムリモートコマンド ベンダーからセッションIDを取得するJavaScriptコード拡張 セッションIDを渡すための | syncSessionIdを同期するためのリモートコマンドのカスタムコード セッションID変数をWebビューに渡すためのカスタムコード | WebビューURLのクエリ文字列変数
| |
このコードは完全に機能しますが、このタスクを達成するためのサンプルコードです。ご自身の判断で使用し、ライブアプリにデプロイする前に必ずテストしてください。1. `syncSessionId`という新しいリモートコマンドを定義し、渡されたセッションIDの値を`sessionId`というネイティブ変数に格納します。このコードをTealiumの`init`ブロックに配置します（これは通常、ヘルパーファイルになります）： ```java // Tealiumの初期化 Tealium.Config config = Tealium.Config.create(application, "", "", ""); // 上記のconfigオブジェクトを使用して新しいTealiumインスタンスを作成します Tealium inst = Tealium.createInstance(TEALIUM\_INSTANCENAME, config); // "syncSessionId"という名前の新しいRemoteCommandをTealiumに登録します inst.addRemoteCommand(new RemoteCommand("syncSessionId", "セッションIDを同期します") { // onInvokeは、Tealium iQがコマンドをトリガーしたときに呼び出されます @Override protected void onInvoke(Response response) throws Exception { // レスポンスオブジェクトを取得します JSONObject resp = response.getRequestPayload(); // レスポンス内のキー"sessionId"の値をアプリケーションレベルの"gaSessionId"文字列変数に設定します // これは、Applicationクラスでこの共有変数を作成したことを前提としています。詳細については、サンプルアプリを参照してください。 DemoApplication.sessionId = resp.optString("sessionId", null); } }); ``` 1. Webビューをカスタマイズして、ネイティブコードに格納されたセッション値をクエリ文字列パラメータ`session_id`として追加します。以下は、Webビューが作成され、セッションIDがクエリ文字列パラメータとして渡される例です： ```java public class WebviewActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_webview); webview mywebview = (webview) findViewById(R.id.webview); mywebview.clearCache(true); mywebview.getSettings().setJavaScriptEnabled(true); mywebview.loadUrl("https://solutions.tealium.net/hosted/cpr/mobile_ga_demo.html?session_id=" + DemoApplication.sessionId); } } ``` #### iOS（Objective-Cコード） 以下は、同じことをiOSで実現するために必要なObjective-Cコードの一部です。このコードにはWebビューの作成は含まれておらず、出発点として含まれています。 ```objc // インスタンス名を置き換えてください Tealium *instanceHandle = [Tealium instanceForKey: @"tealium"]; [instanceHandle addRemoteCommandID:@"syncSessionId" description:@"セッションIDを同期します" targetQueue:dispatch_get_main_queue() // レスポンスは、Tealium iQで設定したマッピングから生成されます responseBlock:^(TEALRemoteCommandResponse * _Nonnull response) { // レスポンスオブジェクトからセッションIDを取得します NSString *session_id = response.requestPayload[@"sessionId"]; /* セッションIDを取得したので、後でWebビューを作成するときにアクセスできる場所に保存します。詳細については、Androidコードを参照してください */ }\]; ``` ### カスタムリモートコマンドタグの追加（モバイルWeb用のiQプロファイル） iQモバイルプロファイルでは、カスタムリモートコマンドタグを使用して、ネイティブコードで定義したリモートコマンドをトリガーします。このタグにデータマッピングを追加すると、リモートコマンドがそのデータを受け取ります。 モバイルWeb用のiQプロファイルで以下の手順に従ってください。 1. データレイヤーに次のUDO変数を追加します：`session_id` 2. **カスタムリモートコマンド**タグを追加します：  3. **コマンドID**を`syncSessionId`（ネイティブコードで定義したリモートコマンドの名前）に設定します：  4. `session_id`を`sessionId`にマッピングするデータマッピングを追加します。  ### ベンダータグの追加（モバイルアプリ用のiQプロファイル） モバイルアプリのiQプロファイルでは、ベンダータグ（この例ではGoogle Analytics）を使用してセッションを開始し、`utag.link()`を呼び出してカスタムリモートコマンドタグにセッションIDの値を渡します。おそらく、ネイティブアプリのトラッキングの目的で既にこのタグをモバイルプロファイルに追加しているでしょう（多くの人気のあるアナリティクスタグはモバイル対応しています）。 ベンダータグを追加して設定する手順は次のとおりです。 1. ベンダータグを追加します（まだ追加していない場合）。 2. ベンダータグ（Google Analyticsの場合）にスコープが設定されたJavaScriptコード拡張を追加します。以下はその内容です。`UID`をカスタムリモートコマンドタグのUIDに置き換えてください。 ```js window.setTimeout(function() { // ベンダー固有: Google AnalyticsからセッションIDを取得します var tracker = window.ga.getByName('tealium_0'); // ページ上にGAトラッカーが1つしかない場合を想定しています var clientId = tracker.get('clientId'); // カスタムリモートコマンドがトリガーされたトラッキングコール utag.link({session_id : clientId}, null, ['UID']) }, 1000); ``` この拡張は、タグがロードされるのに十分な時間を与えるために1秒待機し、ベンダーからセッションIDを取得します。その後、`utag.link()`を呼び出してカスタムリモートコマンドタグをトリガーし、パラメータとして`session_id`を渡します。その後、カスタムリモートコマンドタグはそのデータをリモートコマンド`syncSessionId`に渡し、ネイティブコードでそれを後で使用するために保存します。 ### ベンダータグの追加（モバイルWeb用のiQプロファイル） ハイブリッドアプリのWebビューコンポーネントでロードされるウェブサイト用のiQ Webプロファイル（Webプロファイル）では、セッションIDに使用されるクエリ文字列パラメータを検出し、その変数をベンダータグにマッピングします。 セッションIDを同期するためにベンダータグを構成する手順は次のとおりです。 1. ベンダータグを追加します（まだ追加していない場合）。 2. クエリ文字列パラメータのタイプである`session_id`という名前の新しいデータレイヤー変数を追加します。 3. ベンダータグに、`session_id`を`clientId`にマッピングするデータマッピングを追加します（Google Analyticsの場合）。 以上で完了です。上記の手順に従った場合、アプリのWebビューはネイティブアプリと同じセッション識別子を受け取り、ユーザーはGoogle Analyticsの観点からは単一のセッションを使用することになります。 ### 結果の検証 上記のコードをデプロイした後、Charles ProxyやFiddlerなどのローカルプロキシを使用して、アプリの出力を表示できます。`www.google-analytics.com`への送信ヒットを検査すると、ネイティブアプリからのヒットとWebビューコンポーネントからのヒットで`cid`パラメータが同じであることを確認できます。 詳細については、[モバイルインストールのトラブルシューティング](https://docs.tealium.com/ja/platforms/getting-started-mobile/troubleshooting/)を参照してください。 ネイティブアプリからの共有セッションID：  インアプリのWebビューからの共有セッションID：  Android Studioプロジェクトとしてサンプルアプリをダウンロード：[GAwebviewDemo.zip](https://docs.tealium.com/images/platforms/remote-commands/GAWebViewDemo.zip)。 ## その他の解決策 このガイドでは、Google AnalyticsのセッションIDを同期する方法について説明しましたが、同じ手順をWebtrends、Webtrekk、Adobe Analyticsなどの他のベンダーにも簡単に適用できます。ベンダーによっては、セッションIDを提供するAPIがない場合、クッキーの値を読み取る必要があるかもしれません。 この記事で文書化された解決策は、アナリティクスツールの範囲外でアプリに他の情報を渡すためにも使用できます。カスタムリモートコマンドタグにさらにマッピングを追加することで、1回の呼び出しで複数のパラメータを渡すことも可能ですが、レスポンスオブジェクト内の追加のパラメータを処理するためにネイティブリモートコマンドコードを適応する必要があります。