Facebookピクセル

Facebookピクセルは、Facebookが提供するWeb専用分析ツールです。Facebook SDKのv4.34では、アプリ内のweb viewでピクセルイベントを記録できます。FacebookピクセルイベントをFacebook Appイベントに変換することもできます。これを行うには、Hybrid Mobile App Eventsを使用します。

また、Facebook SDKを実装しなくても、Adjust SDKでFacebookピクセルを利用できるようになりました。

サンプルアプリ

• Androidサンプルアプリ

Facebookとの連携

FacebookアプリID

Facebookピクセルの使用を開始するには、次の手順を実行します。

FacebookのAndroid SDKガイドの説明の通り、次の手順を実行してFacebookアプリIDをアプリに追加する必要があります。

1. facebook_app_idという名前で新しい文字列を追加します。値としてFacebookアプリIDを追加します。

2. strings.xmlファイルを開きます。 パスの例：/app/src/main/res/values/strings.xml

3. AndroidManifest.xmlを開きます。

4. uses-permissionエレメントをマニフェストに追加します：

   <uses-permission android:name="android.permission.INTERNET"/>

5. meta-dataエレメントをapplicationエレメント内に追加します：

   <application android:label="@string/app_name" ...>
   ...
   <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
   ...
   </application>

Facebookピクセルの設定

Facebook Pixelの統合方法については、Facebookのガイドに従ってください。Javascriptコードは以下のように記述する必要があります。

<!-- Facebook Pixel Code -->
<script>
   !function(f,b,e,v,n,t,s)
     ...
   fbq('init', {YOUR_PIXEL_ID});
   fbq('track', 'PageView');
</script>
...
<!-- End Facebook Pixel Code -->

次に、Facebookピクセルコードを更新します。手順はHybrid Mobile App Eventsガイドの Update Your Pixel に記載されています。

<script>
   !function(f,b,e,v,n,t,s)
     ...
   fbq('init', {YOUR_PIXEL_ID});
   fbq('set', 'mobileBridge', {YOUR_PIXEL_ID}, {YOUR_FB_APP_ID});
</script>

Adjust SDKの実装

web viewの拡張

Android web viewアプリの連携ガイドに従ってください。Web View bridgeをロードする際に、 augmentHybridWebViewメソッドへの呼び出しを追加します。

AdjustBridge.registerAndGetInstance(getApplication(), webview);

このステップに到達したら、返されたインスタンスをadjustBridgeInstanceのような名前で保存します。これを使用して、Facebookインターフェイスを以下のように登録できます。

adjustBridgeInstance.registerFacebookSDKJSInterface();

イベント名の登録

Adjust web bridge SDKは、Facebook PixelイベントをAdjustイベントに変換します。

この機能を使用するには、Facebookピクセルを特定のAdjustイベントにマッピングする必要があります。デフォルトのAdjustイベントトークンを設定することもできます。デフォルトトークンを使用するには、Adjust SDKを開始して、ピクセルイベントを記録する前にトークンを追加する必要があります。これには、Facebookピクセル設定からコピー&ペーストされたfbq('track', 'PageView');イベントが含まれます。

イベントをマッピングするには、configインスタンスでaddFbPixelMappingメソッドを呼び出します。 Facebookイベント名とAdjustイベントトークンをパラメーターとして使用してください。Adjust SDKを初期化する前にこれを呼び出す必要があります。

adjustConfig.addFbPixelMapping("fb_mobile_search", adjustEventTokenForSearch);
adjustConfig.addFbPixelMapping(
   "fb_mobile_purchase",
   adjustEventTokenForPurchase,
);

Adjust SDKでは、特定のイベントについてデフォルトのイベントトークンが見つからない場合は、警告をログに記録します。

There is not a default event token configured or a mapping found for event named: 'fb_mobile_search'. It won't be tracked as an adjust event.

マッピングを設定していない場合は、デフォルトのAdjustイベントを設定することも可能です。これを行うには、Adjust SDKを初期化する前にadjustConfig.setFbPixelDefaultEventToken(defaultEventToken);を呼び出します。