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

概要

Tealium iQでFirebaseタグを実装するには、ネイティブコードとTealiumの両方に変更を加える3つのコンポーネントが必要です。まず、アプリにFirebase SDKを追加します。次に、Tealium SDKを使用してネイティブコードにリモートコマンドを統合します。最後に、Tealium iQにFirebaseタグを追加します。これら3つのステップがすべて必要です。

タグのヒント

• initiateconversionmeasurement メソッド（iOSのみ）は以下の4つのパラメータをサポートしていますが、1つだけを渡すことができます：
  • param_email_address
  • param_phone_number
  • param_hashed_email_address
  • param_hashed_phone_number
• ハッシュ化されたパラメータは、Firebaseのドキュメントに記載されているように正規化します。

ネイティブコードの構成

• ステップ1 – ネイティブアプリにFirebase SDKを追加します。
• ステップ2 – ネイティブアプリにTealium SDKを追加します。
• ステップ3 – ネイティブアプリにリモートコマンドクラスを含めます。

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

Tealium iQの構成

ステップ1 – Firebaseタグを追加

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

動作方法

Tealiumイベント（ビューまたはイベント）はネイティブコードによってトリガーされ、その後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
• 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_end
• event_level_start
• event_level_up
• event_login
• event_post_score
• event_present_offer
• event_purchase_refund
• event_remove_cart
• event_search
• event_select_content
• event_set_checkout_option
• event_share
• event_signup
• event_spend_virtual_currency
• event_tutorial_begin
• event_tutorial_complete
• event_unlock_achievement
• event_view_item
• event_view_item_list
• event_view_search_results
• logEvent
• resetData
• setScreenName
• setUserId
• setUserProperty
• initiateconversionmeasurement (iOSのみ)

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

カスタムイベント

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

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

標準パラメータ

イベントと共に送信されるイベントパラメータは、以下のリストにあるパラメータにマッピングできます。パラメータのマッピングは2つの方法で行うことができます：

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

変数	タイプ/値	説明
param_achievement_id	String	実績ID。
param_ad_network_click_id	String	広告ネットワーククリックID。
param_affiliation	String	所属。
param_cp1	String	CP1。
param_campaign	String	キャンペーン。
param_character	String	キャラクター。
param_content	String	コンテンツ。
param_content_type	String	コンテンツタイプ。
param_coupon	String	クーポン。
param_creative_name	String	クリエイティブ名。
param_creative_slot	String	クリエイティブスロット。
param_currency	String	通貨。
param_destination	String	目的地。
param_end_date	String	終了日。
param_flight_number	String	フライト番号。
param_group_id	String	グループID。
param_index	String	インデックス。
param_item_brand	String	アイテムブランド。
param_item_category	String	アイテムカテゴリ。
param_item_id	String	アイテムID。
param_item_list	String	アイテムリスト。
param_item_name	String	アイテム名。
param_item_variant	String	アイテムバリアント。
param_level	Long	レベル。
param_location	Long	位置。
param_medium	String	ミディアム。
param_number_nights	Long	宿泊数。
param_number_pax	Long	乗客数。
param_number_rooms	Long	部屋数。
param_origin	String	発地。
param_price	Double	価格。
param_quantity	Long	数量。
param_screen_name	String	スクリーン名。
param_screen_class	String	スクリーンクラス。
param_score	Long	スコア。
param_search_term	String	検索語。
param_shipping	Double	配送料。
param_method	String	方法。
param_source	String	ソース。
param_travel_class	String	旅行クラス。
param_virtual_currency_name	String	仮想通貨名。
param_start_date	String	開始日。
param_term	String	期間。
param_tax	Double	税金。
param_transaction_id	String	トランザクションID。
param_value	Long or Double	値。
param_level_name	String	レベル名。
param_success	String	成功。
param_ad_format	String	広告フォーマット。
param_ad_platform	String	広告プラットフォーム。
param_ad_source	String	広告ソース。
param_ad_unit_name	String	広告ユニット名。
param_campaign_id	String	キャンペーンID。
param_creative_format	String	クリエイティブフォーマット。
param_discount	String	割引。
param_extend_session	String	セッション延長。
param_item_category2	String	アイテムカテゴリ2。
param_item_category3	String	アイテムカテゴリ3。
param_item_category4	String	アイテムカテゴリ4。
param_item_category5	String	アイテムカテゴリ5。
param_item_list_id	String	アイテムリストID。
param_item_list_name	String	アイテムリスト名。
param_items	Array	アイテム。
param_level_name	String	レベル名。
param_location_id	String	位置ID
param_marketing_tactic	String	マーケティング戦術。
param_payment_type	String	支払いタイプ。
param_promotion_id	String	プロモーションID。
param_promotion_name	String	プロモーション名。
param_shipping_tier	String	配送層。
param_source_platform	String	ソースプラットフォーム。
param_travel_class	String	旅行クラス。
param_virtual_currency_name	String	仮想通貨名。
param_user_signup_method	String	ユーザー登録方法。
param_user_allow_ad_personalization_signals	String	ユーザーが広告のパーソナライゼーション信号を許可。
param_email_address	String	メールアドレス。
param_phone_number	String	電話番号。
param_hashed_email_address	String	ハッシュ化されたメールアドレス。
param_hashed_phone_number	String	ハッシュ化された電話番号。

E-Commerce

変数	タイプ/値	説明
order_id	String	注文ID（_corderを上書き）。
order_total	Long or Double	注文合計（_ctotalを上書き）。
order_shipping	Double	配送料（_cshipを上書き）。
order_tax	Double	税金（_ctaxを上書き）。
order_currency	String	通貨（_ccurrencyを上書き）。
order_coupon_code	String	プロモコード（_cpromoを上書き）。
product_id	Array	製品IDのリスト（_cprodを上書き）。
product_name	Array	名前のリスト（_cprodnameを上書き）。
product_brand	Array	ブランドのリスト（_cbrandを上書き）。
product_category	Array	カテゴリのリスト（_ccatを上書き）。
product_quantity	Array	数量のリスト（_cquanを上書き）。
product_unit_price	Array	価格のリスト（_cpriceを上書き）。
param_item_list	Array	プレゼンテーションリストのリスト。
param_item_variant	Array	バリアントのリスト。
param_index	Array	インデックスのリスト。

同意構成

変数	タイプ/値	説明
ad_storage	String	広告保存。
analytics_storage	String	分析保存。
ad_user_data	String	広告ユーザーデータ。
ad_personalization	String	広告パーソナライゼーション。

イベント

イベントのマッピングについては、イベントマッピングの作成を参照してください。

イベント	説明
config	構成。
setScreenName	スクリーン名を構成。
setUserProperty	ユーザープロパティを構成。
setUserId	ユーザーIDを構成。
logEvent	イベントを記録。
resetData	データをリセット。
event_add_payment_info	支払情報を追加。
event_add_to_cart	カートに追加。
event_add_to_wishlist	ウィッシュリストに追加。
event_app_open	アプリを開く。
event_begin_checkout	チェックアウトを開始。
event_campaign_details	キャンペーンの詳細。
event_earn_virtual_currency	仮想通貨を獲得。
event_generate_lead	リードを生成。
event_join_group	グループに参加。
event_level_up	レベルアップ。
event_level_start	レベル開始。
event_level_end	レベル終了。
event_login	ログイン。
event_post_score	スコアを投稿。
event_remove_cart	カートから削除。
event_screen_view	スクリーンビュー。
event_search	検索。
event_select_content	コンテンツを選択。
event_share	共有。
event_signup	サインアップ。
event_spend_virtual_currency	仮想通貨を使用。
event_tutorial_begin	チュートリアル開始。
event_tutorial_complete	チュートリアル終了。
event_unlock_achievement	実績を解除。
event_view_item	アイテムを表示。
event_view_item_list	アイテムリストを表示。
event_view_search_results	検索結果を表示。
event_ad_impression	広告インプレッション。
event_add_shipping_info	配送情報を追加。
purchase	購入。
event_refund	払い戻し。
event_select_item	アイテムを選択。
event_select_promotion	プロモーションを選択。
event_view_cart	カートを表示。
event_view_promotion	プロモーションを表示。
initiateconversionmeasurement	変換測定を開始。
resetdata	データをリセット。
setConsent	同意を構成。

パラメータ

イベントをマッピングするには、イベントマッピングの作成を参照してください。

イベント	説明
param_ad_format	広告フォーマット。
param_ad_platform	広告プラットフォーム。
param_ad_source	広告ソース。
param_ad_unit_name	広告ユニット名。
param_campaign_id	キャンペーンID。
param_creative_format	クリエイティブフォーマット。
param_discount	割引。
param_extend_session	セッション延長。
param_item_category2	アイテムカテゴリー2。
param_item_category3	アイテムカテゴリー3。
param_item_category4	アイテムカテゴリー4。
param_item_category5	アイテムカテゴリー5。
param_item_list_id	アイテムリストID。
param_item_list_name	アイテムリスト名。
param_items	アイテム。
param_level_name	レベル名。
param_location_id	ロケーションID。
param_marketing_tactic	マーケティング戦術。
param_payment_type	支払いタイプ。
param_promotion_id	プロモーションID。
param_promotion_name	プロモーション名。
param_shipping_tier	配送層。
param_source_platform	ソースプラットフォーム。
param_travel_class	旅行クラス。
param_virtual_currency_name	仮想通貨名。
param_user_signup_method	ユーザー登録方法。
param_email_address	メールアドレス。
param_phone_number	電話番号。
param_hashed_email_address	ハッシュ化されたメールアドレス。
param_hashed_phone_number	ハッシュ化された電話番号。
param_user_allow_ad_personalization_signals	ユーザーが広告のパーソナライゼーション信号を許可。
ad_storage	広告保存。
analytics_storage	アナリティクス保存。
ad_user_data	広告ユーザーデータ。
ad_personalization	広告パーソナライゼーション。

カスタムパラメータ

上記の表にパラメータがない場合、イベントにカスタムパラメータを送信する必要があります。イベント（標準またはカスタム）にカスタムパラメータを追加する際には、それらがイベントと共に送信され、JSON形式である必要があります。マッピングされた変数の値は、Javascript拡張を使用して構成する必要があります。複数のイベントは、以下の図に示すようにフォーマットできます：

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

ヒント

Firebase Remote Command Tagを構成する際に留意すべきいくつかの項目です。

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

Firebaseについての注意

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

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

リソース

Tealium Firebase Remote Command Integration
Firebase Remote Command Example – iOS (Github)
Firebase Remote Command Example – Android (Github)
Google Firebase Guide
Automatically Collected Events – Firebase