Vai al contenuto principale
Il seguente esempio presuppone che tu abbia installato, configurato e autorizzato la tua app e il tuo utente utilizzando twurl. twurl è uno strumento da riga di comando, simile a cURL, che gestisce in modo fluido l’autenticazione OAuth di X. twurl è un ottimo strumento per testare e eseguire rapidamente il debug delle funzionalità dell’Ads API (e della REST API). Per visualizzare le intestazioni complete della richiesta e della risposta, usa -t per tracciare la chiamata, all’incirca equivalente all’opzione -v di cURL. In questo esempio creeremo una campagna Dynamic Product Ads (DPA). Recupera l’id dell’account. 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "Account di prova per @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
}
Recupera l’id dello strumento di finanziamento.
Esegui la chiamata GET all’endpoint accounts/:account_id/funding_instruments utilizzando l’id dell’account ottenuto nel comando precedente. 
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
}

​
Passaggio 1: Crea una campagna

Crea una campagna e associala allo strumento di finanziamento.
Specifica un’ora di inizio e un budget per la campagna.
  • Campi obbligatori: strumento di finanziamento, nome della campagna, budget (totale/quotidiano), ora di inizio e ID dell’account pubblicitario
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

​
Passaggio 2: Crea un line item con obiettivo Vendite

Crea un line item associato alla campagna.
  • Campi obbligatori: id campagna (dal Passaggio 1), tipo di prodotto, posizionamenti, obiettivo, goal, stato dell’entità, tag evento web primario, id catalogo, id set di prodotti, creative_source, ads_account_id
  • catalog_id e product_set_id sono disponibili nel tuo shopping manager
  • creative_source deve essere sempre DYNAMIC_PRODUCT_CREATIVE
  • objective deve essere sempre WEBSITE_CLICKS
  • goal deve essere 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
  • Dopo questo passaggio, la campagna sarà visibile in Ads Manager di X.

​
Passaggio 3: Crea la card DPA

Crea una card DPA.
  • Parametri richiesti: id dell’account Ads e URL:
  • L’URL deve iniziare con https://twitter.com; eventuali UTM aggiuntivi possono essere aggiunti in seguito, come nell’esempio seguente:
    • https://twitter.com?utm_source=%7B%7Bsite_source%7D%7D
  • In modo facoltativo, puoi scegliere il formato della card specificando creative_type con uno dei seguenti valori: “CAROUSEL”, “SINGLE”, “COLLECTION”. Se non specificato, la card verrà creata come carosello.
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

​
Passaggio 4: Crea Post

Crea un Post.
  • Parametri obbligatori: ID account Ads, ID utente, URI della card (dal Passaggio 3), testo, nome e dynamic product ad
  • dynamic_product_ad deve essere sempre impostato su 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

​
Fase 5: Associare il Post alla line item

Associa il Post alla line item.
  • Parametri richiesti: id dell’account ads, id della line item (dalla Fase 2) e id del tweet (id_str dalla Fase 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 gli inserzionisti desiderano visualizzare la scheda nell’interfaccia utente, sarà disponibile anche lì.