Google 広告と Firebase 向け Google アナリティクスのカスタムイベント - iOS

1. はじめに

最終更新日: 2020 年 12 月 14 日

作成するアプリの概要

この Codelab では、GA4F iOS SDK でカスタムイベントを実装し、Google 広告でアクションキャンペーンを開始する方法を学びます。

この Codelab では、クライアントが直面しているアプリビジネスの全プロセスを体験できます。Firebase iOS の概要を簡単に知りたい場合は、Firebase iOS Codelab Swift から始めることをおすすめします。

学習内容

iOS Swift で GA4F（Firebase 向け Google アナリティクス）を初期化する方法
カスタムのイベントとパラメータの作成方法
Firebase から Google 広告にイベントをインポートする方法
カスタムイベントを使用したアクションキャンペーンの開始

必要なもの

Xcode
Firebase アカウント
Google 広告アカウント

2. 新しい iOS Swift プロジェクトを開始する

テンプレート化された簡単な iOS Swift アプリを作成し、このスターターアプリを修正して最終的なアプリを完成させます。

まず、Xcode を起動します。

開いているプロジェクトがない場合は、スタートページで [Create a new Xcode project] を選択します。
ダイアログの上部にある [iOS] を選択します。
[アプリケーション] セクションで [アプリ] を選択し、[次へ] をクリックします。
表示されたダイアログで、次の値を使用してアプリに名前を付け、プロジェクトの追加オプションを選択して、[次へ] をクリックします。
プロダクト名: 例: ios-app

Xcode は、入力した商品名を使用して、プロジェクトとアプリに名前を付けます。

チーム: 自動的に入力されない場合は、チームを [なし] に設定します。
組織名: 組織の名前またはご自身の名前。
バンドル ID: この値は、商品名と組織 ID に基づいて自動的に生成されます。
言語: Swift
プロジェクトの保存場所を選択して、[作成] をクリックします。
Xcode で新しいプロジェクトがワークスペースウィンドウに開きます。

3. Firebase プロジェクトを作成して設定する

Firebase の利用を開始するには、Firebase プロジェクトを作成して設定する必要があります。

Firebase プロジェクトを作成する

Google アナリティクスが有効になっていない既存の Firebase プロジェクトがある場合は、[設定] > [プロジェクトの設定] の [統合] タブで Google アナリティクスを有効にできます。Firebase の設定手順に進みます。

Firebase にログインします。

Firebase コンソールで、[プロジェクトを追加]（または [プロジェクトを作成]）をクリックし、Firebase プロジェクトに「Firebase-iOS-Ads」という名前を付けます。

プロジェクト作成オプションをクリックします。プロンプトが表示されたら、Firebase の利用規約に同意します。アクションイベントとコンバージョンのトラッキングのために Google アナリティクスイベントが必要となるので、このプロジェクトでは Google アナリティクスを有効にする必要があります。

Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。

4. Firebase の構成

Firebase コンソールの左側のナビゲーションで [プロジェクトの概要] > [プロジェクト設定] を選択し、[全般] > [アプリ] の下の [iOS] ボタンをクリックします。

次のダイアログが表示されます。

指定を必要とする重要な値は iOS バンドル ID です。次の手順で取得します。
iOS アプリの Xcode プロジェクトで、プロジェクトナビゲータで最上位のアプリを選択し、[General] タブを選択します。
[Bundle Identifier] フィールドの値が iOS バンドル ID です（例: com.yourcompany.yourproject）。この値をコピーします。
Firebase のダイアログで、コピーしたバンドル ID を iOS bundle ID フィールドに貼り付けます。
[アプリを登録] をクリックします。
引き続き Firebase 内で、指示に沿って構成ファイル GoogleService-Info.plist をダウンロードします。

Xcode プロジェクトに移動し、先ほどダウンロードした GoogleService-Info.plist ファイルを Xcode プロジェクトのルートに移動します。
残りの手順をスキップして、Firebase コンソールのメインページに戻ります。

5. Xcode で Firebase 向け Google アナリティクスを構成する

このステップでは、Xcode プロジェクトに Firebase SDK を追加します。

ターミナルウィンドウを開き、アプリの Xcode プロジェクトの場所に移動します。
Podfile がない場合は作成します:

$ pod init

Podfile を開いて以下を追加します。

$ vi Podfile

$ pod 'Firebase/Analytics'

ファイルを保存して、次のコマンドを実行します。

$ pod install

初期化コードを追加します。

アプリの起動時に Firebase を接続するには、メインの AppDelegate クラスに以下の初期化コードを追加します。

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

これで設定はすべて完了です。コンソールに進みます。

これで、カスタムイベントログを起動できるようになりました。

6. Firebase 向け Google アナリティクスを使用してカスタムイベントを記録する

このステップでは、iOS アプリで Firebase 向け Google アナリティクスを使用してカスタムイベントを記録する方法を学びます。

Firebase 向け Google アナリティクスでは、一部のイベントが自動的にロギングされるので、それらのイベントを受信するコードを追加する必要はありません。それ以外のデータをアプリで収集する場合は、最大 500 種類までのアナリティクスカスタムイベントをロギングできます。

イベントをロギングする

FirebaseApp インスタンスを構成すると、logEvent() メソッドを使ってイベントをログに記録できるようになります。

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

デフォルトのイベントパラメータを設定する

setDefaultEventParameters を使用して、複数のイベントに共通するパラメータをロギングできます。デフォルトのパラメータは、ロギングされる今後のすべてのイベントに関連付けられます。

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Xcode デバッグコンソールでイベントを表示する

詳細ログを有効にして SDK によるイベントのロギングをモニタリングし、イベントが正しくロギングされているかどうかを確認できます。対象となるのは、自動でロギングされるイベントと手動でロギングされるイベントの両方です。

詳細ログを有効にする方法は、次のとおりです。

Xcode で [Product] > [Scheme] > [Edit scheme] の順に選択します。
左側のメニューから [Run] を選択します。
[Arguments] タブを選択します。
[Arguments Passed On Launch] セクションで -FIRAnalyticsDebugEnabled を追加します。

以後、アプリを実行すると Xcode のデバッグコンソールにイベントが表示され、イベントが送信されているかどうかをすぐに確認できます。

ダッシュボードでイベントを表示する

数時間後には、ログに記録されたイベントを Firebase コンソールで確認できるようになります。[アナリティクス] → [イベント] にあります。イベントをクリックしてパラメータ値を確認することもできます。

[コンバージョンとしてマークを付ける] スイッチを右にスライドして、「text_search」をコンバージョンとしてマークします。

イベントがコンバージョンとして正常にマークされているかどうかは、Firebase 向け Google アナリティクスの [コンバージョン] タブで確認できます。イベントをコンバージョンとしてマークすることで、Google 広告にイベントをコンバージョンとしてインポートすることもできます。

7. Google 広告にアナリティクスイベントをインポートする

Firebase-iOS の設定が完了したら、アクションイベントが記録されたアプリキャンペーンを立ち上げることができます。まず、Firebase を Google 広告にリンクします。Firebase を Google 広告にリンクすると、アプリキャンペーンでオーディエンスに関する詳細な情報を取得し、アプリキャンペーンの学習を促進できます。これにより、通常はパフォーマンスとコンバージョンが向上します。