Paid Initiative
Updated
Supported Objectives
Enum | Label |
OUTCOME_AWARENESS | Facebook Awareness |
OUTCOME_ENGAGEMENT | Facebook Engagement |
OUTCOME_LEADS | Facebook Leads |
OUTCOME_SALES | Facebook Sales |
OUTCOME_TRAFFIC | Facebook Traffic |
OUTCOME_APP_PROMOTION | Facebook App Promotion |
MARKETING_MESSAGES | Marketing Messages |
Supported Categories
Enum | Label |
HOUSING | Housing |
CREDIT | Credit |
FINANCIAL_PRODUCTS_SERVICES | Financial Products Services |
EMPLOYMENT | Employment |
ISSUES_ELECTIONS_POLITICS | Issues Election Politics" |
Smart Promotion Type
Enum | Label |
SMART_APP_PROMOTION | Facebook Advantage+ App Campaigns |
AUTOMATED_SHOPPING_ADS | Facebook Advantage+ Shopping Ads |
Pacing Type
Enum | Label |
ACCELERATED | Accelerated |
STANDARD | Standard |
Ad category Countries :
{"dimensionLookups":[{"lookupType":"COUNTRY","query":""}]}
Destination Type
Ad Objective | Supported Destination Types |
OUTCOME_AWARENESS | AWARENESS, WEBSITE |
OUTCOME_TRAFFIC | WEBSITE, ON_POST, ON_PAGE, ON_EVENT, OPEN_MAP, APP_STORE, CLICK_TO_MESSENGER, PHONE_CALL, INSTAGRAM_PROFILE |
OUTCOME_ENGAGEMENT | ON_POST, ON_PAGE, ON_EVENT, ON_VIDEO, ON_REMINDER |
APP_INSTALLS | APP_STORE, CROSS_PIXEL_APP |
LEAD_GENERATION | ON_AD (Instant Form), WEBSITE |
MESSAGES | CLICK_TO_MESSENGER, MESSENGER, WEBSITE_MESSENGER, WHATSAPP, INSTAGRAM_DIRECT |
CONVERSIONS | WEBSITE, APP_STORE, CROSS_PIXEL_APP |
CATALOG_SALES | WEBSITE, INSTAGRAM_DIRECT |
STORE_VISITS | STORE_VISIT, STORE, OPEN_MAP |
LEAD_ADS (Deprecated label) | ON_AD |
Paid Initiative
Field Name | Field Type | Supported Field Value | Description | Change Type | Supported |
id | String | N | |||
name | String | NAME | Y | ||
channelId | String | N | |||
channelType | Enum | N | |||
adObjective | Enum | Enum Mentioned in Supported Objectives | N | ||
adAccountChannelId | String | accountUserId field | N | ||
adAccountId | Long | accountId field From Account Object | N | ||
status | Enum | ACTIVE,PAUSED, DELETED, DRAFT | STATUS | Y | |
startTime | Long | Epoch Start Time | Y | ||
endTime | Long | Epoch End Time | Y | ||
adCategories | List<Enum> | ||||
lifeTimeBudget | Double | Life Time Budget for Paid Initiative | LIFETIME_BUDGET | Y | |
frequency | List<FrequencyRequest> | FREQUENCY_CAPPING | Y | ||
pacingType | Enum | STANDARD, ACCELERATED | Strategy for pacing ad delivery | N | |
adCategoryCountries | List<String> | AD_CATEGORIES | Y | ||
smartPromotionType | Enum | SMART_PROMOTION_TYPE | Y | ||
destinationType | CATALOG | N | |||
productCatalogId | String | When catalog is selected at PI level. Then productCatalogId is mandatory | N | ||
promotedObjectType | Enum | APPLICATION, PRODUCT_CATALOG, | APPLICATION is supported when iosCampoaign is Enabled | N | |
promotedObjectId | String | N | |||
parentPixelChannelId | |||||
url | String | ||||
pixelRule | |||||
customEventType | |||||
deepCustomEventType | |||||
customEventStr | |||||
whatsappPhoneNumber | |||||
whatsappBusinessPhoneNumberId | |||||
objectStoreURLs | |||||
productSetId | |||||
pageId | |||||
appId | |||||
pixelId | |||||
ios14Campaign | Boolean | Is IOS Campaign or not | Default False True : Set promoted Object Type to APPLICATION | N | |
changeTypes | List<String> | This need to be passed when published Paid Initiative is updated. | |||
apiAdSetRequests | List<Object> |
Update
Enpoint : api/paid/create/updateAds
curl --location 'https://qa6-api2-paid.sprinklr.com/api/paid/create/updateAds' \
--header 'Authorization: Bearer IRaQun/ghyyCAnobwt9OV7LYdbWuv/IQQjE0W62TWDoyNGRhNmY4ZC0wZWU5LTM5ZWYtYmI4YS0wZGIxZjA3OTAxZDc=' \
--header 'Key: <tokem>' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: user.env.type=ENTERPRISE; JSESSIONID=8555C732ED6F4BE5F1B1A4294FDF1AED; user.env.type=ENTERPRISE; JSESSIONID=283240E977BD48B82D66797CA85C659E' \
--data '{
"id": "6819802446c0594437f3d62d",
"startTime": 1742458016000,
"adAccountId": 66122206,
"name": "Traffic App - API - Link Names",
"adCategories": [],
"channelType": "FACEBOOK",
"adObjective": "OUTCOME_TRAFFIC",
"status": "PAUSED",
"changeTypes":["NAME"]
}'