Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • JavaScript
  • PHP
  • More SDKs
  • Best Practices
    • Batch Requests
    • Using ETags
  • Reference
    • Cost Per Action (CPA) Ads
    • Currencies
    • Introduction to Action Spec
    • Introduction to Sponsored Stories
    • Mobile App Install Ads
    • Optimized CPM
    • Real Time Bidded Exchange protocol
    • Sponsored Results
    • Thrift file for Real Time Bidded Exchange protocol
  • Specs
    • Conversion Specs
    • Creative Specs
    • Defining Action Specs
    • Targeting Specs
    • Tracking Specs
  • Advanced Targeting
    • Action Spec Targeting
    • Conversion pixels
    • Custom Audience targeting
    • Topic Targeting
    • ZIP Code Targeting
  • Queries
    • Action Estimate
    • Action Spec Ad Previews
    • Ad Statistics
    • Autocomplete Data
    • Broad Target Categories
    • Connection Objects
    • Conversion Stats
    • Keyword Stats
    • Partner Categories
    • Reach estimate
    • Targeting Description
  • Objects
    • Ad account
    • Ad account group
    • Ad campaign
    • Ad creative
    • Ad group
    • Ad image
    • Ad user

Broad Target Categories

Facebook APIs › Ads › Broad Target Categories

Broad Category Targeting (BCT) is a form of Ad targeting which allows Ad Groups to be targeted by pre-defined broad categories. Before BCT can be used the valid categories can be queried from the API.

Note: BCTs are location and account specific so not all BCTs are available to all users. E.g. Virtual currency BCT is only available to developers integrating Facebook Credits as a Currency and Facebook Credits as a Payment Method.

Query Result Fields

Name Description Permissions Returns
id The id of a broad category that is used for ad targeting spec long
name The name of a broad category string
parent_category The parent category of a broad category string

Query the broad category targets of an ad account

To query the broad category targeting of an Ad account, query the broadtargetingcategories connection of the Ad account object:.

act_AccountID/broadtargetingcategories?access_token=____

Using Broad Category Targets

"Cooking" and "Small Business Owners" are examples of BCT categories. The 'broadtargetigcategories' connection returns them as follows:

{
  "id": 6002714885172, 
  "name": "Cooking", 
  "parent_category": "Activities"
}

{
  "id": 6002714898572, 
  "name": "Small Business Owners", 
  "parent_category": "Business/Technology"
}

To include the cooking category and small business owner category use the following target spec:

{'countries':['US'],
'user_adclusters':[{'id':6002714885172,'name':'Cooking'},
{'id':6002714898572,'name':'Small Business Owners'}]}

You can also exclude BCT's:

{'countries':['US'],
'excluded_user_adclusters':[{'id':6002714885172,'name':'Cooking'},
{'id':6002714898572,'name':'Small Business Owners'}]}

Conjunctive AND targeting:

See the Advanced targeting section of the targeting spec doc.

Updated about a month ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy