Facebook 픽셀

Facebook 픽셀은 Facebook의 웹 전용 애널리틱스 툴입니다. Facebook SDK v4.34부터 앱의 웹뷰에서 픽셀 이벤트를 기록하고 Facebook 픽셀 이벤트를 Facebook 앱 이벤트로 전환할 수 있습니다. 이를 위해 Hybrid Mobile App Events를 사용해야 합니다.

또한, 이제 Facebook SDK와 별도의 연동 없이 Facebook 픽셀을 Adjust SDK와 사용할 수 있습니다.

예시 앱

• Android 예시 앱

Facebook 연동

Facebook 앱 ID

Facebook 픽셀을 사용하려면 다음의 단계를 수행하시기 바랍니다:

Facebook의 Android SDK 가이드에 명시된 바와 같이, Facebook 앱 ID를 앱에 다음과 같이 추가해야 합니다.

1. facebook_app_id 이름의 새 문자열을 추가합니다. Facebook 앱 ID를 값으로 추가합니다.

2. strings.xml 파일을 실행합니다. Path 예시: /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 픽셀 연동에 관한 Facebook의 가이드를 참조하시기 바랍니다. 자바스크립트 코드는 다음과 같아야 합니다:

<!-- 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 픽셀 코드를 업데이트합니다. 이에 관한 설명은 Update Your Pixel 아래의 Hybrid Mobile App Events guide 에서 찾을 수 있습니다.

<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 연동

웹뷰 증강

Android 웹뷰 앱에 대한 연동 가이드를 참조하시기 바랍니다. 웹뷰 브릿지를 로딩할 때 augmentHybridWebView 메서드에 콜을 추가합니다.

AdjustBridge.registerAndGetInstance(getApplication(), webview);

이 단계에서는 반환된 인스턴스를 adjustBridgeInstance와 같이 저장하시기 바랍니다. 이후 이를 사용하여 Facebook 인터페이스를 다음과 같이 등록할 수 있습니다.

adjustBridgeInstance.registerFacebookSDKJSInterface();

이벤트 이름 등록

Adjust 웹 브릿지 SDK는 Facebook 픽셀 이벤트를 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);을 호출합니다.