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 :

Sample Lookup Request 

{"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

FACEBOOK



N

adObjective

Enum



N

adAccountChannelId

String

accountUserId field

from Account Object



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.

Change Type Column



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"]

}'