Meta only. Forwarded to the ad set's promoted_object (snake-cased). Required for goals whose ad-set optimization_goal points at a specific event/page/app — without it Meta rejects the ad-set create with error_subcode: 1815430 "Please select a promoted object for your ad set": - goal: conversions (OFFSITE_CONVERSIONS) — requires pixelId + customEventType - goal: app_promotion (APP_INSTALLS) — requires applicationId + objectStoreUrl - goal: lead_generation (LEAD_GENERATION) — pageId is auto-filled from the connected Page when omitted Other goals (engagement, traffic, awareness, video_views) ignore this field.
| Name | Type | Description | Notes |
|---|---|---|---|
| pixelId | String | Facebook Pixel ID. Required for `goal: conversions`. | [optional] |
| customEventType | String | Standard event the campaign optimises against, e.g. `PURCHASE`, `LEAD`, `COMPLETE_REGISTRATION`, `ADD_TO_CART`. Uppercased internally so callers can pass any case. Required for `goal: conversions`. | [optional] |
| pageId | String | Facebook Page ID. Used by `goal: lead_generation`. Auto-filled from the connected Page when omitted. | [optional] |
| applicationId | String | App ID. Required for `goal: app_promotion`. | [optional] |
| objectStoreUrl | URI | App Store / Play Store listing URL. Required for `goal: app_promotion`. | [optional] |
| customConversionId | String | Custom Conversion ID, when optimising against one instead of a standard event. | [optional] |
| productCatalogId | String | Catalog ID for catalog/Advantage+ Shopping campaigns. | [optional] |
| productSetId | String | Product Set ID inside the catalog. | [optional] |