Sponsored Results

Sponsored Results provide advertisers with the ability to embed ads in the list of typeahead results. Advertisers can create standard on-site ads (with a 70 character message) that lead to Facebook pages or apps (including custom tabs on their page). Ads can be targeted against Facebook entities, including Pages, Places, Apps, and subscribe-enabled users. Facebook users see the ad when the targeted entity appears in their search results. Ads only show in desktop search results, not on mobile and not on the "more results" page.

Creative Fields

Field	Description	Type	Required
type	The type of the ad. For Sponsored Results, it should be 31	Integer	Y
body	Text to be displayed with the Ad, maximum length allowed is 70 characters	String	Y
object_id	Facebook ID for the App or Page that you are advertising	Long	Y
link_url	URL of a page tab or a link within the application where you want to drive the user, by default we send the user to the object (i.e. the Page or Application)	String	N
url_tags	Additional URL parameters to be appended when the user clicks on the ad. These are supported only on ads driving traffic to Apps. For page tab apps, the only parameter which will be passed to your page tab is the app_data parameter described in the Page Tab documentation.	String	N

Example:

 curl -F 'type=31' \
      -F 'body=test advertisement' \
      -F 'object_id=165945236818676' \
 https://graph.facebook.com/act_71597454/adcreatives?access_token=$ACCESS_TOKEN

Successful call will return a Creative ID:

 {"id":"6007686400989"}

Targeting Fields

Introducing additional target fields for these ads.

Field	Description
targeted_entities	The ID of entities (Pages, Apps etc.) to target against. To read IDs of entities you can use the search API
page_types	Has to be ["typeahead"] for Sponsored Results

Example:

 curl -F 'bid_type=1' \
      -F 'creative={"creative_id": 6007686400989}' \
      -F 'campaign_id=6006258745789' \
      -F 'name=test_typeahead_ad' \
      -F 'max_bid=50' \
      -F 'targeting={ \
           "countries": ["US"],\
           "targeted_entities":[194699337231859, 5281959998],\
           "page_types":["typeahead"]}' \
 https://graph.facebook.com/act_71597454/adgroups?access_token=$ACCESS_TOKEN

This will result in an AdGroup being created:

 {"id":"6007686489389"}

Bidding

Only CPC Bids (Bid Type 1) and absolute version of Optimized CPM (Bid Type 7) are currently supported. For Optimized CPM ads you can specify bids only for Actions (numerical code 55) and Clicks (numerical code 1).

The minimum bid price is $0.01 for targeting the same entity that you are promoting and $0.15 for targeting other entities on Facebook.

Estimated Reach & Suggested Bid

Please use the targeting spec described above with the Reach Estimate. Note that an estimate may not be available if you're targeting entities with very low search activity. In this case you should use the minimim bid of $0.01 or $0.15 listed above.