Metaアプリイベント

コードレスアプリイベント

コードレスアプリイベントは、v4.34で導入された新機能です。この機能により、イベントマネージャを使ってアプリイベントを追加したり削除したりできます。コードを実装したり新しいバージョンのアプリをリリースしたりする必要がありません。

Android

要件

以下のいずれかが必要です。

Facebook SDK for Androidの最新バージョンをインストールするには AndroidでApp Eventsを使用するためのスタートガイドを、最新バージョンにアップグレードするにはアップグレードガイドをご覧ください。v4.34 - 4.37をインストールしてある場合は、<your_app> | Gradle Scripts | build.gradle (Module: app)を開き、以下をdependencies{}セクションに追加することにより、Marketing Kitを追加してください。

implementation 'com.facebook.android:facebook-marketing:[4,5)'

忘れずにプロジェクトをビルドし直してください。

コードレスアプリイベント機能を実装する

コードレスデバッグイベントをオンにするには、AndroidManifest.xmlに次の行を追加します。

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

アプリイベントを追加する

イベントマネージャにアクセスして、トラッキングしたいアプリイベントを、コードを使わずに追加します。

  1. イベントマネージャで[新しいデータソースを追加]をクリックし、ドロップダウンメニューから[アプリイベント]を選択します。
  2. [コードレス設定ツールを使用する]をクリックしてから、イベントを追加するアプリを選択します。
  3. [設定を開始]をクリックして、プラットフォームを選択します。
  4. コードレスフローに初めてアクセスする場合は、簡潔なチュートリアルが表示されます。チュートリアルを読んだ後、モバイルデバイスでアプリの新しいセッションを開始します。
  5. アプリのバージョンが表示されるまで、スマートフォンを振ります。
  6. アプリイベントを追加する任意の要素をクリックします。アプリ全体のさまざまなページに移動して要素を選択します。
  7. ポップアップメニューで[保存]をクリックします。イベントを追加しない場合は[キャンセル]をクリックします。
  8. すべてのイベントを追加し終わったら、[確認して完了]をクリックします。
  9. [イベントのテスト]をクリックするか、[保存]、[終了]の順にクリックします。

注: イベントマネージャにイベントが表示されるまで最大30分ほどかかる場合があります。

統合を確認する

アプリ広告ヘルパーにアクセスします。

  • アプリを選択して[送信]をクリックします。
  • [開発者ツール]セクションまでスクロールダウンして、[アプリイベントのテスト]をクリックします。
  • アプリがfb_codeless_debugイベントを送信している場合、選択したテストイベントが表の中に表示されます。

注:Facebook SDK v4.35以上でのみ動作します。

iOS

要件

  • Facebook iOSフルSDK v4.34~v7.1.1
  • Facebook iOSコアSDK v4.38~v7.1.1
  • Facebook iOSコアSDK v4.34-4.37~v7.1.1、およびMarketing Kit

制限

iOS SDKの最新バージョンをインストールするにはiOS用App Eventsスタートガイドを、最新バージョンにアップグレードするにはアップグレードガイドをご覧ください。コアSDK v4.34~4.37だけをインストールしてある場合は、以下をPodfileに追加することにより、Marketing Kitを追加してください。

pod 'FBSDKMarketingKit'

必ず、pod update、pod install --repo-updateの順に実行してください。

コードレスアプリイベント機能を実装する

Xcodeでアプリケーションの.plistをコードとして開いてコードレスデバッグイベントのログ記録をオンにし、以下のXMLをプロパティ辞書に追加します。

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

アプリイベントを追加する

iOS 14のApp Store Connect

アプリが収集してFacebookに送信するイベントによっては、App Store Connect質問表でそのようなデータタイプを公開するよう求められる場合があります。アプリのプライバシーポリシーでこの点が反映されていることを確認するのは、開発者の責任です。公開する必要があるデータタイプの詳細については、Apple App Storeでのプライバシーに関する詳細情報の記事をご覧ください。

イベントマネージャにアクセスして、トラッキングしたいアプリイベントを、コードを使わずに追加します。

  1. イベントマネージャで[データソースを追加]をクリックし、ドロップダウンメニューから[アプリイベント]を選択します。
  2. [コードレス設定ツールを使用する]をクリックしてから、イベントを追加するアプリを選択します。
  3. [設定を開始]をクリックして、プラットフォームを選択します。
  4. コードレスフローに初めてアクセスする場合は、簡潔なチュートリアルが表示されます。チュートリアルを読んだ後、モバイルデバイスでアプリの新しいセッションを開始します。
  5. アプリのバージョンが表示されるまで、スマートフォンを振ります。
  6. アプリイベントを追加する任意の要素をクリックします。アプリ全体のさまざまなページに移動して要素を選択します。
  7. ポップアップメニューで[保存]をクリックします。イベントを追加しない場合は[キャンセル]をクリックします。
  8. すべてのイベントを追加し終わったら、[確認して完了]をクリックします。
  9. [イベントのテスト]をクリックするか、[保存]、[終了]の順にクリックします。

注: イベントマネージャにイベントが表示されるまで最大30分ほどかかる場合があります。

統合を確認する

アプリ広告ヘルパーにアクセスします。

  • アプリを選択して[送信]をクリックします。
  • 一番下に移動し、[アプリイベントのテスター]を選択します。
  • アプリがfb_codeless_debugイベントを送信している場合、それらのイベントが表の中に表示されます。

Unity

Facebook Unity SDK v4.34以上が必要です。

Facebook Unity SDKの最新バージョンをインストールには、Facebook Unity SDKスタートガイドをご覧ください。また、Unity iOSまたはUnity Androidのためのプラットフォーム固有の設定方法に従ってください。

コードレスアプリイベントを有効にする

このオプションをオンにするには、Unity EditorでFacebook | Edit Settingsを選択してから、Auto Logging App Eventsを選択します。

アプリイベントを追加する

この時点で、イベントマネージャによりアプリイベントを追加することができます。

  1. Add Data Sourceの下で、App Eventsを選択します。

  2. User our codeless event setup toolをクリックします

  3. イベント追加先のアプリを選択します。

  4. Start Setupをクリックして、プラットフォームを選択します。コードレスフローに初めてアクセスする場合は、簡潔なチュートリアルが表示されます。

  5. チュートリアルを読んだ後、モバイルデバイスでアプリの新しいセッションを開始します。

  6. アプリのバージョンが表示されるまで、モバイルデバイスを振ります。

  7. アプリイベントを追加するアプリの中の任意の要素をクリックします。アプリ全体のさまざまなページに移動して要素を選択します。

  8. Unity Editorで、Saveをクリックしてイベントを追加します。

  9. すべてのイベントを追加し終わったら、Review and Finishをクリックします。

  10. Test EventsまたはSave and Exitをクリックします。

イベントマネージャにイベントが表示されるまで最大30分ほどかかる場合があります。iOSやAndroidなど、ゲームでサポートするプラットフォームごとに、これらの手順を繰り返します。

統合を確認する

アプリ広告ヘルパーにアクセスします。

  • Select an Appの下で、Submitをクリックします。

  • App Events Testerを選択します。

  • アプリがfb_codeless_debugイベントを送信する場合、それらが表の中に表示されます。

よくある質問

一般

1. コードレス機能が正しく統合されたかどうかチェックするには、どうすればいいですか？

テストデバイスでアプリを起動してから数分後、イベントマネージャの中にfb_codeless_debugという名前のイベントが表示されます。

2. コードレス機能をオフにするには、どうすればいいですか？

コードレスアプリイベントのログ記録をオフにするには、コードレスイベント設定ツールを使って、すべてのイベントを削除してください。

Android

1. 次のビルドエラーが表示されたら、どうすればいいですか？
Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.
AndroidManifest.xmlファイルのmanifest要素に以下を追加します。 
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
activity要素に以下を追加します。 
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. 次の警告が表示されたら、どうすればいいですか？
[!] Unable to find a specification for FBSDKMarketingKit
pod update、pod install --repo-updateの順に実行します。