跳转到主要内容
以下示例假设你已使用 twurl 完成应用和用户的安装、配置与授权。twurl 是一款类似 cURL 的命令行工具，可顺畅处理 X 的 OAuth 身份验证。twurl 非常适合快速测试和调试 Ads API（以及 REST API）功能。要查看请求与响应的完整报文头，使用 -t 进行调用跟踪，功能大致等同于 cURL 的 -v 选项。 在本示例中，我们将创建一个 Dynamic Product Ads（DPA，动态商品广告）广告系列。 检索账户 id。 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "@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": "已批准",
      "deleted": false
    }
  ],
  "data_type": "账号",
  "total_count": 1,
  "next_cursor": null
}
检索资金工具的 id。
使用上一步获取的账户 id，调用 GET accounts/:account_id/funding_instruments API。 
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
}

​
步骤 1：创建广告系列

创建广告系列并将其关联到资金工具。
为该广告系列设置开始时间和预算。
  • 必填字段：资金工具、广告系列名称、预算（总额/每日）、开始时间，以及 Ads 账户 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

​
步骤 2：创建以 Sales 为目标的 line item

创建与该 campaign 关联的 line item。
  • 必填字段：campaign id（来自步骤 1）、product type、placements、objective、goal、entity status、primary web event tag、catalog id、product set id、creative_source、ads_account_id
  • 可在你的 shopping manager 中找到 catalog_id 和 product_set_id
  • creative_source 应始终为 DYNAMIC_PRODUCT_CREATIVE
  • objective 应始终为 WEBSITE_CLICKS
  • goal 应始终为 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
  • 完成此步骤后，您即可在 X 的 Ads Manager 中查看该广告系列。

​
步骤 3：创建 DPA 卡片

创建一个 DPA 卡片。
  • 必填参数：广告账户 ID 和 URL：
  • URL 必须以 https://twitter.com 开头；如需添加其他 UTM 参数，可按以下示例追加在末尾：
    • https://twitter.com?utm_source=%7B%7Bsite_source%7D%7D
  • 可选：您可以通过指定 creative_type 并使用以下任一取值来选择卡片格式：“CAROUSEL”、“SINGLE”、“COLLECTION”。如果未指定，将默认创建为轮播卡片。
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

​
步骤 4：创建帖子

创建一个帖子。
  • 必填参数：广告账户ID、用户ID、卡片URI（来自步骤 3）、文本、名称和动态产品广告
  • dynamic_product_ad 应始终设置为 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

​
步骤 5：将帖子关联到投放单元

将帖子与投放单元关联。
  • 必填参数：广告账户 id、投放单元 id（来自步骤 2）以及帖子 id（来自步骤 4 的 id_str）
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
如果广告主希望在 UI 中查看该卡片，它也将可用。