X Ads API의 이전 버전에 대한 최신 정보는 아래를 참고하세요.
| Version | Path | Introduction Date | Deprecated Date | End of Life Date |
|---|
| 12.0 | /12/ | October 27, 2022 | TBD | TBD |
| 11.0 | /11/ | March 31, 2022 | TBD | TBD |
| 10.0 | /10/ | August 31, 2021 | March 31, 2022 | October 27, 2022 |
| 9.0 | /9/ | March 2, 2021 | August 31, 2021 | March 31, 2022 |
| 8.0 | /8/ | September 8, 2020 | March 2, 2021 | August 31, 2021 |
| 7.0 | /7/ | March 3, 2020 | September 1, 2020 | March 2, 2021 |
| 6.0 | /6/ | August 28, 2019 | March 3, 2020 | September 1, 2020 |
| 5.0 | /5/ | February 28, 2019 | August 28, 2019 | March 3, 2020 |
| 4.0 | /4/ | August 28, 2018 | February 28, 2019 | August 28, 2019 |
| 3.0 | /3/ | February 1, 2018 | August 28, 2018 | February 28, 2019 |
| 2.0 | /2/ | July 10, 2017 | February 1, 2018 | August 1, 2018 |
| 1.0 | /1/ | March 31, 2016 | July 7, 2017 | January 10, 2018 |
| 0.0 | /0/ | February 21, 2013 | N/A | October 31, 2016 |
-
API 요청/응답에서 파라미터 제거
-
파라미터 또는 엔드포인트 이름 변경
-
값 표현 방식 변경 (preview_url → card_uri)
-
엔드포인트 동작 변경(예: 비동기 vs 동기 통계)
-
선택적 또는 필수 파라미터 추가/변경(예: 요청에서 name을 필수 필드로 지정)
사용 중단(Deprecation): 사용 중단된 버전 또는 제품은 더 이상 지원되지 않으며, 이러한 API의 사용 중지는 권장됩니다.
서비스 종료(Sunset): 제품 또는 API가 서비스 종료되면 해당 엔드포인트 집합은 더 이상 API를 통해 접근할 수 없습니다.
이 전략의 주요 원칙은 다음과 같습니다:
-
모든 호환성 파괴 변경 사항은 새 버전에 묶어 배포합니다
-
새 버전이 발표될 때 기존 버전의 사용 중단 기간은 6개월입니다
-
언제든지 API는 두 개 버전의 요청을 동시에 허용하되, 두 버전 중 오래된 버전은 지원하지 않습니다
-
새로운 제품을 더 빠르게 도입할 수 있도록, 버전 관리 주기와는 별도로 지속적으로 출시됩니다
-
모든 API 응답에는 현재 API 버전을 나타내는
x-current-api-version이 포함되며, 사용 중단된 API 엔드포인트를 호출할 때는 x-api-warn 헤더도 함께 포함됩니다.
API에 호환성 파괴 변경이 필요한 근본적인 제품 요구 변경(예: 다중 연령 버킷 타기팅 사용 중단)이 발생하는 경우, 해당 변경을 알리는 90일 사전 공지를 발송하고, 공지 후 최소 90일이 지난 뒤에 해당 호환성 파괴 변경을 배포합니다
2021년 3월 3일 기준으로 X Ads API 버전 9(v9)가 제공됩니다. 이번 릴리스는 기능 간 형평성을 높이고 캠페인 생성을 간소화하며, Cards 및 Mobile App Promotion 엔드포인트에 대한 주요 업데이트를 도입하도록 설계되었습니다.
이전 버전과 동일하게 v9로 마이그레이션할 수 있도록 6개월의 전환 기간이 제공됩니다. 2021년 8월 31일부터 기존 Ads API 버전 8(v8)은 더 이상 제공되지 않습니다. 서비스 중단을 방지하기 위해 모든 개발자께 가능한 한 빠르게 최신 Ads API 버전으로 마이그레이션하실 것을 권장합니다.
참고: 이번 릴리스와 함께 Ads API 버전 7(v7)은 지원 종료되어 더 이상 사용할 수 없습니다.
accounts/:account_id/account_media 엔드포인트는 사용 중단되었습니다.
이전 버전과 마찬가지로 v5로 마이그레이션할 수 있도록 6개월의 전환 기간이 제공됩니다. 2019-08-28부터 Ads API 버전 4는 더 이상 제공되지 않습니다. 서비스 중단을 피하기 위해 모든 파트너가 가능한 한 빨리 최신 API 버전으로 마이그레이션하시기를 권장합니다. Ads API 버전 3은 수명이 종료되어 더 이상 제공되지 않습니다.
활성 상태였던 엔터티 판별
Active Entities 엔드포인트는 광고 엔터티의 애널리틱스 지표가 변경되었는지를 나타냅니다. 애널리틱스 엔드포인트와 함께 사용하도록 설계되었으며, Active Entities는 엔터티 유형과 날짜 범위(최대 90일)를 지정하면 플랫폼이 애널리틱스를 요청해야 하는 엔터티 ID 배열을 반환합니다. 반환된 것 이외의 ID는 이후 애널리틱스 요청에서 조회하지 않아야 합니다.
이 엔드포인트는 다음 엔터티 유형을 지원합니다: CAMPAIGN, FUNDING_INSTRUMENT, LINE_ITEM, MEDIA_CREATIVE, PROMOTED_TWEET.
MEDIA_CREATIVE 통계
Ads API의 애널리틱스 엔드포인트가 이제 Media Creative 엔터티에 대한 지표를 제공합니다. Media Creative는 X Audience Platform에서 인스트림 광고 또는 이미지를 프로모션하는 방식입니다. X Ads UI에서는 “In-stream videos” 및 “Display creatives” 탭에서 Media Creative 지표를 제공합니다. 동기식과 비동기식 애널리틱스 엔드포인트 모두 이제 MEDIA_CREATIVE 엔터티 enum을 지원합니다.
여러 카드 가져오기
카드 URI 값으로 단일 카드를 가져오도록 설계된 엔드포인트의 v3 릴리스를 개선하여 이제 GET accounts/:account_id/cards/all 엔드포인트를 사용해 여러 카드를 가져올 수 있습니다. 이제 각 카드마다 요청을 보내는 대신 한 번의 요청으로 최대 200개의 카드를 가져올 수 있습니다.
유의할 점 두 가지:
- URL 경로는 이제
accounts/:account_id/cards/all입니다. (이전 경로는 더 이상 사용할 수 없습니다.) ID로 카드를 가져오도록 설계된 해당 엔드포인트와의 일관성을 위한 변경입니다.
- 필수 요청 매개변수 이름은 이제 card_uris(복수형)입니다.
검색 유연성 확대
GET accounts/:account_id/targeting_criteria 엔드포인트가 이제 여러 라인 아이템 ID를 지원합니다. 최대 200개의 ID를 받을 수 있는 line_item_ids 매개변수는 필수입니다. 이전에는 단일 라인 아이템만 허용되어 동기화가 어려웠습니다. 이 변경으로 더 많은 타기팅 정보를 더 짧은 시간에 조회할 수 있습니다.
다음 엔드포인트들도 이제 여러 라인 아이템 ID를 지원하지만, 이들에 대해서는 line_item_ids 매개변수가 선택 사항입니다.
임시 캠페인과 라인 아이템 가져오기
임시 캠페인과 라인 아이템을 가져오는 방식이 업데이트되었습니다. 이제 with_draft(boolean) 매개변수를 true로 설정하면 임시 및 비임시 엔터티를 모두 반환합니다. 이는 삭제된 엔터티를 가져오는 방식(예: with_deleted 사용)과 일치합니다. 이전에는 임시 및 비임시 엔터티를 모두 가져오려면 최소 두 번의 요청이 필요했습니다. 이제 한 번의 API 호출로 수행할 수 있습니다.
| v4 | v5 |
| :--- | :--- | :--- |
| draft_only | with_draft | |
Network activation duration 타기팅
Ads API는 Network Activation Duration 타기팅을 추가한 후 응답의 타기팅 유형에 _IN_SEC 접미사가 포함되던 표시 문제를 해결했습니다. Network Activation Duration은 항상 개월 수로 표현되므로 초 단위에 대한 표기는 혼란을 야기했습니다. 이번 수정으로 표현이 일관되어 혼란이 줄어듭니다.
| v4 | v5 |
| :--- | :--- | :--- |
| NETWORK_ACTIVATION_DURATION_IN_SEC | NETWORK_ACTIVATION_DURATION | |
총 개수 및 커서
v5에서는 with_total_count와 cursor가 상호 배타적입니다. 요청에서 둘 다 지정하면 EXCLUSIVE_PARAMETERS 오류 코드가 반환됩니다. v5 이전에는 cursor가 지정된 경우 with_total_count가 무시되었습니다. 이 변경으로 관계가 명확해졌습니다.
Ads API 응답에서 세 가지 필드가 제거됩니다: preview_url, account_id, parent_ids. 이 세 가지에 필요한 엔지니어링 작업은 최소 수준입니다.
- v4에서 카드의 preview_url 응답 매개변수가 항상 null임이 공지되었습니다. 이 마이그레이션의 마지막 단계는 모든 카드 응답에서 preview_url을 제거하는 것입니다.
- 다음 리소스에 대해 account_id 응답 속성이 제거됩니다. 광고 계정 ID는 이미 URL과 request.params에 존재하기 때문입니다. (이 목록에서 자금 조달 수단을 의도적으로 제외한 이유는, 가능한 경우 상위 ID가 응답 객체에 포함되어야 하며, 계정 ID는 자금 조달 수단의 상위 엔터티이기 때문입니다.)
- 계정 미디어
- 앱 이벤트 공급자
- 앱 이벤트 태그
- 캠페인
- 카드
- 라인 아이템
- 홍보 가능 사용자
- 타겟팅 기준
- GET accounts/:account_id/targeting_criteria 요청의 경우, parent_ids 필드는 항상 빈 배열이었기 때문에 더 이상 반환되지 않습니다.
비미디어 앱 카드
v5에서는 비미디어 앱 카드를 더 이상 지원하지 않습니다. 이전에 비미디어 앱 카드를 생성하거나 편집하는 기능이 제거되었습니다. 이제 이 리소스에 대한 남아 있는 엔드포인트가 사용 중단됩니다.
- 참고: 이는 이미지 및 동영상 앱 다운로드 카드에는 영향을 주지 않습니다.
계정 미디어 생성
POST accounts/:account_id/account_media 엔드포인트는 v5에서 더 이상 사용할 수 없습니다. 이 리소스의 다른 엔드포인트는 영향을 받지 않습니다. 변경 이유는 Media Library에 미디어를 추가할 때, 해당 에셋이 자동으로 Account Media 엔터티로 추가되는 경우가 있으며, 이미 존재하는 에셋을 Account Media 리소스에 다시 추가하려고 하면 오류가 발생하기 때문입니다. 이는 다음과 같은 경우에 발생합니다.
- Media Library에 추가된
AMPLIFY_VIDEO 에셋은 PREROLL 크리에이티브 유형으로 자동으로 Account Media 에셋으로 추가됩니다.
- 특정 크기의 이미지를 Media Library에 추가하면 자동으로 Account Media 에셋으로 추가됩니다. 크리에이티브 유형(예:
INTERSTITIAL)은 이미지 크기에 따라 달라집니다. (크기 정보는 Enumerations 페이지를 참조하세요.)
Ads API 버전 4가 오늘(2018년 8월 28일) 출시됩니다.
이번 릴리스에는 더 강력한 오디언스 처리 백엔드를 기반으로 한 새로운 API 인터페이스를 포함해 Audiences 제품의 개선 사항이 담겨 있습니다. 또한 버전 4에는 사용자, 계정, 세금 설정을 관리하기 위한 일련의 엔드포인트가 추가되었습니다. 아울러 accounts/:account_id/videos 엔드포인트는 사용 중단(deprecated)됩니다. 이 릴리스에는 일부 매개변수와 응답 이름의 소폭 변경도 포함되어 있습니다.
버전 3과 마찬가지로 6개월의 전환 기간을 제공합니다. 2019-02-28부터 Ads API 버전 3은 더 이상 제공되지 않습니다. 서비스 중단을 방지하기 위해 가능한 한 빨리 최신 API 버전으로 마이그레이션하시기를 권장합니다. 버전 관리 전략에 대한 자세한 내용은 Versions 페이지를 참조하세요.
Audience API
새로운 Audiences API는 향상된 견고성과 신뢰성을 제공하는 새로운 오디언스 처리 백엔드 위에 구축되었습니다. 이 새로운 엔드포인트는 파트너가 단일 사용자에 대해 여러 사용자 식별자 유형을 제공할 수 있게 하며, 이는 매칭에 추가 신호를 활용할 수 있음을 의미합니다. 새로운 Audience 엔드포인트에 대한 참고 문서는 여기에서 확인할 수 있습니다. 올해 남은 기간 동안 이 제품에 대한 업데이트와 개선 사항을 계속 출시할 예정입니다.
다음 엔드포인트는 중복된 기능으로 인해 v4에서 더 이상 제공되지 않습니다(v3에서는 계속 작동하며, v3가 더 이상 제공되지 않을 때 완전히 중단됩니다):
- TON 업로드:
- GET accounts/:account_id/tailored_audience_changes
- GET accounts/:account_id/tailored_audience_changes/:tailored_audience_change_id
- POST accounts/:account_id/tailored_audience_changes
- PUT accounts/:accounti_d/tailored_audiences/global_opt_out
- 실시간 Audiences:
- POST tailored_audience_memberships
마지막으로, 버전 4에서는 모든 Tailored Audiences 엔드포인트의 요청 및 응답에서 list_type 매개변수가 제거됩니다.
설정 엔드포인트
이제 계정 관리자는 사용자, 계정 및 세금 설정을 구성하고 업데이트할 수 있습니다. 사용자 설정은 특정 광고 계정에 대한 사용자별 연락처 선호를 의미합니다. PUT accounts/:account_id 엔드포인트를 사용하면 광고주는 계정 이름과 업종을 업데이트할 수 있습니다. 마지막으로 세금 설정 엔드포인트를 통해 부가가치세(VAT)가 부과되는 국가의 광고주는 회사명, 주소, VAT ID, 해당 계정이 광고주 소유인지 또는 광고주를 대신해 광고하는 대행사 소유인지 등의 정보를 업데이트할 수 있습니다.
변경됨
Universal Lookalike 이름 변경
POST accounts/:account_id/line_items 및 PUT accounts/:accountit/line_items/:line_item_id 엔드포인트에서 lookalike_expansion 매개변수의 열거형 값(enum)을 업데이트합니다.
| v3 | v4 |
|---|
NARROW | DEFINED |
BALANCED | EXPANDED |
country_code 사용
Ads API의 일관성 개선 작업의 일환으로, 아래 엔드포인트들의 매개변수 이름을 app_country_code에서 country_code로 변경합니다.
이 변경은 해당 매개변수의 동작이나 허용 값에는 영향을 주지 않는 명칭 변경입니다.
preview_url은 항상 null
v3 공지에서 약속한 대로 이제 모든 기존 카드에 card_uri가 있습니다. 이에 따라 preview_url 값은 항상 null입니다.
참고로, card_uri 값을 사용해 카드를 게시물(Post)과 연결하세요. 다음 예시 요청을 참조하십시오.
$ twurl -X POST -H ads-api.x.com “/4/accounts/18ce54d4x5t/tweet?text=Version 4&card_uri=card://958225772740714496”
비디오 엔드포인트
accounts/:account_id/videos 엔드포인트는 v4에서 더 이상 사용할 수 없습니다. 이 엔드포인트는 Media Library 엔드포인트의 도입으로 대체되었습니다. 다음 사용 비교를 참고하세요.
-
v3 비디오 엔드포인트:
twurl -H ads-api.x.com "/3/accounts/18ce54d4x5t/videos"
-
v4 미디어 라이브러리(비디오) 엔드포인트:
twurl -H ads-api.x.com "/4/accounts/18ce54d4x5t/media_library?media_type=VIDEO"
Media Library 엔드포인트는 비디오 엔드포인트와 기능 면에서 완전한 동등성을 갖추었으며, 이미지와 GIF 처리 같은 추가 기능도 지원합니다. 파트너는 모든 미디어 관리를 위해 Media Library만 사용해 주시기 바랍니다.
Tweet 보기의 as_user_id
GET accounts/:account_id/tweet/preview/:tweet_id 엔드포인트에서 제공되던 as_user_id 매개변수는 더 이상 허용되지 않습니다. 미리보기는 항상 Tweet 작성자 기준으로 렌더링됩니다.
Ads API 버전 3은 2018년 2월 1일에 출시되었습니다. Ads API 버전 2는 2018년 8월 1일에 지원이 종료됩니다.
이번 릴리스에는 새로운 Audience Intelligence 제품, Media Library 접근, 개선된 카드 워크플로가 포함됩니다. 또한 PUT accounts/:account_id/targeting_criteria 엔드포인트의 사용 중단을 발표합니다. 마지막으로, 버전 3에는 일부 사소한 매개변수 및 응답 변경과 더 낮은 일괄 처리 크기 한도가 포함됩니다.
버전 2와 마찬가지로 파트너에게 전환 기간으로 6개월을 제공합니다. 2018-08-01에 Ads API v2는 종료됩니다. 모든 파트너와 개발자에게 가능한 한 빨리 v3로 마이그레이션하시길 권장합니다.
Audience Intelligence
Audience Intelligence는 특정 X 오디언스와 가장 관련성이 높은 상위 해시태그, @핸들, 이벤트에 대한 실시간 인사이트를 제공합니다. 예를 들어, 미국에서 남성 18–34를 입력하면 #nintendoswitch, #cardinal, @ricegum이 이 오디언스에서 트렌드임을 확인할 수 있습니다.
Audience Intelligence 엔드포인트는 다음 기능을 제공합니다.
- 입력한 오디언스를 기준으로 상위 관련 해시태그, @핸들, 이벤트를 조회합니다.
- 입력한 오디언스를 기준으로 핵심 인구통계 정보(예: 연령, 성별, 가구 소득)를 조회합니다.
- 키워드를 기준으로 트윗 볼륨 시계열을 조회합니다.
Media Library
Media Library는 광고 계정용 이미지, GIF, 동영상을 관리할 수 있는 기능을 제공합니다. 이러한 미디어 객체는 트윗에서 사용하거나 카드를 생성하는 데 사용할 수 있습니다. 또한 여러 크리에이티브에서 재사용할 수 있어 동일한 에셋을 여러 번 업로드할 필요가 없습니다.
라이브러리의 객체는 media_key로 식별됩니다. 미디어 키는 예를 들어 13_875943225764098048과 같은 형식의 문자열 값입니다. Ads API에서는 모든 미디어에 대해 미디어 키 사용으로 전환하고 있습니다.
개선된 카드 워크플로
모든 카드 엔드포인트가 이제 미디어 키를 지원합니다. 이를 통해 Media Library의 객체를 사용해 카드를 생성하거나 업데이트할 수 있습니다.
또한 카드 세부정보 조회를 위한 두 개의 새로운 엔드포인트를 도입합니다. 이 엔드포인트는 예를 들어 트윗 또는 예약된 트윗에서 사용된 카드를 조회하는 데 사용할 수 있으며, card_uri 또는 id 중 하나를 지정하면 됩니다. 이전에는 불가능했습니다.
이러한 신규 기능 외에도 버전 3에는 다음 변경 사항이 포함됩니다.
신규
변경
- 타깃팅 기준 일괄 처리의 최대 배치 크기가 이제 500입니다.
- card_uri 및 preview_url 응답 속성은 이제 상호 배타적입니다. 카드에 card_uri가 있으면 preview_url은 null입니다. 카드에 card_uri가 없으면 preview_url만 반환됩니다.
- 2018-01-29 이후 생성된 모든 카드는 card_uri를 가집니다.
- 버전 4까지 기존의 모든 카드는 card_uri를 갖게 됩니다.
- 5:2 이미지로 카드를 생성하는 것은 더 이상 불가합니다. 기존 5:2 이미지 기반 카드는 계속 동작하지만, 파트너께는 성능이 더 높은 1.91:1 또는 1:1 종횡비(지원되는 경우)로 전환하실 것을 권장합니다.
삭제
- PUT accounts/:account_id/targeting_criteria 엔드포인트는 더 이상 제공되지 않습니다. 이 엔드포인트의 대체 동작이 광고주에게 혼란을 초래했고, 한 번에 단일 리소스를 업데이트하는 다른 PUT 엔드포인트와도 일관되지 않았기 때문에 이 변경을 결정했습니다. 대신 파트너는 POST batch/accounts/:account_id/targeting_criteria 엔드포인트를 사용해야 하며, 이는 단일 요청에서 타깃팅을 추가 및 제거할 수 있는 기능 등 더 큰 유연성을 제공합니다.
- funding instrument에 대해 paused 응답 속성은 더 이상 반환되지 않습니다. 대신 해당 항목이 일시 중지되었는지 여부를 판단하려면 entity_status 응답 속성을 확인하세요. 또한 paused와 cancelled가 동일한 값을 의미하므로 cancelled 역시 응답에서 더 이상 반환되지 않습니다.
- GET accounts/:account_id/tweet/preview 엔드포인트에서 card_id 매개변수가 제거되었습니다.
- 삭제된 예약 게시물(Scheduled Tweets)은 조회할 수 없으므로 with_deleted 매개변수는 더 이상 지원되지 않습니다.
- 다음 엔드포인트에서 draft_only 매개변수가 제거되었습니다. 이러한 엔터티는 초안 상태가 될 수 없기 때문입니다:
참고
Video Website Cards와 예약 게시물(Scheduled Tweets)은 이제 베타가 아닙니다. 출시 이후 예약 게시물에 적용된 변경 사항은 이 스레드에서 확인하세요. 여기에는 예약 게시물에 대한 HTML 미리보기 생성 기능이 포함됩니다.
Ads API 버전 2는 2017년 7월 10일에 출시되었습니다. Ads API 버전 1은 2018년 1월 10일에 지원이 종료됩니다.
호환성 중단/사용 중단 사항¶
-
total_count는 이제 선택적 응답 속성입니다. with_total_count가 true로 설정된 경우에만 제공됩니다
-
line_items 및 campaigns 요청/응답 객체의 paused와 draft_only 필드는 단일 entity_status 매개변수로 대체됩니다
-
POST accounts/:account_id/tweet 및 GET accounts/:account_id/tweet/preview 엔드포인트에서
status 매개변수명이 text로 변경되었습니다
-
GET targeting_criteria/locations 엔드포인트의
location_type 열거형은 이제 복수형입니다. COUNTRY는 COUNTRIES, REGION은 REGIONS 등으로 변경되었습니다. 단, v2에서는 CITY가 DMAs(Designated Market Areas) 또는 “metros”를 올바르게 반영하기 위해 METROS로 변경됩니다
-
PUT accounts/:account_id/promoted_tweets 엔드포인트의
display_properties가 제거되었습니다. 이 값은 응답에도 더 이상 포함되지 않습니다
-
위 변경에 따라 이제 promoted_tweets 엔터티는 업데이트(PUT)할 수 없습니다
-
GET accounts/:account_id/promoted_tweets 엔드포인트의
line_item_id 매개변수가 제거되었습니다
-
v2 엔드포인트에서는 5:2 Website Card를 더 이상 생성할 수 없습니다
-
data_type 응답 속성은 더 이상 반환되지 않습니다
신규 기능¶
- Cards v2
- 드래프트 캠페인/라인 아이템 생성 및 활성화
- 예약된 트윗
- 비동기 작업 요약
Cards v2¶
- 트윗에 카드를 연결할 때 트윗 텍스트에
preview_url을 추가하는 대신 card_uri 요청 매개변수를 사용해야 합니다
- 카드 생성 단계에서 응답에
card_uri 매개변수가 반환되지 않으면 preview_url을 사용하세요
- 모든 신규 카드 형식은
card_uri 매개변수를 활용하여 API에서 기본적으로 제공됩니다.
신규 카드 형식:¶
드래프트 캠페인¶
드래프트 캠페인은 GET accounts/:account_id/camapaigns 엔드포인트를 통해 조회할 수 있었습니다. v2에서는 이제 API로 드래프트 캠페인을 생성/활성화할 수 있습니다.
| 초안 캠페인 | 초안 라인 아이템 |
|---|
funding_instrument_id | campaign_id |
name | objective |
start_time | product_type |
| placements |
- 초안 라인 아이템 또는 캠페인은
entity_status가 DRAFT에서 PAUSED 또는 ACTIVE로만 전환될 수 있습니다.
- 전체 캠페인(여러 라인 아이템 포함)을 활성화하려면, 해당 캠페인에 속한 각 라인 아이템과 캠페인 자체가 모두
entity_status를 ACTIVE로 설정해야 합니다.
- 캠페인 또는 라인 아이템의
entity_status를 변경하려면 해당 PUT 엔드포인트를 사용하세요.
예약된 트윗¶
-
예약된 트윗은 다음의 새로운 엔드포인트로 구성됩니다.
-
예약된 트윗:
-
캠페인 관리:
-
새로 만든 예약 트윗은 미래의 임의 날짜로 예약할 수 있습니다.
-
현재 예약 트윗 미리보기 기능은 제공되지 않습니다.
-
SCHEDULED 상태의 예약 트윗만 편집/삭제할 수 있습니다.
-
예약된 트윗은
scheduled_at 날짜/시간까지 엔터프라이즈 Firehose 또는 기타 데이터 API로 전파되지 않습니다.
Ads API 버전 1은 2016년 3월 31일에 출시되었으며 2018년 1월 10일에 지원 종료되었습니다.
버전 1의 변경 사항:¶
- 버전 관리 지원
CUSTOM objective는 더 이상 지원하지 않습니다- 배치 엔드포인트가 이제 일반 공급됩니다
- 도달 추정치 변경 사항:
- 보다 정확한 도달 추정을 제공하기 위해 이제 해당 엔드포인트가 예산을 고려합니다. 다음 매개변수가 필수입니다:
- [신규]
campaign_daily_budget_amount_local_micro
currencybidobjective
- 응답 객체가 변경되어 이제 응답 값에 대해 범위를 반환합니다.
infinite_count는 용도를 명확히 하기 위해 infinite_bid_count로 이름이 변경되었습니다count 및 infinite_bid_count 외에도 다음 새로운 데이터 포인트가 반환됩니다:
impressionsengagementsestimated_daily_spend_local_micro
- 맞춤형 오디언스의 데이터 타입 변경
- 모든 응답에서 Tailored Audiences의
data_type이 tailored_audiences에서 tailored_audience로 변경되었습니다.
- 공유 맞춤형 오디언스가 이제 API 전용 베타로 제공됩니다. 공유 맞춤형 오디언스를 사용하면 하나의 오디언스를 여러 광고 계정에서 활용할 수 있습니다. 광고 계정 간 공유하려는 맞춤형 오디언스의 권한을 관리하려면 POST accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions (및 관련) 엔드포인트를 사용하세요.
- 광고주 계정의 성과 analytics 수집 방식이 크게 개선되었습니다:
- 우리의 모범 사례에 맞추어 이제 동기 통계 엔드포인트에서는 최대 7일분의 데이터만 조회할 수 있습니다.
- 지표 수집을 간소화하기 위해
metrics 매개변수를 새로운 metric_groups 매개변수로 대체했습니다. 이제 개발자는 특정 요청에 대해 반환받고자 하는 지표 그룹을 명시적으로 지정하여 요청해야 합니다.
- 특정 엔터티에 부적합한 메트릭 요청은 응답에서 제외되며
null 값으로 표시됩니다. 이러한 메트릭은 분석 비용 한도에 산정되지 않습니다.
- 응답이 대폭 단순화되었으며, 이제 우리 UI에서 지표가 표시되는 방식과 더욱 밀접하게 일치합니다.
- 이전에는 각 게재 위치별로 개별 지표를 노출했습니다(검색의 Promoted Tweets, 타임라인의 Promoted Tweets, 프로필 및 트윗 상세 보기의 Promoted Tweets, X Audience Platform). 이제는 각 위치에 대해 표준화된 지표 세트를 반환하며, 기존의
promoted_tweet_timeline_impressions, promoted_tweet_search_impressions, promoted_tweets_profile_impressions, promoted_tweets_tpn_impressions 대신 요청 시 아래 범주 중 하나에서 단일 지표 impressions로 제공됩니다(이는 모든 지표에 적용됩니다):
ALL_ON_TWITTERPUBLISHER_NETWORK- 요청하면 단일
impressions 지표만 반환되어 UI의 값과 매칭하기가 더 쉬워집니다.
ALL_ON_TWITTER와 PUBLISHER_NETWORK 데이터를 모두 얻으려면 두 번 쿼리해야 하며, 둘은 결합할 수 없습니다.
- 이제 개발자 여러분의 피드백을 반영해 비동기 통계 엔드포인트를 사용할 수 있습니다!
- 즉시 필요하지 않은 데이터나 과거 데이터 수집을 위해 통계를 비동기적으로 요청할 수 있는 새로운 엔드포인트 세트입니다.
- 새로운 단일 엔드포인트로 통계 작업을 큐에 등록합니다. 리소스가 허용하는 범위 내에서 요청한 데이터를 수집합니다.
- 데이터가 준비되었는지 확인하기 위해 작업 상태 엔드포인트를 조회할 수 있습니다.
- 데이터가 준비되면 동기식 엔드포인트의 응답과 동일한 구조의 JSON 응답을 다운로드할 수 있도록 픽업 ID를 제공합니다.
- 단일 작업에서 최대 90일치 데이터와 최대 20개 엔터티를 조회할 수 있습니다.
- v0 지표를 v1 지표로 매핑한 내용을 포함한 analytics v1 마이그레이션 가이드를 확인하세요
- Sandbox 개선 사항 * 이제 Sandbox 환경에서 여러 개의 테스트 광고 계정을 생성할 수 있습니다. * 이제 Sandbox 환경에서 테스트 광고 계정에 여러 결제 수단을 생성할 수 있습니다. 이를 통해 모든 유형의 결제 수단을 테스트할 수 있습니다. 이전에는 테스트용으로 사용할 수 있는 결제 수단이
CREDIT_CARD 하나뿐이었습니다. * 베타 기능을 테스트하고 싶으신가요? 이제 Sandbox 환경에서 계정의 기능을 켜거나 꺼서 테스트 요구 사항에 맞출 수 있습니다.
Ads API 버전 0은 2013년 2월 21일 공식 출시되었으며 2016년 10월 31일까지 지원되었습니다.
버전 0의 모든 애널리틱스 엔드포인트는 사용 중단되었으며, 2016년 10월 31일 이후에는 더 이상 제공되지 않습니다. 해당 엔드포인트들은 버전 1의 3개 애널리틱스 엔드포인트로 대체되었습니다.
도달 범위 추정 엔드포인트는 버전 1에서 동작 방식이 변경되었습니다. 
