Using Facebook SDK with Singular SDK
Comprehensive guide for implementing both Facebook SDK and Singular SDK in same app, covering configuration requirements, data accuracy considerations, and integration best practices.
Integration Overview
Singular as Mobile Measurement Partner
If Singular SDK integrated in app, Facebook SDK not required for tracking Facebook attribution or viewing events in Facebook platform. As certified Mobile Measurement Partner (MMP) of Facebook, Singular SDK handles all attribution and event tracking requirements.
Singular MMP Capabilities:
- Attribution Tracking: Automatically tracks installs and conversions from Facebook campaigns
- Event Forwarding: Sends in-app events to Facebook for campaign optimization
- Data Reporting: Provides unified attribution data across all channels including Facebook
- Certified Integration: Facebook-approved measurement solution with full API access
When to Use Facebook SDK
Valid Use Cases
While Singular SDK handles attribution and analytics, some organizations choose to integrate Facebook SDK for additional Facebook-specific features beyond measurement.
Social Features
Facebook Login
Enable users to authenticate using Facebook credentials, simplifying onboarding and reducing registration friction.
Facebook Share
Allow users to share app content directly to Facebook, increasing organic reach and viral growth potential.
Advanced Advertising Features
Facebook Mobile App Install Ads
Access advanced capabilities of Facebook Mobile App Install Ads including:
- Dynamic Product Ads: Retarget users with personalized product recommendations
- Audience Network: Extend campaigns beyond Facebook platform to partner apps
- Custom Audiences: Create audiences based on Facebook user data
- Advanced Targeting: Leverage Facebook's detailed targeting options
Facebook Platform Integration
Graph API Access
Integrate with Facebook Graph API for reading and writing data to Facebook social graph.
Messenger Integration
Enable communication through Facebook Messenger for customer support or engagement campaigns.
Integration Decision: Only integrate Facebook SDK if your app requires specific Facebook platform features beyond attribution and analytics. For measurement purposes alone, Singular SDK provides complete functionality.
Data Accuracy Considerations
When using both Facebook SDK and Singular SDK in same app, proper configuration essential to maintain data accuracy and prevent discrepancies.
Common Data Issues
Event Duplication
Without proper configuration, events may be sent twice to Facebook (once from Facebook SDK and once from Singular SDK), causing inflated event counts and inaccurate reporting.
Critical Issue: Duplicate event tracking leads to:
- Inflated Event Counts: Facebook reports double actual events, skewing campaign performance metrics
- Incorrect Session Counts: Session data appears artificially high on Facebook platform
- Campaign Optimization Problems: Facebook algorithm receives incorrect signals for campaign optimization
- Budget Allocation Issues: Inaccurate data affects budget distribution across campaigns
Solution Requirements
Configuration Strategy
To maintain data accuracy when using both SDKs, disable automatic event logging in Facebook SDK while allowing Singular SDK to handle all measurement and event forwarding to Facebook.
Integration Architecture:
| Component | Responsibility | Configuration |
|---|---|---|
| Singular SDK |
|
Standard configuration No special changes required |
| Facebook SDK |
|
Disable automatic logging Prevent duplicate event sending |
Implementation Steps
Follow these steps to use Facebook SDK alongside Singular SDK while maintaining data accuracy and preventing event duplication.
Step 1: Disable Facebook SDK Event Logging
Platform-Specific Configuration
By default, Facebook SDK automatically sends events to Facebook platform. This automatic logging must be disabled to prevent duplicate event tracking.
Configuration Method
Follow Facebook's official instructions under "Disable Automatically Logged Events" in Getting Started with App Events for iOS.
Info.plist Configuration
Add following key to your Info.plist file to
disable automatic
event logging:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
Verification Steps
-
Check Info.plist: Verify key added correctly
with
value set to
false - Test Build: Build and run app to ensure configuration applied
- Monitor Events: Verify Facebook SDK not sending events using Facebook Analytics dashboard
Important: After disabling automatic logging, Facebook SDK will not send any events to Facebook. Singular SDK will handle all event forwarding to Facebook platform.
Configuration Method
Follow Facebook's official instructions under "Disable Automatically Logged Events" in Getting Started with App Events for Android.
AndroidManifest.xml Configuration
Add following metadata to your AndroidManifest.xml
file
within <application> tag:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternative: Programmatic Configuration
Alternatively, disable automatic logging programmatically in your Application class:
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)
}
}
Verification Steps
-
Check AndroidManifest: Verify metadata
added correctly
with value set to
false - Build Application: Clean and rebuild app to ensure configuration applied
- Monitor Events: Verify Facebook SDK not sending events using Facebook Analytics dashboard
Important: Choose either AndroidManifest configuration OR programmatic configuration, not both. Manifest configuration recommended for consistency.
Step 2: Configure Facebook Attribution
Singular Partner Configuration
After disabling Facebook SDK event logging, configure Facebook attribution in Singular platform following standard setup procedures.
Setup Instructions: Follow steps 1-4 in Facebook Ads Attribution Integration guide to complete Facebook attribution configuration.
Configuration Checklist:
- Add Facebook App ID: In Singular platform, navigate to Attribution → Partner Configuration and add Facebook App ID
- Configure Attribution Settings: Set attribution windows and measurement preferences
- Map Events: Configure event mapping between Singular and Facebook
- Enable Postbacks: Set up event postbacks from Singular to Facebook for campaign optimization
Step 3: Validate Configuration
Testing Procedures
After completing configuration, validate proper implementation using Singular and Facebook testing tools.
Singular SDK Validation
- Testing Console: Use Singular Testing Console to verify events tracked correctly
- Event Logs: Check Singular Export Logs to confirm events recorded
- Attribution Verification: Verify Facebook installs attributed correctly in Singular reports
Facebook Platform Validation
- Events Manager: Open Facebook Events Manager and verify events appearing from Singular
- Event Count Comparison: Compare event counts between Singular and Facebook to ensure no duplication
- Session Tracking: Verify session counts match expected values without inflation
Data Accuracy Checks
| Check | Expected Result |
|---|---|
| Event Counts | Events appear only once in Facebook (from Singular), not duplicated |
| Session Counts | Facebook shows normal session counts without artificial inflation |
| Attribution Data | Singular reports show Facebook installs with correct campaign data |
| Facebook Features | Facebook Login, Share, and other features work correctly in app |
Validation Timeline: Allow 24-48 hours after initial setup for data to flow correctly through both platforms. Some data may appear delayed initially.
Troubleshooting
Common issues and solutions when using Facebook SDK and Singular SDK together.
Common Issues
Symptoms
- Event counts in Facebook double expected values
- Same event appears multiple times with identical timestamps
- Facebook campaign optimization affected by inflated metrics
Cause
Facebook SDK automatic event logging not disabled, causing both Facebook SDK and Singular SDK to send same events to Facebook platform.
Solution
-
Verify
FacebookAutoLogAppEventsEnabledset tofalsein iOS Info.plist -
Verify
com.facebook.sdk.AutoLogAppEventsEnabledset tofalsein Android AndroidManifest.xml - Clean and rebuild app to ensure configuration applied
- Monitor Facebook Events Manager for 24 hours to confirm issue resolved
Symptoms
- Facebook installs not appearing in Singular reports
- Installs attributed to Organic instead of Facebook campaigns
- Campaign data missing in Singular analytics
Cause
Facebook not configured as attribution partner in Singular platform or Facebook App ID missing/incorrect.
Solution
- Navigate to Singular → Attribution → Partner Configuration and search for Facebook
- Verify Facebook App ID entered correctly
- Confirm Facebook integration enabled and active
- Check attribution window settings match campaign requirements
- Review Facebook Ads Attribution Integration guide for complete setup
Symptoms
- Facebook Login fails or returns errors
- Facebook Share button not functioning
- Facebook SDK features unavailable in app
Cause
Facebook SDK not properly initialized or configured despite automatic event logging being disabled.
Solution
- Verify Facebook SDK initialized correctly in app (disabling automatic logging does not affect SDK initialization)
- Check Facebook App ID and configuration in app settings
- Review Facebook SDK documentation for specific feature requirements
- Test Facebook features independently to isolate integration issues
Note: Disabling automatic event logging affects only event tracking, not Facebook platform features like Login and Share. These features should continue working normally.
Additional Resources
Complete documentation for Facebook and Singular SDK integration.
Documentation Links
Singular Resources
- Getting Started with Singular SDK/S2S - Complete SDK integration guide
- Facebook Ads Attribution Integration - Facebook partner configuration
- Facebook Data Connector - Cost and campaign data aggregation
- Testing Singular SDK Integration - Validation and troubleshooting procedures
Facebook Developer Resources
- Facebook App Events for iOS - iOS SDK configuration and event logging
- Facebook App Events for Android - Android SDK configuration and event logging
- Facebook Mobile App Install Ads - Advanced advertising features and capabilities
Support
Getting Help
For additional assistance with Facebook and Singular SDK integration, contact Singular Support or consult with your Customer Success Manager.