Facebook Marketing API – Promoted Object Usage

Create Ad Set “Promoted Object”

The Promoted Object is required for certain campaign objectives.

The below table outlines the required Promoted Object fields based on the Optimization Goal.

Optimization GoalPromoted Object Field
CONVERSIONS* Pixel ID (Conversion pixel ID)
* Pixel ID (Facebook pixel ID) and Custom Event Type
* Pixel ID (Facebook pixel ID), Pixel Rule and Custom Event Type
* Event ID (Facebook event ID) and Custom Event Type
* Application IDObject Store URL, and Custom Event Type for mobile app events
* Offline Conversion Data Set ID (Offline dataset ID) and Custom Event Type for offline conversions
PAGE_LIKES* Page ID
OFFER_CLAIMS* Page ID
LINK_CLICKS* Application ID and Object Store URL for mobile app or Canvas app engagement link clicks
APP_INSTALLS* Application ID and Object Store URL
OFFSITE_CONVERSIONS* Application IDObject Store URL, and Custom Event Type (Standard Events)
PRODUCT_CATALOG_SALES* Product Set ID
* Product Set ID and Custom Event Type
LEAD_GENERATION* Page ID