Firebaseリモートコマンドタグの構成ガイド（モバイル）

概要

Tealium IQでFirebaseタグを実装する際には、ネイティブコードとTealium内の両方で編集が必要な3つのコンポーネントがあります。まず、アプリにFirebase SDKを含める必要があります。次に、Tealium SDKを介してネイティブコードにリモートコマンドを追加する必要があります。最後に、FirebaseタグをTealium IQに追加します。これらの3つのパーツすべてを実装する必要があります。そうしないと、Firebaseはデータを受信しません。

ネイティブコードの構成

ステップ1 - Firebase SDKをネイティブアプリに追加する

ステップ2 - Tealium SDKをネイティブアプリに追加する

ステップ3 - ネイティブアプリにリモートコマンドクラスを含める

すべてのライブラリについて、Firebase Analyticsリモートコマンドを使用する前に登録する必要があります。これはライブラリを初期化するときに行う必要があります。使用しているモバイルプラットフォームに基づいて、ガイドに従ってリモートコマンドを実装してください。

Tealium IQの構成

ステップ1 - Firebaseタグを追加する

Firebaseタグは、Tealiumモバイルライブラリに登録されたカスタムネイティブコードブロックをトリガーするために必要なAPIの実装を含む特別なタグです。このタグはタグマーケットプレースで利用可能であり、ネイティブアプリの構成の「ステップ3」と通信します。

動作原理

ネイティブコードによってトリガーされるTealiumイベント（ビューまたはイベント）は、Webビュー内のutag.jsによって取り込まれます。Firebaseタグと関連する拡張機能は、イベントを確認し、Firebaseに収集されるようにタグからのFirebaseイベントをリモートコマンドに送信します。リモートコマンドは、タグからのリクエストを受け取り、イベントをフォーマットして送信します。

ステップ2 - タグの構成を行う

構成の唯一のオプションは、デバッグモードを有効にするかどうかです。このオプションを有効にする必要があるかどうかは、開発者による判断です。デフォルトの構成は「False」です。

ステップ3 - マッピングの追加

セットアップ

タグが機能するためには、特定のマッピングが必要です。これらは適用する必要のある一般的な構成です。

• セッションタイムアウト（秒）
• セッションの最小値（秒）
• Firebaseログレベル
• スクリーン名
• コマンド名
• Firebaseイベント

これらは静的な値として構成することも、拡張機能を使用して動的に構成することもできます。

変数	説明
firebase_session_timeout_seconds	文字列としての整数
firebase_session_minimum_seconds	文字列としての整数
firebase_analytics_enabled	文字列としてのブール値
firebase_log_level	文字列
firebase_event_name	文字列
firebase_event_params	JSON
firebase_screen_name	文字列
firebase_screen_class	文字列
firebase_property_name	文字列
firebase_property_value	文字列
firebase_user_id	文字列
command_name	文字列

自動イベント

一部のイベントはFirebase SDKによって自動的に収集され、Tealium Firebaseタグを使用して構成する必要はありません。これらのイベントのリストについては、こちらをクリックしてください。

標準イベント

イベント名は、アプリで発生するキャプチャする必要のあるイベント（カートイベント、検索イベント、支払いイベントなど）です。以下はFirebase SDKを介して利用可能な標準イベントのリストです。リストにイベントがない場合は、logEventカスタムイベントを使用して送信することができます。

変数
config
setScreenName
setUserProperty
setUserId
logEvent
resetData
event_add_payment_info
event_add_to_cart
event_add_to_wishlist
event_app_open
event_begin_checkout
event_campaign_details
event_checkout_progress
event_earn_virtual_currency
event_ecommerce_purchase
event_generate_lead
event_join_group
event_level_up
event_level_start

Firebaseイベントは、他のタグと同様にマッピングされます。値はデータレイヤーから取得するか、拡張機能を介して構成し、次のようにタグにマッピングされます。

カスタムイベント

デフォルトのイベントのリストに含まれていないイベントを送信する場合は、イベント名にカスタム値を添付してlogEventイベントを送信する必要があります。

1. 変数の値をlogEventイベントにマップします。
2. logEventイベントとともにイベント名を送信するためのパラメータを追加します。

標準パラメータ

イベントパラメータはイベントと一緒に送信され、以下のリストのパラメータにマッピングできます。パラメータは2つの方法でマッピングできます。

• 任意のイベントと一緒に送信される標準パラメータとして
• 指定されたイベントと一緒にのみ送信されるイベントパラメータとして

変数	説明
param_achievement_id	文字列
param_ad_network_click_id	文字列
param_affiliation	文字列
param_cp1	文字列
param_campaign	文字列
param_character	文字列
param_checkout_option	文字列
param_checkout_step	整数
param_content	文字列
param_content_type	文字列
param_coupon	文字列
param_creative_name	文字列
param_creative_slot	文字列
param_currency	文字列
param_destination	文字列
param_end_date	文字列
param_flight_number	文字列
param_group_id	文字列
param_index	文字列
param_item_brand	文字列
param_item_category	文字列
param_item_id	文字列
param_item_list	文字列
param_item_location_id	文字列
param_item_name	文字列
param_item_variant	文字列
param_level	整数
param_location	整数
param_medium	文字列
param_number_nights	整数
param_number_pax	整数
param_number_rooms	整数
param_origin	文字列
param_price	整数または浮動小数点数
param_quantity	整数
param_score	整数
param_search_term	文字列
param_shipping	浮動小数点数
param_method	文字列
param_source	文字列
param_travel_class	文字列
param_virtual_currency_name	文字列
param_start_date	文字列
param_term	文字列
param_tax	浮動小数点数
param_transaction_id	文字列
param_value	整数または浮動小数点数
param_level_name	文字列
param_success	文字列
E-コマース
order_id	文字列 _corderを上書きします
order_total	整数または浮動小数点数 _ctotalを上書きします
order_shipping	浮動小数点数 _cshipを上書きします
order_tax	浮動小数点数 _ctaxを上書きします
order_currency	文字列 _ccurrencyを上書きします
order_coupon_code	文字列 _cpromoを上書きします
product_id	配列 _cprodを上書きします
product_name	配列 _cprodnameを上書きします
product_brand	配列 _cbrandを上書きします
product_category	配列 _ccatを上書きします
product_quantity	配列 _cquanを上書きします
product_unit_price	配列 _cpriceを上書きします
param_item_list	配列
param_item_variant	配列
param_index	配列

カスタムパラメータ

上記のリストにパラメータがない場合は、イベントと一緒にカスタムパラメータを送信する必要があります。カスタムパラメータをイベントに追加する場合は、JSON形式で送信されることに注意してください。マップされた変数の値はJavaScriptコード拡張で構成する必要があります。複数のイベントは次のようにフォーマットできます。

カスタムパラメータを送信するためのマッピングは、次のように構成されます。

ヒント

Firebaseリモートコマンドタグを構成する際には、以下の点に注意してください。

• configコマンドは、イベントリストに見つからない場合、最初のロード時に自動的に送信されます。
• 適切なデータが提供されている場合（ユーザーIDにマップされた変数）、event_loginおよびevent_signupイベントは自動的にsetUserIdおよびsetUserPropertyイベントを送信します。
• 適切なデータが提供されている場合（スクリーン名にマップされた変数）、event_view_item_list、event_view_item、event_ecommerce_purchase、event_begin_checkoutは自動的にsetScreenNameイベントを送信することができます。
• 単数のパラメータまたはEコマースの配列のいずれかのみを使用してください。

Firebaseに関する注意事項

FirebaseはGoogle Analyticsとは異なり、異なる用語と完全に異なる構成を持っています。変数/マッピングは1対1に変換されないため、Firebaseにはカスタムディメンションは含まれていません。パラメータはカスタムディメンションの代わりに使用され、適切に使用する必要があります。カスタムパラメータが必要な場合は、Firebase内で構成することができます。

A/BテストのパラメータはFirebaseに保存され、Tealiumからアクセスすることはできません。A/BテストデータをTealium内で使用する必要がある場合は、BigQueryを使用してFirebaseからデータを無料でエクスポートすることができます。そのデータをTealiumのサーバーサイド製品にインポートし、コネクタ/オーディエンスで使用することができます。

リソース

Tealium Firebaseリモートコマンドの統合
Firebaseリモートコマンドの例 - iOS（Github）
Firebaseリモートコマンドの例 - Android（Github）
Google Firebaseガイド
自動収集イベント - Firebase