OMG Facebook Timeline for Pages! Some notes on how to use recent updates to the Facebook Platform.

1. WHAT’S NEW ON THE FACEBOOK
PLATFORM, MARCH 2012
Iskandar Najmuddin
21st March 2012
Facebook Developer Garage London
SYNCAPSE | New York | Toronto | London | Portland 1
All materials contained within this presentation are copyright Syncapse Corp. 2012.

2. TIMELINE FOR PAGES
SYNCAPSE | New York | Toronto | London | Portland 2
All materials contained within this presentation are copyright Syncapse Corp. 2012.

3. Timeline for Pages!!!1!one
A big deal for brands, marketers, and others in Facebook.
Timeline includes:
•Cover photo
•Milestones (aka Life Events)
•Direct Messaging with Users
•Featured & Pinned Posts
•Page Apps (aka Tabs)
•Better admin panel
•Activity Log
•LOTS!
SYNCAPSE | New York | Toronto | London | Portland 3
All materials contained within this presentation are copyright Syncapse Corp. 2012.

4. Page Timeline: Attributes & Cover Photo
First you’ll need manage_pages Permission and a Page Access Token
Update: POST /PAGE_ID
Fields
•about
•description
•general_info
•website
•phone
Cover Photo Fields
•cover: A FB Photo ID, 399px min. width
•offset_y: % offset from top
•no_feed_story: set to true to suppress a feed story
SYNCAPSE | New York | Toronto | London | Portland 4
All materials contained within this presentation are copyright Syncapse Corp. 2012.

5. Page Timeline: Attributes API Example
SYNCAPSE | New York | Toronto | London | Portland 5
All materials contained within this presentation are copyright Syncapse Corp. 2012.

6. Page Timeline: Attributes API Example
SYNCAPSE | New York | Toronto | London | Portland 6
All materials contained within this presentation are copyright Syncapse Corp. 2012.

7. Page Timeline: Apps
Now called Page Apps – “Tabs” really doesn’t make sense any more.
•Gone: default landing Tab
• You can still link through to a Page App directly by URL
•New: Tab Image (111x74)
Existing APIs Unchanged
•Reading list of installed Apps
•Adding/removing Apps
•Changing App Position
•Changing App name
SYNCAPSE | New York | Toronto | London | Portland 7
All materials contained within this presentation are copyright Syncapse Corp. 2012.

8. Page Timeline: Apps API Example
Let’s update the Page App Image!
Update: POST /PAGE_ID/tabs/APP_ID
Fields
•custom_image_url
•custom_image: for raw image data
SYNCAPSE | New York | Toronto | London | Portland 8
All materials contained within this presentation are copyright Syncapse Corp. 2012.

9. Page Timeline: Apps API Example
Let’s update the Page App Image!
SYNCAPSE | New York | Toronto | London | Portland 9
All materials contained within this presentation are copyright Syncapse Corp. 2012.

10. Page Timeline: Milestones
Again, you’ll need manage_pages Permission and a Page Access Token
Read: GET /PAGE_ID/milestones
Create: POST /PAGE_ID/milestones
Fields
•title
•description
•start_time
Delete: DELETE /OBJECT_ID
SYNCAPSE | New York | Toronto | London | Portland 10
All materials contained within this presentation are copyright Syncapse Corp. 2012.

11. Page Timeline: Milestone API Example
POST /PAGE_ID/milestones
SYNCAPSE | New York | Toronto | London | Portland 11
All materials contained within this presentation are copyright Syncapse Corp. 2012.

12. Page Timeline: Milestone API Example
Note: Founded is probably a bad example of a custom Milestone title, as FB
treats the ‘start date’ of a page specially!
SYNCAPSE | New York | Toronto | London | Portland 12
All materials contained within this presentation are copyright Syncapse Corp. 2012.

13. Page Timeline: Messages
You’re gonna need manage_pages, read_inbox and Page Access Token.
Pages can only reply to messages, and cannot initiate any contact.
Read: GET /PAGE_ID/conversations
Reply: POST /THREAD_ID/messages
Fields
•message
SYNCAPSE | New York | Toronto | London | Portland 13
All materials contained within this presentation are copyright Syncapse Corp. 2012.

14. Page Timeline: Messages API Example
You’ve got mail
This is thread t_id.154426338013265
•as retrieved from /PAGE_ID/conversations
Let’s reply using the Graph API!
POST /THREAD_ID/messages
SYNCAPSE | New York | Toronto | London | Portland 14
All materials contained within this presentation are copyright Syncapse Corp. 2012.

15. Page Timeline: Messages API Example
And our happy result!
SYNCAPSE | New York | Toronto | London | Portland 15
All materials contained within this presentation are copyright Syncapse Corp. 2012.

16. Page Timeline: Post Visibility
Great for Moderation-type apps!
Change visibility: POST /POST_ID
Fields
•is_hidden: ‘true’ or ‘false’
SYNCAPSE | New York | Toronto | London | Portland 16
All materials contained within this presentation are copyright Syncapse Corp. 2012.

17. Page Timeline: Public Insights
Publically available stats
SYNCAPSE | New York | Toronto | London | Portland 17
All materials contained within this presentation are copyright Syncapse Corp. 2012.

18. Page Timeline: Missing Stuff
Pinning a Post
Featuring a Post
Back-dating content
SYNCAPSE | New York | Toronto | London | Portland 18
All materials contained within this presentation are copyright Syncapse Corp. 2012.

19. OPEN GRAPH STUFF
SYNCAPSE | New York | Toronto | London | Portland 19
All materials contained within this presentation are copyright Syncapse Corp. 2012.

20. Reading Open Graph Actions
Read OG Actions generated by arbitrary apps!
•GET /USER_ID/APP_NAMESPACE:ACTION
•GET /USER_ID/VERTICAL
Permission(s) Required
•user_actions.VERTICAL
• Where VERTICAL is one of music, news, video
•user_actions:APP_NAMESPACE
• Where APP_NAMEPACE is the, er, App namespace
Use the same permissions format for a user’s friends with
•friends_actions
Example Request
•user_actions.video
•user_actions:my_demo_app
SYNCAPSE | New York | Toronto | London | Portland 20
All materials contained within this presentation are copyright Syncapse Corp. 2012.

21. Location Tagging: OG Actions
Add Place ID to an OG Action
https://graph.facebook.com/me/fdgl_demo:chow_down_on?
pizza_slice=http://domain/pineapple-pizza-slice&
place=PLACE_PAGE_ID&
access_token=ACCESS_TOKEN
SYNCAPSE | New York | Toronto | London | Portland 21
All materials contained within this presentation are copyright Syncapse Corp. 2012.

22. Location Tagging: OG Object
Allows Map view in feed and Map Layout Timeline Aggregation.
Add lat/long to OG object metadata:
<meta property="your-og-app:location:latitude" content="37.416382">
<meta property="your-og-app:location:longitude" content="-122.152659">
<meta property="your-og-app:location:altitude" content="42">
You can also add a place field to the normal Graph API when creating a post via POSTing to a
user’s feed.
SYNCAPSE | New York | Toronto | London | Portland 22
All materials contained within this presentation are copyright Syncapse Corp. 2012.

23. ag People in Posts
Add Tags to OG Actions or Feed Stories. This only works with a valid place ID, mind you.
Create Post: POST /me/feed
Fields
•(normal post fields)
•place: valid Page ID of a FB Place. Required.
•tags: Comma-separated list of Facebook IDs
The fields are named the same when creating an OG Action
SYNCAPSE | New York | Toronto | London | Portland 23
All materials contained within this presentation are copyright Syncapse Corp. 2012.

24. ther Location and Tagging Stuff
Search Examples
Get posts by friends near a Place
https://graph.facebook.com/search?type=location&place=233218519879&access_token=_
Get objects near a specific lat/long
https://graph.facebook.com/search?type=location&center=37.76,-122.427&distance=1000
Using locations_post FQL table
SELECT id, tagged_uids FROM location_post WHERE page_id=110506962309835
There’s loads of room for doing cool new stuff with this kind of data!
SYNCAPSE | New York | Toronto | London | Portland 24
All materials contained within this presentation are copyright Syncapse Corp. 2012.

25. UGC Photos with Actions
We can now add UGC images, which display in the Timeline way bigger
and may get more distribution.
Here’s how
•Add a user_generated parameter
•Image must be at least 520px (both dimensions)
https://graph.facebook.com/me/fdgl_demo:chow_down_on?
pizza_slice=http://domain/pineapple-pizza-slice&
place=PLACE_PAGE_ID&
image[0][url]=http://domain/user-photo.jpg&
image[0][user_generated]=true&
access_token=ACCESS_TOKEN
SYNCAPSE | New York | Toronto | London | Portland 25
All materials contained within this presentation are copyright Syncapse Corp. 2012.

26. UGC Photos with Actions: Result
SYNCAPSE | New York | Toronto | London | Portland 26
All materials contained within this presentation are copyright Syncapse Corp. 2012.

27. OTHER BITS
SYNCAPSE | New York | Toronto | London | Portland 27
All materials contained within this presentation are copyright Syncapse Corp. 2012.

28. Games: New Stories in News Feed
When you use the Scores API to manage your users’ scores these stories will be
generated automatically.
See https://developers.facebook.com/docs/score/
•The Score story: Bob User scored 4321 points playing Frooble
•The Passing story: Bob User passed Jane Person’s high score in Frooble
•The High Score story: Bob User got a new high score in Frooble
SYNCAPSE | New York | Toronto | London | Portland 28
All materials contained within this presentation are copyright Syncapse Corp. 2012.

29. Enhanced Auth Dialog rollout
Migration for all users and apps started in early March and is nearing
completion.
Permission change
publish_actions now automatically includes these permissions:
•Post to timeline (as before)
•Tag photos
•Publish photos and videos
SYNCAPSE | New York | Toronto | London | Portland 29
All materials contained within this presentation are copyright Syncapse Corp. 2012.

30. iOS Integration Deep Linking
Feed stories can 'deep link' from the Facebook iOS app directly to native
iOS apps
•or App Store if App not installed.
For mobile web apps, keep doing UA-sniffing and
SYNCAPSE | New York | Toronto | London | Portland
All materials contained within this presentation are copyright Syncapse Corp. 2012.
redirection. 30

31. Policy Updates
Autoplay of media Allowed for tabs
•This means your tab can go crazy if that’s what you really want.
Three revisions were made to the Facebook Platform Policies on Tuesday, March
7, 2012:
2.We removed our policy which prohibited Page Apps from hosting media that played
automatically without a user’s interaction.
3.We revised our Mobile Web App policy to make it clear that Mobile Web Apps running within a
Facebook iOS app may only use iOS approved payment methods and may not reference, use,
or otherwise encourage use of Facebook Credits and other non-iOS payment methods.
4.We included a reminder that, if applicable, developers must be sure to comply with the Video
Privacy Protection Act (VPPA), and obtain any opt-in consent necessary from users so that user
data subject to the VPPA may be shared on Facebook.
From https://developers.facebook.com/blog/post/2012/03/07/platform-updates--operation-developer-love/
Warning: the new Page Cover Photo rules are super strict.
SYNCAPSE | New York | Toronto | London | Portland 31
All materials contained within this presentation are copyright Syncapse Corp. 2012.

32. Other Updates
• Graph API now returns error codes
• Insights now shows nice Mobile referral info
• New FB training courses
• http://www.pluralsight-training.net/microsoft/Courses/TableOfContents?
courseName=fb-platform
• Inline Video in News Feed works
• Set og:video to your video URL
Don’t forget to check the Facebook Developer Roadmap for detailed breakage info!
SYNCAPSE | New York | Toronto | London | Portland 32
All materials contained within this presentation are copyright Syncapse Corp. 2012.

33. The End. Or is it?
Ask me about social media, technology, or e-cigarettes:
•i.najmuddin@syncapse.com
•twitter.com/iskandar
•+44(0)207.096.0146
SYNCAPSE | New York | Toronto | London | Portland 33
All materials contained within this presentation are copyright Syncapse Corp. 2012.