Facebook App Configuration Guide for Luminate Online. Facebook App Configuration Guide for Luminate Online

Transcription

1 1

2 TABLE OF CONTENTS Part 1: Before you Begin Understanding Facebook Permissions Prerequisites... 4 Part 2: App Setup Settings App Details... 6 Part 3: App Submission Roles Status & Review Submit App for Approval

3 Part 1: Before you Begin 1.1 Understanding Permissions for Facebook Login In order to utilize social sharing for Facebook with Luminate Online, you will need to set up a Facebook Developer account and app specifically for your organization or your organization s event. This is created as part of the Janrain setup process and must be completed before proceeding with the next steps. After you have completed the steps as laid out in the Janrain setup guide, you will have successfully enabled Facebook Login for your app, which provides you with the following three basic permissions: public_profile user_friends These permissions determine which information people share with your app upon logging in or registering onto your site via Facebook. In addition, you will also have enabled social sharing readiness for Facebook on the Janrain end. It does not, however, enable the ability to allow your users to explicitly publish content (a.k.a. share) from your site to Facebook. This is the next part of the configuration process. In order to obtain social sharing capability, you will need to request an additional permission from Facebook (beyond the three basic permissions mentioned above) called, publish_actions. This permission allows you, the organization, to publish posts to a user s Facebook page on their behalf. Facebook has implemented a process that now requires each organization to submit its app to be reviewed by Facebook before this permission becomes active to the public on your site. The app approval process requires several items including written step-by-step instructions and a screencast of how a user would register for your TeamRaiser event using social login and how a user would use social sharing through your Participant Center. Other items required will be listed under the Prerequisites section below. 3

4 1.2 Prerequisites To make the app submission process more seamless, it is recommended that you have completed the steps below or have the following information readily available before you begin: Update your Participant Center in Luminate Online Create a test TeamRaiser event and assign the updated Participant Center to this event Copy the URL of your test TeamRaiser event greeting page for step 29. This can be obtained on the Publish step of the edit screen of your TeamRaiser event Create a description of how your app and the permissions are going to be used on your site (see step 7 for an example) The URL to your organization s Privacy Policy A translucent logo you wish to use as your app icon. This can be your organization s logo or the event logo (Requirements: JPG, GIF, or PNG file only. The size of the image must be exactly1024 x 1024 pixels) Screencast recording software such as Monosnap or Screencast-O-Matic (recommended) to record the step-by-step process of registering for a test TeamRaiser event via social login and then using the Facebook sharing component within the Participant Center to post a share to Facebook (refer to step 24 for more details). Note: The file format must be of the industry standard.avi or MP4 file type 4

5 Part 2: App Setup 2.1 Settings Reminder: If you haven t completed the initial setup steps as described in the Luminate Online Janrain Setup Guide, please do so first before configuring the steps below. 1. Log into your Facebook Developer Account at 2. Under My Apps, select the app you previously created during the Janrain setup 3. Click Settings from the left navigation bar 5

6 4. Enter a Contact (Tip: Use the same address linked with your Janrain account) 5. Click Save Changes 2.2 App Details 6. Click App Details from the left navigation bar 7. Under the App Info section fill out the Long Description box of how the app and permissions requested are going to be used. Use the following example as a guideline: This app will provide users participating in the AHS's Run for the Cure events with a more seamless, personalized fundraising experience. Social login will allow for faster registration and also provide participants with seamless log in to access their Participant Center to quickly manage their fundraising campaign, send donation appeal and thank you s to their family and friends. Social Sharing will allow the user to share the event, team and personal fundraising pages from within the Participant Center to the user's Facebook feed with the touch of a button. 8. Under the Contact Info section, paste the URL link of your organization s privacy policy under Privacy Policy URL 6

7 9. Under the Icons section, upload your event or organization s logo to the App Icon box (JPG, GIF, or PNG file only. The size of the image must be exactly1024 x 1024 pixels.) 10. Scroll down to the bottom of the page and click Save Changes Part 3: App Submission 3.1 Roles In this section you are creating a Facebook test user account for Facebook to test your app with. 11. Click Roles from the left navigation bar 12. Click on Test Users at the top of the page 13. Click Add 7

8 14. Enable Authorize Test Users for This App? by changing the toggle from No to Yes 15. Under Login Permissions, type publish_actions 16. Click Create Test Users 17. A new test user will appear above the default Open Graph User 18. Keep the name and user ID of the test user handy (for step 33) 8

9 3.2 Status & Review 19. Click Status & Review from the left navigation bar 20. Next to, Do you want to make this app and all its live features available to the general public?, switch the toggle from No to Yes and click Confirm on the confirmation message 21. Next to Current Submission, click Add Items 22. From the Login Permissions listed on the left, check the box for publish_actions 23. Click Add 1 Item 9

10 24. Testing Your Facebook App - Next, you will need to test your Facebook app for both social login and social sharing actions using a test TeamRaiser event. In addition, Facebook requires that you submit a screencast recording that must show the following: How a person starts your app and logs in to Facebook login How a person shares to Facebook from your app How the post looks on the person's Facebook timeline after posting You can accomplish all three items by using your test TeamRaiser event to show how a person starts your app (by pulling up the TeamRaiser greeting page), logs in to Facebook login (by registering for your TeamRaiser event using the preferred social site link), shares to Facebook from your app (via the Participant Center), and how the posting looks on the person s Facebook timeline after posting (by pulling up Facebook and showing the share on the Facebook feed). For the purposes of recording your screencast, all steps should be completed using the Facebook account linked to your Facebook Developer App). If you do not already have screencast recording software such as Camtasia installed, we recommend downloading and using Screencast- O-Matic (free download) to record your screencast Refer to the screenshots below for an example of what your screencast needs to show: From your test TeamRaiser greeting page, click on the Register button 10

11 Click on Log in using one of your preferred sites Select Facebook 11

12 Sign into Facebook with your Facebook Developer account Complete registration 12

13 Log into the Participant Center Click on the Facebook icon 13

14 Share to Facebook* *Please note: Per Facebook rules, you cannot have a pre-populated comment in the Comment box (circled above). If you see pre-filled text, such as View My Page, please refer to this knowledgebase article. Pull up Facebook to show how this share looks like on the Facebook end 14

15 Your finished screencast should look like the following: (Note: this recording is for illustration purposes only and should not be used as part of your Facebook submission) 25. Once you have completed testing and/or recording your screencast, you can proceed with your Facebook app submission. Start by clicking on Edit Notes next to publish_actions 26. Check the boxes for: 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 15

16 27. For the question, How is your app using publish_actions?, select: Lets people post to Facebook using a custom composer 28. For the question, What platforms does your app use publish_actions on?, select: Web (by switching the toggle from Off to On) 29. Under the Web box that appears, provide detailed step-by-step instructions on how the publish_actions permission will be used. These are the same steps you used to do your testing and/or recording. Your instructions should look like the following steps below: a. Go to (Note: this is an example URL. Yours will be different) b. Click on the Register as an Individual button or link Click here to register as an individual" c. Click on "Log in using one of your preferred sites" 16

17 d. Click on the Facebook logo e. Enter the Facebook test user information f. Continue the registration process until you reach the confirmation page g. From the confirmation page, click on Access Your Participant Center h. From the right navigation bar, click on the Facebook icon i. Enter a personal message if desired j. Click Share 30. For the last requirement, upload your video or screencast recording 31. Click Save 17

18 32. Next, click Edit Notes next to App Verification 33. Enter the name or the user ID of the Test User that was created on step 18 followed by Save 18

19 3.3 Submit App for Approval 34. Finally, click on Submit for Review 35. Facebook will notify you by once your App has been approved or rejected. You can also check the status of your submission by clicking on the Status&Review section of your Facebook app page 19