API ReferenceCommunity DiscussionAnnouncementsSubscribe
API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Enhanced CPC (aka SmartBid)

Bid Strategy > Enhanced CPC

Description

When using this bid strategy, cpc is used as the baseline bid. The actual bid is auto-adjusted to maximize campaign performance at scale.

📘

Details

  • cpc cannot be null.
  • You can adjust the baseline bid by updating cpc.
  • You can set a given site-level bid to "FIXED" using the publisher_bid_modifier field.
  • Works best when Taboola Pixel is installed for your account.

For detailed information, see the Help Center: Setting Your Bid Strategy: Enhanced CPC

Examples

The examples below illustrate how to create or update a campaign to use a bid_strategy of "SMART".

Guidelines for fields

🚧

The following fields are required

🚧

Default for new CPC campaigns

If you create a new campaign with a cpc, but without a bid_strategy, then bid_strategy defaults to "FIXED".

See: Fixed CPC

Example - Create campaign

POST /backstage/api/1.0/<<example_advertiser_id>>/campaigns/ HTTP/1.1
Host: backstage.taboola.com 
Content-Type: application/json
Authorization: Bearer {access_token}

{
   "name": "Enhanced CPC Campaign",
   "branding_text": "branding",
   "cpc": 0.25,
   "spending_limit": 1000,
   "spending_limit_model": "MONTHLY",
   "bid_strategy": "SMART",  
   "marketing_objective": "DRIVE_WEBSITE_TRAFFIC"
}

{
    "id": 1234,
    "advertiser_id": "<<example_advertiser_id>>",
    "name": "Enhanced CPC Campaign",
    "branding_text": "branding",
    "cpc": 0.25,
    "spending_limit": 1000.0,
    "spending_limit_model": "MONTHLY",  
    "bid_strategy": "SMART",  
    "marketing_objective": "DRIVE_WEBSITE_TRAFFIC"
    ...
}

Example - Update campaign

POST /backstage/api/1.0/<<example_advertiser_id>>/campaigns/1235 HTTP/1.1
Host: backstage.taboola.com 
Content-Type: application/json
Authorization: Bearer {access_token}

{
    "bid_strategy": "SMART",
    "cpc": 0.25  
}

{
    "id": 1235,
    "advertiser_id": "<<example_advertiser_id>>",
    "name": "Campaign Update Test",
    "branding_text": "branding",
    "cpc": 0.25,
    "spending_limit": 1000.0,
    "spending_limit_model": "MONTHLY",  
    "bid_strategy": "SMART",  
    "marketing_objective": "DRIVE_WEBSITE_TRAFFIC"
    ...
}