메인 콘텐츠로 건너뛰기
다음 예시는 App을 설치하고 구성했으며, 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": "Test account for @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
}
funding instrument id를 가져옵니다. 이전 명령에서 가져온 account 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단계: 캠페인 생성

캠페인을 생성하고 해당 캠페인을 자금 수단(funding instrument)에 연결합니다. 캠페인의 시작 시간과 예산을 설정합니다.
  • 필수 필드: 자금 수단(funding instrument), 캠페인 이름, 예산(총액/일 단위), 시작 시간, 광고 계정 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 목표로 라인 아이템 생성

캠페인에 연결된 라인 아이템을 생성합니다.
  • 필수 필드: 캠페인 id (1단계에서 가져온 값), product type, placements, objective, goal, entity status, primary web event tag, catalog id, product set id, creative_source, ads_account_id
  • catalog_id와 product_set_id는 Shopping Manager에서 확인할 수 있습니다.
  • 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

​
Step 4: 게시물 생성

게시물을 생성합니다.
  • 필수 매개변수: Ads 계정 ID, 사용자 ID, 카드 URI(3단계에서 가져온 값), 텍스트, 이름, & dynamic product ad
  • 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단계에서 얻은 값) 및 Tweet 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에서 카드를 보고자 할 경우, UI에서도 확인할 수 있습니다.