Enabling Facebook Login/Signup for Your App

In addition to allowing customers to register using their email, Shopper App offers the option for customers to log in or sign up using their Facebook or Google accounts, making the registration and login process quicker and easier. This article focuses on how to integrate Facebook Login with your Shopper App. For Google account login, refer to Enabling Google Account Login/Signup for Your App.

The one-click Facebook account login feature, developed by Facebook, is enabled by integrating a Facebook application into your app. You’ll first need to create a Facebook application and add both Android and iOS platforms to it, then return to Shopper App for configuration. Follow the steps carefully. If you encounter any discrepancies or issues, capture screenshots and consult with your Merchant Success manager for further assistance.

Adding iOS and Android Platforms

Go to Meta for Developers and log in with your Facebook account and click the application you've already created to configure the app login. If your previous app has already integrated Facebook login, you may skip these steps if you followed the same process.

Adding the iOS Platform

1. On the left sidebar, go to App settings > Basic. Scroll down the page and click + Add platform.
   
2. In the pop-up dialog, select iOS and click Next.
   
3. Configure the iOS package settings.
   
   
   • Bundle ID: Find it in Apple’s App Store Connect. Go to General > App Information and copy the Bundle ID.
   • iPhone Store ID: Also in App Store Connect, go to General > App Information, copy the Apple ID.
     
   • URL Scheme Suffix: Leave blank.
   • iPad Store ID: Leave blank.
   • Shared Secret:Leave blank.
   • Log in-app events automatically (recommended): Turned on by default.
   • Provide testing instructions: No action required.

Adding the Android Platform

1. On the left sidebar, go to App settings > Basic. Scroll down the page and click + Add platform.
2. In the pop-up dialog, select Android and click Next.
   
3. In the dropdown menu, select Google Play and click Next.
   
4. Configure the Android package settings.
   
   
   • Key hashes: Find it in Google Play Console, go to Setup > App signing. Scroll down to the App signing key certificate section and copy the SHA-1 certificate fingerprint. Then use the online tool to convert it to base64 format, and copy the result.
     
   • Log in-app events automatically (recommended): Turned on by default.
   • Google Play credentials: Turned off by default.
   • Package Names: Find it in Google Play Console. Go to Setup > App signing and scroll down to the Digital Asset Links JSON section, then copy the package name in the code block. If you see an error saying "Error verifying app-ads.txt," please ignore it.
     
   • Class Name: Fill in “com.shopline.appbuilder.DeeplinkActivity”
   • Install Referrer Decryption Key: Automatically generated, no action required.
   • Provide testing instructions: No action required.

Obtaining Facebook App ID and Access Token

In Meta for Developers, click on your app, and navigate to App settings > Advanced to find your Facebook App ID and Access Token. Save them for later use.

Enabling and Configuring Facebook Account Login

Once you’ve added iOS and Android platforms in Meta for Developers, return to your SHOPLINE admin panel to complete Facebook login setup.

1. From your SHOPLINE admin panel, go to Apps > Shopper App.
2. Go to the App Publish tab and click the Edit button in the Application integration section.
   
3. In the Social Login section, turn on the toggle of Facebook Login. If you haven't published your app via Shopper App or in any other way before, the toggle will be unavailable.
   
4. Enter the Facebook App ID and Access Token, then click OK to complete the setup.
   

Special Notes

• If your app is already published and integrated with Facebook Login, avoid modifying the Facebook App ID or Access Token. Any changes will disable Facebook login for the current app version. If changes are necessary, you'll need to submit a new version for review, and customers must update the app to enable Facebook login again.
• Per Apple's requirements, apps that support third-party logins must also support Sign in with Apple. If Facebook Login is enabled, Sign in with Apple will be automatically activated. If you disable Facebook Login without integrating Google Account Login, Sign in with Apple will also be disabled.