このページは 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] をクリックします。
表示されるダイアログで、次の値を使用してアプリに名前を付け、プロジェクトのその他のオプションを選択してから、[Next] をクリックします。
プロダクト名: 例:iOS アプリ

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

Team: 自動的に入力されない場合は、チームを [None] に設定します。
組織名: 組織の名前またはご自身の名前。
バンドル 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] >スキーム >スキームを編集...
左側のメニューから [Run] を選択します。
[Arguments] タブを選択します。
[Arguments Passed On Launch] セクションで -FIRAnalyticsDebugEnabled を追加します。

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

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

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

[テキスト検索]を[コンバージョンとしてマークを付ける] をスイッチを右に切り替えてください。

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

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

Firebase と iOS の設定が完了し、ログに記録されたアクションイベントを使用してアプリキャンペーンを開始できるようになりました。まず Firebase を Google 広告にリンクします。Firebase を Google 広告にリンクすると、アプリキャンペーンでオーディエンスについて理解を深め、アプリキャンペーンの学習効果を高めることができるため、パフォーマンスとコンバージョンの向上につながります。

[プロジェクトの概要] の隣のボタンをクリックして、Firebase 設定に移動します。
[統合] タブで、Google 広告とリンクボタンが表示されます。[リンクして続行] をクリックします。

Google 広告アカウントを選択します。

これで Firebase の部分は完了です。

Google 広告に移動してログインします。

Google 広告にアクセスしてログインし、[ツールと設定][設定] → [測定] → [コンバージョン]: カスタムイベントをコンバージョンとしてインポートします。
[+] ボタンをクリックして、新しいコンバージョンアクションを追加します。

Google アナリティクス 4 プロパティ（Firebase）を選択し、[続行] をクリックします。

コンバージョンとしてマークされたすべてのアナリティクスイベントが表示されます。以前に実装した clicked_counter イベントを探します。

チェックボックスをオンにして、[インポートして続行] ボタンをクリックします。

「text_search」をコンバージョンアクションとして設定したら、text_search イベントを発生させる可能性が高いユーザーをターゲットとするキャンペーンを開始します。

8. イベントをインポートしてアプリアクションキャンペーンを開始する

現在のアカウントの [キャンペーン] タブに移動し、[+] ボタンをクリックして新しいキャンペーンを作成します。新しいキャンペーンをクリックして続行します。
今回は、アプリインストールオプションを設定したアプリプロモーションキャンペーンを開始します。

アプリ名、パッケージ名、パブリッシャーを指定してアプリを検索します。
[単価設定] で、広告のアクションを重視するには、Google 広告のドロップボックスで [アプリ内コンバージョン] を選択します。
表示されるリストにカスタムイベントが表示されます。目標コンバージョン単価を設定し、その他のオプションを入力します。

キャンペーン設定を行う。これは Codelab の対象外です。設定の最適化については、これらのドキュメントを参照するか、他のチャネルを通じてお問い合わせください。

9. 完了

これで Firebase と Google 広告の統合が完了しました。これにより、キャンペーンのパフォーマンスを向上させることができます。

スクリプトのインストール、新しい Codelab 変更リストの作成とステージング、保留中の Codelab 変更リストの更新とステージング、Codelab 変更リストのレビューと承認、Codelab 変更リストの送信と公開を行いました。

学習した内容

iOS 向けに Firebase を構成する方法
iOS と Firebase 向け Google アナリティクスでカスタムイベントをロギングする方法
イベントをインポートしてアクションキャンペーンで使用する方法