Singular SDKでFacebook SDKを使用する
Facebook SDKとSingular SDKの両方を同じアプリに実装するための包括的なガイドで、構成要件、データ精度の考慮事項、統合のベストプラクティスを網羅しています。
統合の概要
モバイル計測パートナーとしてのSingular
Singular SDKがアプリに統合されている場合、FacebookプラットフォームでFacebookのアトリビューションや視聴イベントをトラッキングするためにFacebook SDKは必要ありません。Facebookの認定モバイル測定パートナー(MMP)であるSingular SDKは、すべてのアトリビューションとイベントトラッキングの要件を処理します。
Singular MMPの機能
- アトリビューショントラッキングFacebookキャンペーンからのインストールとコンバージョンを自動的にトラッキングします。
- イベント転送:キャンペーン最適化のためにアプリ内イベントをFacebookに送信します。
- データレポート:Facebookを含むすべてのチャネルで統一されたアトリビューションデータを提供します。
- 認定された統合:完全なAPIアクセスを備えたFacebook公認の測定ソリューション
Facebook SDKを使用するタイミング
有効な使用例
Singular SDKはアトリビューションとアナリティクスを処理しますが、測定以外のFacebook固有の機能を追加するためにFacebook SDKを統合することを選択する組織もあります。
ソーシャル機能
Facebookログイン
Facebook認証情報を使ってユーザーを認証できるようにし、オンボーディングを簡素化し、登録時の摩擦を減らします。
Facebookシェア
ユーザーがアプリのコンテンツを直接Facebookで共有できるようにし、オーガニックなリーチとバイラルな成長の可能性を高めます。
高度な広告機能
Facebookモバイルアプリインストール広告
次のようなFacebookモバイルアプリインストール広告の高度な機能にアクセスできます:
- ダイナミック製品広告:パーソナライズされたおすすめ商品でユーザーを再ターゲット
- オーディエンスネットワーク:Facebookプラットフォームだけでなく、パートナーアプリにもキャンペーンを拡張できます。
- カスタムオーディエンス:Facebookのユーザーデータに基づいてオーディエンスを作成
- 高度なターゲティング:Facebookの詳細なターゲティングオプションを活用
Facebookプラットフォームとの統合
グラフAPIアクセス
Facebookソーシャルグラフにデータを読み書きするために、FacebookグラフAPIと統合します。
メッセンジャーとの統合
カスタマーサポートやエンゲージメントキャンペーンでFacebook Messengerを通じたコミュニケーションを可能にします。
統合の決定アトリビューションやアナリティクス以外の特定のFacebookプラットフォーム機能が必要な場合のみ、Facebook SDKを統合してください。測定のみを目的とする場合は、Singular SDKで完全な機能を提供します。
データの正確性に関する考慮事項
同じアプリでFacebook SDKとSingular SDKの両方を使用する場合、データの正確性を維持し、不一致を防ぐために適切な設定が不可欠です。
よくあるデータの問題
イベントの重複
適切なコンフィギュレーションを行わないと、イベントがFacebookに2回送信され(Facebook SDKから1回、Singular SDKから1回)、イベント数が膨れ上がり、不正確なレポートが作成される可能性があります。
重大な問題イベントの重複トラッキングは以下のような問題を引き起こします:
- イベント数の膨張:Facebookが実際のイベントを二重にレポートし、キャンペーンのパフォーマンス指標を歪める。
- 不正確なセッションカウント:Facebookプラットフォーム上でセッションデータが人為的に高く表示される。
- キャンペーン最適化の問題:Facebookアルゴリズムがキャンペーン最適化のために不正なシグナルを受け取る
- 予算配分の問題:不正確なデータがキャンペーン全体の予算配分に影響
ソリューション要件
設定戦略
両方のSDKを使用する際にデータの精度を維持するために、Facebook SDKの自動イベントロギングを無効にし、Singular SDKがすべての測定とFacebookへのイベント転送を処理できるようにします。
統合アーキテクチャ
| コンポーネント | 責任 | 構成 |
|---|---|---|
| Singular SDK |
|
標準設定 特別な変更は不要 |
| フェイスブックSDK |
|
自動ロギングを無効にする イベントの重複送信を防止 |
実装ステップ
以下の手順に従って、Facebook SDKとSingular SDKを併用し、データの正確性を保ち、イベントの重複を防止してください。
ステップ1:Facebook SDKのイベントログを無効にする
プラットフォーム固有の設定
デフォルトでは、Facebook SDKは自動的にFacebookプラットフォームにイベントを送信します。 イベントの重複トラッキングを防ぐには、この自動ロギングを無効にする必要があります。
設定方法
iOS用App Eventsを始める」の「Disable Automatically Logged Events」にあるFacebookの公式指示に従ってください。
Info.plistの設定
自動イベントロギングを無効にするには、Info.plist ファイルに以下のキーを追加します:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
検証ステップ
-
Info.plistを確認します:キーが正しく追加され、値が
falseに設定されていることを確認する。 - ビルドのテスト:アプリをビルドして実行し、設定が適用されていることを確認する。
- イベントを監視する:Facebook Analyticsダッシュボードを使用して、Facebook SDKがイベントを送信していないことを確認します。
重要:自動ロギングを無効にした後、Facebook SDKはFacebookにイベントを送信しません。Singular SDKがFacebookプラットフォームへのすべてのイベント転送を処理します。
設定方法
Getting Started with App Events for Androidの「Disable Automatically Logged Events」にあるFacebookの公式指示に従ってください。
AndroidManifest.xmlの設定
<application> タグ内のAndroidManifest.xmlファイルに以下のメタデータを追加します:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
代替:プログラムによる構成
別の方法として、アプリケーション・クラスでプログラム的に自動ロギングを無効にします:
import com.facebook.FacebookSdk;
import com.facebook.appevents.AppEventsLogger;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false);
}
}
import com.facebook.FacebookSdk
import com.facebook.appevents.AppEventsLogger
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false)
}
}
検証ステップ
-
AndroidManifestを確認する:値が
falseに設定され、メタデータが正しく追加されていることを確認する。 - アプリケーションをビルドします:アプリをクリーンアップして再構築し、コンフィギュレーションが適用されていることを確認する。
- イベントを監視する:Facebook Analyticsダッシュボードを使用して、Facebook SDKがイベントを送信していないことを確認する。
重要:AndroidManifestコンフィギュレーションかプログラム・コンフィギュレーションのどちらかを選択し、両方は選択しないでください。一貫性を保つためにManifest構成を推奨します。
ステップ2: Facebookアトリビューションの構成
単一パートナーの構成
Facebook SDKイベントロギングを無効にした後、標準のセットアップ手順に従ってSingularプラットフォームでFacebookアトリビューションを設定します。
セットアップの手順 Facebook 広告アトリビューション統合ガイドのステップ 1-4 に従って、Facebook アトリビューションの設定を完了します。
設定のチェックリスト
- FacebookアプリIDを追加します:Singularプラットフォームで、Attribution → Partner Configurationに移動し、Facebook App IDを追加します。
- アトリビューション設定を構成する:アトリビューションウィンドウと測定設定を設定する
- イベントをマッピングする:SingularとFacebook間のイベントマッピングを設定する
- ポストバックを有効にする:キャンペーンの最適化のためにSingularからFacebookへのイベントのポストバックを設定します。
ステップ3:設定の検証
テスト手順
設定が完了したら、SingularとFacebookのテストツールを使って適切な実装を検証します。
Singular SDKの検証
- テストコンソール: Singular テスティングコンソールを使って、正しくトラッキングされたイベントを検証する。
- イベントログ:Singular Export Logsで記録されたイベントを確認します。
- アトリビューションの検証:Singular レポートで Facebook インストールが正しくアトリビューションされたことを確認する
Facebookプラットフォームの検証
- イベントマネージャー:Facebook Events Managerを開き、Singularから表示されるイベントを確認する。
- イベントカウントの比較:SingularとFacebookのイベントカウントを比較し、重複がないことを確認します。
- セッショントラッキング:セッションカウントがインフレなしで期待値と一致することを確認
データの正確性チェック
| チェック | 期待される結果 |
|---|---|
| イベント数 | イベントがFacebookに一度だけ表示される(Singularから)。 |
| セッション数 | Facebookは人工的なインフレなしに通常のセッション数を表示 |
| アトリビューションデータ | Singularのレポートでは、正しいキャンペーンデータでFacebookのインストールが表示されます。 |
| Facebookの機能 | Facebookログイン、シェア、その他の機能がアプリで正しく機能します。 |
検証タイムライン:両プラットフォームでデータが正しく流れるまで、初期設定から24~48時間かかります。 一部のデータは最初に遅れて表示される場合があります。
トラブルシューティング
Facebook SDKとSingular SDKを一緒に使用する際によくある問題と解決方法です。
よくある問題
症状
- Facebookのイベントカウントが期待値の2倍になる
- 同じタイムスタンプで同じイベントが複数回表示される
- Facebookキャンペーンの最適化に影響する
原因
Facebook SDKの自動イベントロギングが無効になっていないため、Facebook SDKとSingular SDKの両方が同じイベントをFacebookプラットフォームに送信している。
解決策
-
iOSのInfo.plistで
FacebookAutoLogAppEventsEnabledがfalseに設定されていることを確認する。 -
Android AndroidManifest.xmlで、
com.facebook.sdk.AutoLogAppEventsEnabledがfalseに設定されていることを確認する。 - アプリをクリーンアップして再構築し、コンフィギュレーションが適用されていることを確認する
- Facebook Events Managerを24時間監視し、問題が解決したことを確認する。
症状
- SingularのレポートにFacebookのインストールが表示されない
- インストールが Facebook キャンペーンではなくオーガニックに帰属する
- Singularアナリティクスでキャンペーンデータが見つからない
原因
SingularプラットフォームでFacebookがアトリビューションパートナーとして設定されていない、またはFacebookアプリIDがない/正しくない。
解決方法
- Singular → Attribution → Partner Configurationに移動し、Facebookを検索します。
- FacebookアプリIDが正しく入力されていることを確認する
- Facebook統合が有効でアクティブであることを確認する
- アトリビューションウィンドウの設定がキャンペーン要件と一致していることを確認する
- Facebook広告のアトリビューション統合ガイドを確認し、完全なセットアップを行う
症状
- Facebookログインに失敗するか、エラーが返される
- Facebookの共有ボタンが機能しない
- アプリでFacebook SDK機能が利用できない
原因
自動イベントロギングが無効になっているにもかかわらず、Facebook SDKが適切に初期化または設定されていない。
解決方法
- アプリでFacebook SDKが正しく初期化されていることを確認する(自動ロギングを無効にしてもSDKの初期化には影響しません
- アプリの設定でFacebookアプリIDと構成を確認する
- 特定の機能要件について、Facebook SDKのドキュメントを確認する
- Facebook機能を単独でテストし、統合の問題を切り分けます。
注意:自動イベント・ロギングの無効化は、イベント・トラッキングのみに影響し、ログインや共有のようなFacebookプラットフォーム機能には影響しません。 これらの機能は正常に動作し続けるはずです。
その他のリソース
FacebookとSingular SDKの統合に関する完全なドキュメントです。
ドキュメントリンク
Singularリソース
- Singular SDK/S2Sを始める- SDKインテグレーションガイド
- Facebook Ads Attribution Integration- Facebookパートナーの設定
- Facebook Data Connector- コストとキャンペーンデータの集約
- Singular SDK統合のテスト- 検証とトラブルシューティングの手順
Facebook開発者向けリソース
- iOS向けFacebookアプリイベント- iOS SDKの設定とイベントロギング
- Android向けFacebookアプリイベント- Android SDKの設定とイベントロギング
- Facebookモバイルアプリインストール広告- 高度な広告機能と機能
サポート
ヘルプ
FacebookとSingular SDKの統合に関するその他のサポートについては、Singularサポートにお問い合わせいただくか、カスタマーサクセスマネージャーにご相談ください。