Pular para o conteúdo principal
O exemplo a seguir pressupõe que você instalou, configurou e autorizou seu app e usuário usando o twurl. O twurl é uma ferramenta de linha de comando, nos moldes do cURL, que lida de forma eficiente com a autenticação OAuth do X. O twurl é uma ótima ferramenta para testar e depurar rapidamente a funcionalidade da Ads API (e da REST API). Para ver todos os cabeçalhos da solicitação e da resposta, use -t para rastrear a chamada, aproximadamente equivalente à opção -v do cURL. Neste exemplo, vamos criar uma campanha de Dynamic Product Ads (DPA). Recupere o id da conta. 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "Conta de teste para @AdsAPI",
      "timezone": "America/Los_Angeles",
      "timezone_switch_at": null,
      "id": "xxxxxx",
      "created_at": "2014-03-09T00:41:49Z",
      "salt": "f9f9d5a5f23075c618da5eb1d1a9df57",
      "updated_at": "2015-01-29T00:41:49Z",
      "approval_status": "ACCEPTED",
      "deleted": false
    }
  ],
  "data_type": "account"
  "total_count": 1,
  "next_cursor": null
}
Recupere o id do instrumento de financiamento.
Chame a API GET accounts/:account_id/funding_instruments usando o id da conta obtido no comando anterior. 
twurl -H ads-api.x.com /12/accounts/xxxxxx/funding_instruments

{
  "data": [
    {
      "cancelled": true,
      "created_at": "2014-03-09T00:41:49Z",
      "credit_limit_local_micro": null,
      "currency": "USD",
      "deleted": false,
      "description": null,
      "end_time": null,
      "funded_amount_local_micro": null,
      "id": "yyyy",
      "type": null,
      "updated_at": "2014-05-29T00:41:49Z"
    }
  ],
  "data_type": "funding_instrument",
  "next_cursor": null,
  "request": {
    "params": {
      "account_id": "xxxxxx"
    }
  },
  "total_count": 1
}

​
Etapa 1: Criar campanha

Crie uma campanha e associe-a ao instrumento de financiamento.
Defina um horário de início e um orçamento para a campanha.
  • Campos obrigatórios: instrumento de financiamento, nome da campanha, orçamento (total/diário), horário de início e id da conta de anúncios
twurl -H ads-api.x.com -d "funding_instrument_id={FUNDING_INSTRUMENT_ID}&name={CAMPAIGN_NAME}&total_budget_amount_local_micro={TOTAL_BUDGET}&daily_budget_amount_local_micro={DAILY_BUDGET}&start_time={START_TIME}" /12/accounts/{ADS_ACCOUNT_ID}/campaigns | jq

​
Etapa 2: Criar item de linha com o objetivo Vendas

Crie um item de linha associado à campanha.
  • Campos obrigatórios: id da campanha (da Etapa 1), tipo de produto, posicionamentos, objetivo, meta, status da entidade, tag principal de evento da web, id do catálogo, id do conjunto de produtos, creative_source, ads_account_id
  • catalog_id e product_set_id podem ser encontrados no seu Gerenciador de Compras
  • creative_source deve ser sempre DYNAMIC_PRODUCT_CREATIVE
  • objective deve ser sempre WEBSITE_CLICKS
  • goal deve ser sempre WEBSITE_CONVERSIONS
twurl -H ads-api.x.com -d "campaign_id={CAMPAIGN_ID}&product_type={product_type}&placements={PLACEMENTS}&objective=WEBSITE_CLICKS&goal=WEBSITE_CONVERSIONS&entity_status={entity_status}&primary_web_event_tag={WEB_EVENT_TAG}&catalog_id={catalog_id}&product_set_id={product_set_id}&creative_source=DYNAMIC_PRODUCT_CREATIVE" /12/accounts/{ADS_ACCOUNT_ID}/line_items | jq
  • Após esta etapa, a campanha ficará disponível para visualização no Ads Manager da X.

​
Etapa 3: Criar cartão DPA

Crie um cartão DPA.
  • Parâmetros obrigatórios: id da conta de anúncios e URL:
  • A URL deve começar com https://twitter.com — qualquer UTM adicional pode ser adicionada depois, como no exemplo abaixo:
    • https://twitter.com?utm_source=%7B%7Bsite_source%7D%7D
  • Opcionalmente, você pode escolher o formato do seu cartão especificando creative_type com um dos seguintes valores: “CAROUSEL”, “SINGLE”, “COLLECTION”. Se não for especificado, seu cartão será criado como um cartão em carrossel.
twurl -X POST -H ads-api.twitter.com -A "Content-Type: application/json" "/12/accounts/{ADS_ACCOUNT_ID}/dynamic_product_cards" -d '{"url": "{URL}", "creative_type": "{CREATIVE_TYPE}"}' | jq

​
Etapa 4: Criar Post

Crie um Post.
  • Parâmetros obrigatórios: ID da conta de anúncios, ID do usuário, URI do card (da Etapa 3), text, name e dynamic product ad
  • dynamic_product_ad deve sempre estar definido como true
twurl -X POST -H "https://ads-api.twitter.com" "/12/accounts/{ADS_ACCOUNT_ID}/tweet?as_user_id={USER_ID}1&card_uri=card%3A%2F%2F{CARD_URI}&text={POST_TEXT}&name={POST_NAME}%201&dynamic_product_ad=true" | jq

​
Etapa 5: Associar o Post ao line item

Associe o Post ao line item.
  • Parâmetros obrigatórios: id da conta de anúncios, id do line item (da Etapa 2) e id do tweet (id_str da Etapa 4)
twurl -X POST -H "https://ads-api.twitter.com" "/12/accounts/{ADS_ACCOUNT_ID}/promoted_tweets?line_item_id={line_item_id}&tweet_ids={tweet_id}" | jq
Se os anunciantes quiserem ver o cartão na interface do usuário, ele também estará disponível.