walmart

Goal → campaign → ad group → ad item → keywords, registered as Autron's in the same request

The campaign is created paused; with state=enabled it is enabled as the last step, once the whole tree exists and only if the item's goal is still on. It starts tomorrow (Walmart refuses a start date that is not in the future), so an enabled campaign reads "Scheduled" in Ad Center until then. A complete tree always answers 201: if the enable did not land, retry it with PUT .../campaigns/<campaign_id>/state, never by building again (every build makes a new campaign).

post/walmart/advertisers/{public_id}/campaigns

Request

  • Base URL: https://api.autron.ai
  • URL: https://api.autron.ai/walmart/advertisers/{public_id}/campaigns
  • Auth: API key in header Authorization

Request body

item_idstring required

Walmart item ID; a live goal must already be set for it

targeting_typestring

auto (default) | manual

daily_budgetnumber

greater than zero; when absent, the goal's daily budget (strategy maximum_daily_budget; a 400 when it can't be used), else 50

statestring

paused (default) | enabled: enabled needs the item's goal on, and enables the campaign once the whole tree exists

Response

Campaign, ad group, ad item (and keywords) created and recorded as Autron's. With state=enabled, state says whether the enable landed (enabled, paused or unknown) and state_message why not.

campaign_idinteger

Walmart campaign id

namestring

Autron | <item_id> | auto, or Autron | <item_id> | manual | <keyword> (the first keyword, cut to fit 255 characters); a label, not what makes it Autron's

statestring

enabled | paused | unknown: what Walmart most likely shows now (unknown: it may have been enabled without confirming, and the safety pause failed; check Ad Center)

requested_statestring

the state the request asked for: paused | enabled

state_messagestring

why state differs from requested_state: Walmart's text, the safety-pause sentence, or that the goal was switched off during the build; or, when the enable landed but recording it failed, what Autron could not record; or, when the goal went off while the enable was in flight, what Autron did about it. Null when the change simply landed, or the build stayed paused as asked

targeting_typestring

auto | manual

registry_public_idstring

public_id of the walmart_campaign row recorded for it

ad_group_idinteger
ad_item_idinteger
keyword_idsinteger[]

empty for auto

daily_budgetnumber

the campaign's daily budget, in dollars

daily_budget_sourcestring

request | goal | default

Changes

No recorded changes to this operation across all 1 revision of this API.