시작하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서는 애드센스 관리 API를 사용하여 애드센스 계정에 대한 정보를 얻으려는 개발자를 대상으로 합니다. 이 문서에서는 사용자가 웹 프로그래밍 개념 및 웹 데이터 형식에 익숙하다고 가정합니다.
시작하기 전에
애드센스 계정 만들기
시작하려면 애드센스 계정에 가입하거나 로그인하세요.
애드센스 익히기
애드센스 소개 자료를 읽고 애드센스의 개념이 익숙하지 않다면 코딩을 시작하기 전에 애드센스 UI를 둘러봅니다.
클라이언트 라이브러리 선택
클라이언트 라이브러리 및 샘플 페이지에서 사용 가능한 라이브러리와 샘플에 대한 정보를 확인할 수 있습니다. 선택한 언어의 탭을 클릭하고 링크를 따라 이동하여 소스를 다운로드합니다.
클라이언트 라이브러리는 다음을 자동으로 처리합니다.
- authentication
- 서비스 발견
- API에 대한 요청 빌드하기
- 응답 파싱
안내를 읽고 선택한 클라이언트 라이브러리를 설치하고 구성합니다. 일반적으로 저장소의 루트 디렉터리에 있는 README 파일에서 찾을 수 있습니다.
구현 시 특별한 요구사항이 있는 경우(예: 지원되지 않는 언어 사용) 클라이언트 라이브러리를 사용하는 대신 API에 직접 요청할 수 있습니다.
애플리케이션 등록
애드센스 관리 API를 사용하려면 프로젝트를 만들고 클라이언트 ID를 생성하여
개발 중인 애플리케이션을 등록해야 합니다.
앱 등록
방금 만든 새 사용자 인증 정보로 클라이언트 라이브러리 프로젝트의 구성 파일을 수정합니다. 자세한 내용은 클라이언트 라이브러리 문서를 참조하세요.
참고: 등록에 사용하는 Google 계정은 개발자 계정이어야 합니다. 즉, 애플리케이션 사용자에게 애플리케이션의 개발자로 표시할 계정이어야 합니다. 사용자가 애플리케이션을 사용하는 동안 자신의 계정에 액세스 권한을 부여하게 되므로 이 계정을 애드센스 로그인 정보와 연결할 필요가 없습니다.
빠른 시작 튜토리얼
아래 단계에 따라 첫 번째 요청을 만듭니다. 이 단계는 사용 중인 라이브러리나 언어에 따라 약간 다를 수 있습니다.
- 적절한 샘플을 사용하여 애드센스 계정에서 광고 클라이언트 목록을
가져옵니다. 이 요청을 실행하면 애드센스 사용자가 프로젝트를 인증하고 승인하는 일회성 프로세스가 시작됩니다.
광고 클라이언트는 애드센스 계정과 애드센스 제품(예: 콘텐츠 광고 또는 검색 광고) 간의 연결을 나타냅니다.
애드센스 계정 하나에 하나 이상의 광고 클라이언트를 사용할 수 있습니다.
- 웹 애플리케이션의 경우 사용자는 액세스 권한을 부여하도록 선택할 수 있는 사이트로 리디렉션됩니다. 승인되면 Google API 콘솔에서 정의된 콜백 URL로 리디렉션됩니다.
- 설치된 애플리케이션도 이와 유사하게 작동합니다. 클라이언트 라이브러리는 브라우저 창을 열고 승인 코드를 사용하려고 시도합니다. Android, Chrome, iOS 애플리케이션의 경우 이 방법은 플랫폼별로 다릅니다.
reports.generate용 Google API 탐색기를 사용하여 다음 보고서를 요청합니다.
date_range: YESTERDAYdimensions: DATEmetrics: ESTIMATED_EARNINGS
보고서를 통해 수입 내역 및 이러한 수입에 영향을 미친 요소를 파악할 수 있습니다. 계정 전체에 적용할 수도 있고, 채널을 사용해 광고 단위의 하위 집합에서 실행할 수도 있습니다.
- 애플리케이션에서 동일한 보고서를 요청해 보세요.
- 광고 단위별로 보고서를 필터링할 수 있습니다.
adunits.list를 사용하여 광고 단위 목록을
가져옵니다.
광고 클라이언트 ID가 필요합니다 (1단계에서 확인). 광고 단위를
선택한 후 광고 단위의 ID를
reports.generate의
filter 매개변수에서
사용합니다.
광고 단위는 사용자가 구성한 광고 자리표시자로,
게재되는 광고의 일부 속성 (예: 크기 및 모양)을
정의합니다.
date_range: YESTERDAYdimensions: DATEmetrics: ESTIMATED_EARNINGSfilter: AD_UNIT_ID==ca-pub-123456789:987654321
- 맞춤 또는 URL 채널로 필터링하거나 여러 필터를 혼합해 보세요.
채널은 광고 단위의 하위 집합의 실적을
추적할 수 있는 도구입니다. 채널에는 URL과 맞춤이라는 두 가지 유형이 있습니다. 전자를 사용하면 특정 페이지 또는 도메인의 실적을 추적할 수 있으며, 후자를 사용하면 사용자가 선택한 특정 광고 단위 그룹의 실적을 추적할 수 있습니다.
이제 참조 문서에서 사용 가능한 호출 및 리소스를 모두 살펴보고 구현을 시작할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eStarts ADH import of a specified BigQuery table containing a quarterly brand lift benchmark report, triggered by the customer.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the year, quarter, and source BigQuery table in the request body.\u003c/p\u003e\n"],["\u003cp\u003eUses POST request to \u003ccode\u003ehttps://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandLiftBenchmark\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns an Operation object upon successful submission.\u003c/p\u003e\n"]]],["To use the AdSense Management API, first, obtain an AdSense account and familiarize yourself with it. Select a client library or make direct API requests. Register your application to get a Client ID, and configure your project with the credentials. Retrieve a list of ad clients, then generate reports using the API explorer or your application. Filter reports by ad units or channels, and explore the API reference documentation to start implementing your code.\n"],null,["# Get Started\n\nThis document is for developers who want to use the AdSense Management API to get\ninformation about their AdSense account. This document assumes that you're\nfamiliar with web programming concepts and web data formats.\n\nBefore you start\n----------------\n\n### Get an AdSense account\n\nSign up or sign in to your [AdSense\naccount](//adsense.google.com/) to get started.\n\n### Get familiar with AdSense\n\nIf you're not familiar with AdSense concepts read the [introductory information on AdSense](//support.google.com/adsense)\nand experiment with the [AdSense UI](//adsense.google.com/)\nbefore starting to code.\n\n### Choose your client library\n\nIn the [Client Libraries and Samples\npage](/adsense/management/libraries), you'll find information on the available libraries and samples. Click\nthe tab for your chosen language and follow the links to download the source.\nThe client libraries handle the following for you:\n\n- authentication\n- discovery of services\n- building the requests to the API\n- response parsing\n\nRead the instructions to install and configure your chosen client library,\ntypically found in the README file in the root directory of the repository.\n\nIf your implementation has special needs, such as using an unsupported\nlanguage, you can [make direct\nrequests](/adsense/management/direct_requests) to the API instead of using a client library.\n\nRegister your application\n-------------------------\n\nTo use the AdSense Management API you must register the application you're developing\nby creating a project and generating a Client ID.\nRegister your app\n\nEdit the configuration files for your client library project with the new\ncredentials you just created. Check the client library documentation for more\ndetails.\n\n**Note:** The Google Account used for registration should be\nyour **developer** account, that is, the account that you want users of your\napplication to see as the developer of the application. **This account does\nnot need to be tied to an AdSense login**, as users will be granting access\nto their own accounts while using the application.\n\nQuick start tutorial\n--------------------\n\nFollow the steps below to make your first requests, note that these steps\nmay vary slightly depending on the library or language you are using:\n\n1. Use the appropriate sample to retrieve a list of ad clients from an AdSense account. This request initiates a one-time process in which the AdSense user authenticates and authorizes your project. **Ad clients** represent an association between an\n AdSense account and an AdSense product, such as Content Ads or Search Ads.\n An AdSense account can have one or multiple ad clients.\n\n 1. For **web applications**, users will be redirected to a site where they can choose to grant access. Once authorized, they will be redirected to the callback URL defined in the Google API Console.\n 2. **Installed applications** work similarly. The client library will try to open a browser window and use an authorization code. For Android, Chrome and iOS applications this method is platform-specific.\n2. Use the [Google APIs explorer for\n `reports.generate`](/adsense/management/reference/rest/v2/accounts.reports/generate) to request the following report:\n - `date_range: YESTERDAY`\n - `dimensions: DATE`\n - `metrics: ESTIMATED_EARNINGS`\n\n **Reports** give you insight into what you're earning,\n as well as what's having an impact on those earnings. They can be run on\n an entire account or on a subset of ad units, through the use of\n channels.\n3. Try to request the same report from your application.\n4. You can filter the reports by ad units. Fetch the list of ad units using [adunits.list](/adsense/management/reference/rest/v2/accounts.adclients.adunits/list). Note that an ad client ID is needed (get it from step 1). After you choose an ad unit, use its ID in the [filter](/adsense/management/reporting/filtering) parameter for `reports.generate`:\n\n **Ad Units** are user-configured placeholders for ads,\n that define some properties for the ads being shown (such as size and\n shape).\n - `date_range: YESTERDAY`\n - `dimensions: DATE`\n - `metrics: ESTIMATED_EARNINGS`\n - `filter: AD_UNIT_ID==ca-pub-123456789:987654321`\n5. Try filtering by custom or URL channels or mixing multiple filters. **Channels** are tools that let you track the\n performance of a subset of your ad units. There are two types of channels:\n URL and custom. The former lets you track performance across a specific\n page or domain, whereas the latter help you track performance on specific\n user-selected groups of ad units.\n\nYou are ready to start your implementation by exploring the rest of the\navailable calls and resources in the [reference\ndocumentation](/adsense/management/reference/rest)."]]
