Facebook SDKとSingular SDK/S2Sを同じアプリで使用する

ドキュメント

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 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
  • すべてのアトリビューション・トラッキングを処理
  • アプリ内イベントをトラッキング
  • イベントをFacebookに転送
  • 統合アナリティクスを提供

標準設定

特別な変更は不要

フェイスブックSDK
  • Facebookプラットフォーム機能を提供
  • ログイン、シェアなどが可能
  • イベントを送信しない
  • アトリビューションを追跡しない

自動ロギングを無効にする

イベントの重複送信を防止


実装ステップ

以下の手順に従って、Facebook SDKとSingular SDKを併用し、データの正確性を保ち、イベントの重複を防止してください。

ステップ1:Facebook SDKのイベントログを無効にする

プラットフォーム固有の設定

デフォルトでは、Facebook SDKは自動的にFacebookプラットフォームにイベントを送信します。 イベントの重複トラッキングを防ぐには、この自動ロギングを無効にする必要があります。

iOS - 自動イベントロギングを無効にする
#

設定方法

iOS用App Eventsを始める」の「Disable Automatically Logged Events」にあるFacebookの公式指示に従ってください。


Info.plistの設定

自動イベントロギングを無効にするには、Info.plist ファイルに以下のキーを追加します:

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

検証ステップ

  1. Info.plistを確認します:キーが正しく追加され、値がfalseに設定されていることを確認する。
  2. ビルドのテスト:アプリをビルドして実行し、設定が適用されていることを確認する。
  3. イベントを監視する:Facebook Analyticsダッシュボードを使用して、Facebook SDKがイベントを送信していないことを確認します。

重要:自動ロギングを無効にした後、Facebook SDKはFacebookにイベントを送信しません。Singular SDKがFacebookプラットフォームへのすべてのイベント転送を処理します。

Android - 自動イベントロギングを無効にする
#

設定方法

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>

代替:プログラムによる構成

別の方法として、アプリケーション・クラスでプログラム的に自動ロギングを無効にします:

JAVAKOTLIN
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);
    }
}

検証ステップ

  1. AndroidManifestを確認する:値がfalseに設定され、メタデータが正しく追加されていることを確認する。
  2. アプリケーションをビルドします:アプリをクリーンアップして再構築し、コンフィギュレーションが適用されていることを確認する。
  3. イベントを監視する:Facebook Analyticsダッシュボードを使用して、Facebook SDKがイベントを送信していないことを確認する。

重要:AndroidManifestコンフィギュレーションかプログラム・コンフィギュレーションのどちらかを選択し、両方は選択しないでください。一貫性を保つためにManifest構成を推奨します。


ステップ2: Facebookアトリビューションの構成

単一パートナーの構成

Facebook SDKイベントロギングを無効にした後、標準のセットアップ手順に従ってSingularプラットフォームでFacebookアトリビューションを設定します。

セットアップの手順 Facebook 広告アトリビューション統合ガイドのステップ 1-4 に従って、Facebook アトリビューションの設定を完了します。

設定のチェックリスト

  1. FacebookアプリIDを追加します:Singularプラットフォームで、Attribution → Partner Configurationに移動し、Facebook App IDを追加します。
  2. アトリビューション設定を構成する:アトリビューションウィンドウと測定設定を設定する
  3. イベントをマッピングする:SingularとFacebook間のイベントマッピングを設定する
  4. ポストバックを有効にする:キャンペーンの最適化のためにSingularからFacebookへのイベントのポストバックを設定します。

ステップ3:設定の検証

テスト手順

設定が完了したら、SingularとFacebookのテストツールを使って適切な実装を検証します。

検証チェックリスト
#

Singular SDKの検証

  1. テストコンソール: Singular テスティングコンソールを使って、正しくトラッキングされたイベントを検証する。
  2. イベントログ:Singular Export Logsで記録されたイベントを確認します。
  3. アトリビューションの検証:Singular レポートで Facebook インストールが正しくアトリビューションされたことを確認する

Facebookプラットフォームの検証

  1. イベントマネージャー:Facebook Events Managerを開き、Singularから表示されるイベントを確認する。
  2. イベントカウントの比較:SingularとFacebookのイベントカウントを比較し、重複がないことを確認します。
  3. セッショントラッキング:セッションカウントがインフレなしで期待値と一致することを確認

データの正確性チェック

チェック 期待される結果
イベント数 イベントがFacebookに一度だけ表示される(Singularから)。
セッション数 Facebookは人工的なインフレなしに通常のセッション数を表示
アトリビューションデータ Singularのレポートでは、正しいキャンペーンデータでFacebookのインストールが表示されます。
Facebookの機能 Facebookログイン、シェア、その他の機能がアプリで正しく機能します。

検証タイムライン:両プラットフォームでデータが正しく流れるまで、初期設定から24~48時間かかります。 一部のデータは最初に遅れて表示される場合があります。


トラブルシューティング

Facebook SDKとSingular SDKを一緒に使用する際によくある問題と解決方法です。

よくある問題

Facebookでのイベントの重複
#

症状

  • Facebookのイベントカウントが期待値の2倍になる
  • 同じタイムスタンプで同じイベントが複数回表示される
  • Facebookキャンペーンの最適化に影響する

原因

Facebook SDKの自動イベントロギングが無効になっていないため、Facebook SDKとSingular SDKの両方が同じイベントをFacebookプラットフォームに送信している。


解決策

  1. iOSのInfo.plistでFacebookAutoLogAppEventsEnabledfalse に設定されていることを確認する。
  2. Android AndroidManifest.xmlで、com.facebook.sdk.AutoLogAppEventsEnabledfalse に設定されていることを確認する。
  3. アプリをクリーンアップして再構築し、コンフィギュレーションが適用されていることを確認する
  4. Facebook Events Managerを24時間監視し、問題が解決したことを確認する。
Singular で Facebook Attribution が見つからない
#

症状

  • SingularのレポートにFacebookのインストールが表示されない
  • インストールが Facebook キャンペーンではなくオーガニックに帰属する
  • Singularアナリティクスでキャンペーンデータが見つからない

原因

SingularプラットフォームでFacebookがアトリビューションパートナーとして設定されていない、またはFacebookアプリIDがない/正しくない。


解決方法

  1. Singular → Attribution → Partner Configurationに移動し、Facebookを検索します。
  2. FacebookアプリIDが正しく入力されていることを確認する
  3. Facebook統合が有効でアクティブであることを確認する
  4. アトリビューションウィンドウの設定がキャンペーン要件と一致していることを確認する
  5. Facebook広告のアトリビューション統合ガイドを確認し、完全なセットアップを行う
Facebookの機能が動作しない
#

症状

  • Facebookログインに失敗するか、エラーが返される
  • Facebookの共有ボタンが機能しない
  • アプリでFacebook SDK機能が利用できない

原因

自動イベントロギングが無効になっているにもかかわらず、Facebook SDKが適切に初期化または設定されていない。


解決方法

  1. アプリでFacebook SDKが正しく初期化されていることを確認する(自動ロギングを無効にしてもSDKの初期化には影響しません
  2. アプリの設定でFacebookアプリIDと構成を確認する
  3. 特定の機能要件について、Facebook SDKのドキュメントを確認する
  4. Facebook機能を単独でテストし、統合の問題を切り分けます。

注意:自動イベント・ロギングの無効化は、イベント・トラッキングのみに影響し、ログインや共有のようなFacebookプラットフォーム機能には影響しません。 これらの機能は正常に動作し続けるはずです。


その他のリソース

FacebookとSingular SDKの統合に関する完全なドキュメントです。

ドキュメントリンク

Singularリソース


Facebook開発者向けリソース


サポート

ヘルプ

FacebookとSingular SDKの統合に関するその他のサポートについては、Singularサポートにお問い合わせいただくか、カスタマーサクセスマネージャーにご相談ください。