To enable Facebook Login in the Social Login App, you will need to create a Facebook App first.


To create a Facebook App, please follow the steps given below:


1. Using your Facebook credentials, login into Facebook Apps.

2. Applications you have created will be displayed. Click +Add a New App .

3. In Create a New App ID, provide:

  • Display Name: This is the name of your app.
  • In Contact Email, add contact email ID.
  • In Category, from drop down select a category for the app. If your app category is Games, then you will need to also chose a subcategory for your app.
  • Click Create App ID. Refer to Figure: App Category. App details will be displayed. Click Settings. Refer to Figure App Details.

Figure: App Category


4. In Settings, in Basic provide:
  • App Domains : Provide your website URL.
  • Contact Email: Provide email ID.
  • Namespace: Unique string.
  • App Icon: For image you can use Pixlr editor to create the image. Please use transparent image (.png).
  • Privacy Policy URL.
  • Terms of service URL. Refer to Figure: Settings.


Figure: Settings

5. Click Add Platform 

.

6. Click Website icon. Refer to Figure: Website Platform.

Figure: Website Platform


7. In Website, please enter exact URL as mentioned below:
http://shopsocially.com/platform/facebook-login
Refer to Figure: Platform Details.

Figure: Platform Details


8. Click Save Changes.
9. In Settings, click Advanced tab. In Business Manager, from drop down, select ShopSocially. Refer to Figure: Business Manager.

Figure: Business Manager


10. Click Save Changes.


11. Click Roles. Click Test Users, and then click Add. Refer to Figure: Roles.


Figure: Roles


12. Click Create Test Users, and provide information as below:
  • Number of Test Users to Create: Select 1. 
  • Authorize Test Users for This App?: Select Yes. 
  • Enable Ticker?: Select Yes. Refer to Figure: Create Test Users. Create a test user.

Figure: Create Test Users


13. Click Edit to edit the test user. Change password to shopsocially. Click Save. Refer to Figure: Edit Password, and Figure: Change Password.

Figure: Edit Password


Figure: Change Password


14. Click App Review. For "Do you want to make this app and all its live features available to the general public?", click Yes. You will asked for confirmation. Click Confirm. Refer to Figure: App Review.

Figure: App Review


15. Click Start a Submission. Select the check box for user_birthdaypublish_actions, and user_location to include in the submission. Click Add 3 Items. Refer to Figure: New Submission.

Figure: New Submission


16. In Current Submission, click Edit Notes for user_birthday (?). Refer to Figure: Edit Notes.

Figure: Edit Notes


17. In How is your app using user_birthday?, select radio button Other. Enter the below text in the description box:
1. To create personalized user experience:

a) Using the user_birthday information, users are presented with customized messaging or special offers.

b) For example, if the user birthday is coming up in the next 15 days, user may be offered a special discount as a birthday treat.
2. Pushed into the merchant’s CRM, which is used by the merchant for advanced targeting of their campaigns. Example: Based on user_birthday, merchants can run email campaigns offering special discounts. Refer To Figure: User Birthday 1.

Figure: User Birthday 1

 
For What platforms does your app use user_birthday on?, select Web (?).

In Web, insert the below mentioned text:

1. To target ShopSocially campaigns
a) Login into ShopSocially with username - testabc@yopmail.com and password - testabc by visiting the page
b) You can see that the campaign will be visible for users who have birthday within 30 days.
If you have verified the platform listed in the settings of the app using the test facebook account, then you have been redirected to http://shopifylibrarytest.myshopify.com/products/baby-elephant-bouquet. AS the birthday of the test account falls within 30 day window, a campaign shows up which gives 10% off on his birthday.

Else please follow the below steps.
a) Login to Facebook (with below mentioned user having birthday within 30 days)
user name: <Test User Email Address>
password: shopsocially
Social Connect app is shown. Click on the connect button. We will collect the user birthday on his approval.
c) Click on http://shopifylibrarytest.myshopify.com/products/baby-elephant-bouquet. Now since we know his birthday another Campaign for which targeting was set to "user birthday within 30 days" is shown because that user has birthday within 30 days. The campaign gives 10% off on his birthday.
2. Pushed into the merchant’s CRM, which is used by the merchant for advanced targeting of their campaigns
a) Login to Facebook (with below mentioned user having birthday within 30 days)
user name: <Test User Email Address>
password: shopsocially
Social Connect app is shown. Click on the connect button. We will collect the user birthday on his approval.
c) Click on this link http://www.hubspot.com/
d) Login Using below credentials
user name: testapi@hubspot.com
password: HubSpot
f) Search for user <Test User Last Name>
g) On the left hand side click on "Properties"
h) Search for "Birthday" where the date of birth is populated

Replace the Test User Email Address and Test User Last Name with the user details created in step #17
Refer to Figure: User Birthday 2.

Figure: User Birthday 2


Upload Screencast for user_birthday permission. Refer to Figure: User Birthday 3.

  

Figure: User Birthday 3


Please find attached video "ShopSocially User Birthday permission video" at the end of this document which you need to upload.

18. Click Save.

19. In Current Submission, click Edit Notes for publish_actions (?). Select check boxes for the below:

  • My app does not auto-populate the user message field 
  • My app does not use the Facebook Feed Dialog or the Facebook Share Dialog to publish content 
  • The share button has clear Facebook branding 
  • My app does not post to Facebook automatically
Refer to Figure: Publish Actions 1.

Figure: Publish Actions 1


In How is your app using publish_actions?, select radio button Other. Enter the below text in the description box:


  • Enable users to share a product or offer they like on Facebook.
  • ShopSocially app runs in an iFrame with domain www.shopsocially.com on the merchant’s website. The Facebook Connect button therefore appears on the app and not on the ShopSocially website.
  • The user is asked to do a Facebook Connect with a retailer branded Facebook app. User is also given an option to write a comment and share it on Facebook. The publish_action permission is used for this purpose. Refer to Figure: Publish Actions 2.

Figure: Publish Actions 2


For What platforms does your app use publish_actions on?, select Web (?).

 

In Web, insert the below mentioned text:

1. Click on this link http://shopifylibrarytest.myshopify.com/collections/all

2. A pop up as shown in the screenshot will load.

3. Keep the “Share on Facebook” button checked.

4. Click on the “Connect with us” button.

5. Login to Facebook (test user account)

user name: <Test User Email Address>

password: shopsocially

6. Approve the required permission if not approved previously.

7. Open your Facebook timeline and you can see the post.

Replace the Test User Email Address with the user details created in step #17
Refer to Figure: Publish Actions 3.

Figure: Publish Actions 3

Upload Screencast for publish_actions permission: Refer to Figure: Publish Actions 4

Figure: Publish Actions 4


Please find attached video "ShopSocially Publish Action permission video" at the end of this document which you need to upload.
20. Click Save.
21. In Current Submission, click Edit Notes for user_location (?).


In How is your app using user_location?, select radio button Other. Enter the below text in the description box:

1. To create personalized user experience
a) Using the user_location information, users are presented with customized messaging or special offers.
b) For example, if the user's location is in US, he/she may be offered a free delivery or a special discount
2. Pushed into the merchant's CRM which is used by the merchant for advanced targeting of their campaigns based on location
  • Location wise email campaigns 
  • Offer free shipping based on location. Refer to Figure: User Location 1.

Figure: User Location 1


For What platforms does your app use user_location?, select Web (?).

 

In Web, insert the below mentioned text:

1. To target ShopSocially campaigns

a) Login into ShopSocially with username - testabc@yopmail.com and password - testabc by visiting the page https://shopsocially.com/mc/453963a48c572ec562011819951255e2/campaigns/53b3b17f0428800f8cbe2afc/targeting/

b) You can see that the campaign will be visible for users who have Country set to UNITED STATES.

If you have verified the platform listed in the settings of the app using the test facebook account, then you have been redirected to http://shopifylibrarytest.myshopify.com/products/baby-love-bouquet. AS the location of the test user is in United States, a campaign shows up which gives the user 2-day Free Delivery.

Else please follow the below steps.:

a) Login to Facebook with below mentioned test user

user name: <Test User Email Address>

password: shopsocially

Social Connect app is shown. Click on the connect button. We will collect the user location on his approval.

c) Click on http://shopifylibrarytest.myshopify.com/products/baby-love-bouquet. Now since we know the user location another Campaign for which targeting was set to "country equals to United States" is shown offering 2-Day free delivery.

2. Pushed into the merchant's CRM which is used by the merchant for advanced targeting of their campaigns

a) Login to Facebook (with below mentioned user having location in US)

user name: <Test User Email Address>

password: shopsocially

Social Connect app is shown. Click on the connect button. We will collect the user location on his approval.

c) Click on this link http://www.hubspot.com/

d) Login Using below credentials

user name: testapi@hubspot.com

password: HubSpot

f) Search for user <Test User Last Name>

g) On the left hand side click on "Properties"

h) Search for "City" where the user's current city(location) is populated

Replace the Test User Email Address and Test User Lase Name with the user details created in step #17  

Refer to Figure: User Location 2


Figure: User Location 2


Upload Screencast for user_location permission. Refer to Figure: User Location 3

Figure: User Location 3


Please find attached video "ShopSocially User Location permission video" at the end of this document which you need to upload.
22. Click Save.
23. Click Submit for review.
23. Login to the Facebook Test User account. Set birth date to meet the targeting requirement, and current city to Mountain View, California.
24. Login to the below ShopSocially Account:
https://shopsocially.com/merchant_center/settings?mid=53a1806329b6e157f7f987ff
25. Change the Facebook ID, and Secret for the above account. To do this, in Facebook Test Account, in Settings, click Facebook App. Refer to Figure: Facebook Test Account.

Figure: Facebook Test Account


26. Click Save Changes.


 The apps are shown on a Shopify store. The URL is as given below:
http://shopifylibrarytest.myshopify.com