Zum Hauptinhalt springen
Das folgende Beispiel setzt voraus, dass Sie Ihre App und Ihren Nutzer mit twurl installiert, konfiguriert und autorisiert haben. twurl ist ein Befehlszeilentool nach dem Vorbild von cURL, das die X-OAuth-Authentifizierung zuverlässig übernimmt. twurl eignet sich hervorragend, um Funktionen der Ads API (und der REST API) schnell zu testen und zu debuggen. Um die vollständigen Header der Anfrage und Antwort anzuzeigen, verwenden Sie -t, um den Aufruf nachzuverfolgen; das entspricht in etwa der Option -v von cURL. In diesem Beispiel erstellen wir eine Kampagne für Dynamic Product Ads (DPA). Rufen Sie die Konto-id ab. 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "Testkonto für @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
}
Rufen Sie die id des Finanzierungsinstruments ab.
Senden Sie eine GET-Anfrage an die API accounts/:account_id/funding_instruments unter Verwendung der beim vorherigen Befehl abgerufenen Konto-id. 
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
}

​
Schritt 1: Kampagne erstellen

Erstellen Sie eine Kampagne und verknüpfen Sie sie mit dem Funding Instrument.
Geben Sie eine Startzeit und ein Budget für die Kampagne an.
  • Erforderliche Felder: Funding Instrument, Kampagnenname, Budget (gesamt/täglich), Startzeit und Ads-Konto-id
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

​
Schritt 2: Line Item mit Sales-Ziel erstellen

Erstellen Sie ein Line Item, das der Kampagne zugeordnet ist.
  • Erforderliche Felder: Kampagnen-id (aus Schritt 1), Produkttyp, Platzierungen, Objective, Goal, Entitätsstatus, primäres Web-Event-Tag, Katalog-id, Produktset-id, creative_source, ads_account_id
  • catalog_id und product_set_id finden Sie in Ihrem Shopping-Manager
  • creative_source sollte immer DYNAMIC_PRODUCT_CREATIVE sein
  • objective sollte immer WEBSITE_CLICKS sein
  • goal sollte immer WEBSITE_CONVERSIONS sein
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
  • Nach diesem Schritt ist die Kampagne im Ads Manager von X sichtbar.

​
Schritt 3: DPA-Karte erstellen

Erstellen Sie eine DPA-Karte.
  • Erforderliche Parameter: Ads-Konto-id und URL:
  • Die URL muss mit https://twitter.com beginnen – zusätzliche UTM-Parameter können anschließend wie im folgenden Beispiel angehängt werden:
    • https://twitter.com?utm_source=%7B%7Bsite_source%7D%7D
  • Optional können Sie das Format Ihrer Karte festlegen, indem Sie creative_type mit einem der folgenden Werte angeben: “CAROUSEL”, “SINGLE”, “COLLECTION”. Wenn nicht angegeben, wird Ihre Karte als Karussellkarte erstellt.
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

​
Schritt 4: Post erstellen

Erstellen Sie einen Post.
  • Erforderliche Parameter: Ads-Konto-id, Benutzer-id, Card-URI (aus Schritt 3), Text, Name und Dynamic Product Ad
  • dynamic_product_ad sollte immer auf true gesetzt werden
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

​
Schritt 5: Post einem Line Item zuordnen

Ordnen Sie den Post dem Line Item zu.
  • Erforderliche Parameter: Ads-Konto-id, Line-Item-id (aus Schritt 2) und Tweet-id (id_str aus Schritt 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
Wenn Werbetreibende die Karte in der Benutzeroberfläche sehen möchten, wird sie ebenfalls verfügbar sein.