CPA Target for Website Conversion Campaigns


#1

For the new website conversions beta, the Twitter UI allows for a campaign to have a CPA target to optimize towards.

Where do we set this in the Ads API?


#2

Hey @msbukkuri

Can you provide a little more information around the issue? Do you have a specific line item/campaign that you’re inquiring about? If so, please let us know the line_item/campaign id’s. Additionally, any screenshots of the UI would be helpful for us to understand exactly what’s going on here.

Thanks!


#3

@imit8me Sure.

In the Twitter UI, you can set the Cost per Conversion goal for a Website Conversions campaign.

Where do we set this in the API? This is in relation to the account: 90nl9 that is currently participating in the Website Conversions beta.


#4

@imit8me Going a step further and looking at this specific campaign or line item in the API, it doesn’t look like the API returns the cost-per-conversion goal. Can you please advise?

TWURL for Campaign:
twurl -X "GET" -H "ads-api.twitter.com" "/1/accounts/90nl9/campaigns/5oi8e" | python -m json.tool

Results for Campaign:

{
    "data": {
        "account_id": "90nl9",
        "created_at": "2016-08-09T21:45:28Z",
        "currency": "USD",
        "daily_budget_amount_local_micro": 300000000,
        "deleted": false,
        "duration_in_days": null,
        "end_time": "2016-10-01T06:59:00Z",
        "frequency_cap": null,
        "funding_instrument_id": "intq5",
        "id": "5oi8e",
        "name": "2016_HYFN Q3_Twitter_ConversionsBeta_All Placements_Retargeting",
        "paused": false,
        "reasons_not_servable": [],
        "servable": true,
        "standard_delivery": true,
        "start_time": "2016-08-09T22:15:00Z",
        "total_budget_amount_local_micro": 5000000000,
        "updated_at": "2016-08-31T21:52:45Z"
    },
    "data_type": "campaign",
    "request": {
        "params": {
            "account_id": "90nl9",
            "campaign_id": "5oi8e"
        }
    }
}

TWURL for Line Item:
twurl -X "GET" -H "ads-api.twitter.com" "/1/accounts/90nl9/line_items/5x14p" | python -m json.tool

Results for Line Item:

{
    "data": {
        "account_id": "90nl9",
        "advertiser_domain": "farmfreshtoyou.com",
        "advertiser_user_id": 15147117,
        "automatically_select_bid": false,
        "bid_amount_local_micro": 7500000,
        "bid_type": "TARGET",
        "bid_unit": "LINK_CLICK",
        "campaign_id": "5oi8e",
        "categories": [
            "IAB8-12",
            "IAB8-9"
        ],
        "charge_by": "LINK_CLICK",
        "created_at": "2016-08-09T21:45:28Z",
        "creative_source": "MANUAL",
        "currency": "USD",
        "deleted": false,
        "end_time": null,
        "id": "5x14p",
        "include_sentiment": "POSITIVE_ONLY",
        "name": "Untitled",
        "objective": "WEBSITE_CONVERSIONS",
        "optimization": "WEBSITE_CONVERSIONS",
        "paused": false,
        "placements": [
            "PUBLISHER_NETWORK",
            "TWITTER_PROFILE",
            "TWITTER_TIMELINE"
        ],
        "primary_web_event_tag": "l4r7j",
        "product_type": "PROMOTED_TWEETS",
        "start_time": null,
        "total_budget_amount_local_micro": null,
        "tracking_tags": [],
        "updated_at": "2016-08-26T21:48:28Z"
    },
    "data_type": "line_item",
    "request": {
        "params": {
            "account_id": "90nl9",
            "line_item_id": "5x14p"
        }
    }
}

#5

Hey @msbukkuri

Thank you for the clarification. Currently, we do not expose this field via the API, for both the POST and GET endpoints. At the moment the only way to set/retrieve this field is through the UI. We’ll be sure to send out an update in case there’s any changes in the API pertaining to this.

Thanks
Tushar


#6

@msbukkuri: If you haven’t already, please take a look at the Website Conversions Objective announcement. We’ll be adding the target_cpa_local_micro parameter on 2016-10-12. This param will be required for website conversion campaigns. Thanks again for your question!


#7

Thank you - I saw this!