단계별 가이드

Ads API 접근 권한을 얻는 방법

1. 개발자 계정에 가입합니다.
2. developer App](/fundamentals/developer-apps)을 생성하고 토큰을 안전하게 보관합니다.
3. ads.x.com/help에 접속하여 각 developer App에 대해 Ads API 접근 권한을 요청합니다.

참고: 이미 X Developer Platform에서 개발 중이며 개발자 계정이 있다면 3단계로 건너뛰세요.

1단계: 개발자 계정 가입

X의 API 제품에 요청을 보내려면 먼저 개발자 계정에 가입해야 합니다. Developer Console에서 App과 developer App을 생성하세요. 이를 통해 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 받게 됩니다.

2단계: App의 키와 토큰을 저장하고 안전하게 보관하기

developer App 내에서 API Keys(Consumer Keys라고도 함) 세트를 받게 됩니다. 또한 자신의 X 계정을 대신하여 요청을 보내는 데 사용할 수 있는 Access Tokens 세트와 OAuth 2.0 Bearer Token이 필요한 엔드포인트를 인증하는 데 사용할 수 있는 Bearer Token을 생성할 수 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로, 환경 변수를 만들거나 안전한 비밀번호 관리자를 사용하는 것이 좋습니다.

App ID도 메모해 두시기 바랍니다. App 세부 정보의 URL에서 확인할 수 있습니다. 이는 다음 단계에서 Ads API 접근 권한을 요청할 때 도움이 됩니다.

참고: 키와 토큰은 Developer Console에 한 번만 표시되므로, 생성하는 즉시 비밀번호 관리 시스템에 이러한 자격 증명을 저장하는 것이 중요합니다.

키와 토큰을 분실하거나 잊어버린 경우 재생성해야 하며, 이는 새 키와 토큰을 생성하고 이전 것은 무효화됩니다. 즉, 이전 자격 증명으로 설정한 모든 통합을 업데이트해야 합니다.

인증 모범 사례에 대해 자세히 알아보세요.

3단계: Ads API 접근 권한 신청

이 시점에서 X API에 대한 기본 접근 권한은 있지만 X Ads API 특정 기능에는 접근할 수 없습니다. 다음으로 Ads API 접근 권한을 요청하고 승인을 받아야 합니다. ads.x.com/help에 접속하여 각 developer App에 대해 Ads API 접근 권한 요청을 제출하세요.

접근 등급

신청 과정의 일부로, 필요한 접근 수준을 지정해야 합니다. App 수준 및 Ad Account 수준 권한에 대해 자세히 알아보세요.

Conversion Only

Mobile 및 Web Conversion 엔드포인트에 대한 읽기 및 쓰기 접근 권한.

Standard Access

Analytics, Campaign Management, Creatives, Custom Audiences 및 Conversion 엔드포인트에 대한 읽기 및 쓰기 접근 권한.

참고: 앱이 Ads API 접근 승인을 받은 후, 인증된 Ads API 요청을 적절히 수행하려면 user access tokens를 재생성해야 합니다.

참고: 2023년 7월 이전에 접근을 요청한 Ads API 개발자는 다른 수준의 접근 권한과 권한을 가질 수 있으며, OAuth 토큰이 5개로 제한될 수 있습니다. 기존 애플리케이션의 추가 엔드포인트 접근 또는 토큰 한도 해제에 대해서는 접근 권한 확대 가이드를 참조하세요.

첫 번째 요청 보내기

Ads API에 대한 접근을 테스트하려면 GET accounts 엔드포인트에 요청을 보내세요. 이 엔드포인트는 현재 인증된 사용자가 접근할 수 있는 광고 계정을 반환합니다. 이 요청에서 받은 광고 계정 ID를 이후 API 요청에서 사용하여 특정 광고 계정의 데이터를 읽고 쓰세요. 명령줄에서 Twurl을 사용하면 요청은 다음과 같습니다.

요청 예시

twurl -H ads-api.x.com "/11/accounts"

응답 예시

{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}

다음 단계 …

• 버전 관리 및 계층 구조와 같은 기본 사항에 대한 Ads API 문서를 읽어보세요.
• Ads API 통합에 도움이 되는 다양한 Ads API 도구 및 라이브러리를 확인하세요.
• Ads API 접근 권한 확대 단계를 이해하세요.
• 사용 가능한 지원 리소스에 익숙해지세요.
• X 프로모트 상품에 대한 API 변경, 서비스 문제 및 개선 사항에 대한 실시간 업데이트를 받으려면 @API를 팔로우하세요.