このページは Cloud Translation API によって翻訳されました。

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] を選択します。
[Application] セクションで [App] を選択し、[Next] をクリックします。
表示されたダイアログで、次の値を使用してアプリに名前を付け、プロジェクトの追加オプションを選択し、[次へ] をクリックします。
プロダクト名: ios-app など

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

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

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

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

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

既存の Firebase プロジェクトで Google アナリティクスが有効になっていない場合は、[設定] > [プロジェクト設定] の [統合] タブで 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 Analytics を構成する

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

ターミナルウィンドウを開き、アプリの 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 Analytics では、一部のイベントが自動的にログに記録されます。これらのイベントを受信するためのコードを追加する必要はありません。アプリでそれ以外のデータを収集する必要がある場合は、最大 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 広告にコンバージョンとしてインポートできるようになります。

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

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