| postId |
String |
Zernio post ID (provide this or platformPostId) |
[optional] |
| platformPostId |
String |
Platform post ID (alternative to postId) |
[optional] |
| accountId |
String |
Social account ID |
|
| adAccountId |
String |
Platform ad account ID |
|
| name |
String |
|
|
| goal |
GoalEnum |
Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views. |
|
| budget |
BoostPostRequestBudget |
|
|
| currency |
String |
|
[optional] |
| schedule |
BoostPostRequestSchedule |
|
[optional] |
| targeting |
BoostPostRequestTargeting |
|
[optional] |
| bidStrategy |
BidStrategy |
Meta bid strategy applied to the ad set. On TikTok, mapped to `bid_type` / `bid_price` / `deep_bid_type` automatically. |
[optional] |
| bidAmount |
BigDecimal |
Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. Backward-compat: providing `bidAmount` without `bidStrategy` is treated as `LOWEST_COST_WITH_BID_CAP`. |
[optional] |
| roasAverageFloor |
BigDecimal |
Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sent to Meta as `bid_constraints.roas_average_floor` × 10000 (Meta uses fixed-point integers). |
[optional] |
| tracking |
BoostPostRequestTracking |
|
[optional] |
| specialAdCategories |
List<SpecialAdCategoriesEnum> |
Meta only. Required for housing, employment, credit, or political ads. |
[optional] |
| linkUrl |
URI |
TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok Spark Ads have no clickable destination — required for traffic / conversion objectives. Maps to `landing_page_url` on the creative entry of /v2/ad/create/ (TikTok SDK `AdcreateCreatives.landing_page_url`). Ignored on Meta / LinkedIn / Pinterest / X / Google (those infer the destination from the boosted post). |
[optional] |
| callToAction |
String |
TikTok-only. Call-to-action button label on the Spark Ad creative (e.g. `LEARN_MORE`, `SHOP_NOW`, `DOWNLOAD_NOW`, `SIGN_UP`, `WATCH_NOW`). Maps to `call_to_action` on the creative entry of /v2/ad/create/. Pass-through — the platform validates the value. See TikTok's "Enumeration - Call-to-Action" reference for the full list. |
[optional] |
| sparkAuthCode |
String |
TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads — the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/. |
[optional] |
| dsaBeneficiary |
String |
Name of the legal entity benefiting from the ad. Required by Meta when targeting EU users (DSA Article 26). Not enforced at schema level; enforced server-side when targeting intersects EU member states. |
[optional] |
| dsaPayor |
String |
Name of the legal entity paying for the ad. Required by Meta when targeting EU users (DSA Article 26). Note Meta API spelling: dsa_payor (not dsa_payer). |
[optional] |