Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumen ini ditujukan bagi developer yang ingin menggunakan AdSense Management API untuk mendapatkan informasi tentang akun AdSense mereka. Dokumen ini mengasumsikan bahwa Anda sudah familier dengan konsep pemrograman web dan format data web.
Sebelum memulai
Membuat akun AdSense
Daftar atau login ke akun AdSense Anda untuk memulai.
Di halaman Library Klien dan Contoh, Anda akan menemukan informasi tentang library dan contoh yang tersedia. Klik
tab untuk bahasa yang Anda pilih, lalu ikuti link untuk mendownload sumber.
Library klien menangani hal berikut untuk Anda:
autentikasi
penemuan layanan
membuat permintaan ke API
penguraian respons
Baca petunjuk untuk menginstal dan mengonfigurasi library klien pilihan Anda,
yang biasanya ditemukan dalam file README di direktori utama repositori.
Jika penerapan Anda memiliki kebutuhan khusus, seperti menggunakan bahasa
yang tidak didukung, Anda dapat membuat permintaan
langsung ke API, bukan menggunakan library klien.
Daftarkan aplikasi Anda
Untuk menggunakan AdSense Management API, Anda harus mendaftarkan aplikasi yang sedang dikembangkan
dengan membuat project dan membuat Client-ID.
Edit file konfigurasi untuk project library klien Anda dengan kredensial baru yang baru saja dibuat. Periksa dokumentasi library klien untuk mengetahui detail
selengkapnya.
Catatan: Akun Google yang digunakan untuk pendaftaran harus merupakan akun developer, yaitu akun yang Anda inginkan dilihat oleh pengguna aplikasi sebagai developer aplikasi. Akun ini tidak perlu dikaitkan dengan login AdSense, karena pengguna akan memberikan akses ke akunnya sendiri saat menggunakan aplikasi.
Tutorial mulai cepat
Ikuti langkah-langkah di bawah ini untuk membuat permintaan pertama Anda. Perhatikan bahwa langkah-langkah ini
mungkin sedikit berbeda, bergantung pada library atau bahasa yang Anda gunakan:
Gunakan contoh yang sesuai untuk mengambil daftar klien iklan dari akun AdSense. Permintaan ini memulai proses satu kali saat pengguna AdSense mengautentikasi dan memberi otorisasi untuk project Anda.
Klien iklan mewakili pengaitan antara akun AdSense dan produk AdSense, seperti Iklan Konten atau Iklan Penelusuran.
Akun AdSense dapat memiliki satu atau beberapa klien iklan.
Untuk aplikasi web, pengguna akan dialihkan ke situs tempat mereka dapat memilih untuk memberikan akses. Setelah diberi otorisasi, mereka akan dialihkan
ke URL callback yang ditentukan di Konsol API Google.
Aplikasi yang terpasang memiliki cara kerja yang serupa. Library klien akan mencoba membuka jendela browser dan menggunakan kode otorisasi. Untuk aplikasi Android, Chrome, dan iOS, metode ini berbeda untuk setiap platform.
Laporan memberi Anda insight tentang jumlah yang Anda peroleh,
serta apa saja yang memengaruhi penghasilan tersebut. Iklan ini dapat dijalankan di
seluruh akun atau pada sebagian unit iklan, melalui penggunaan
saluran.
Coba minta laporan yang sama dari aplikasi Anda.
Anda dapat memfilter laporan menurut unit iklan. Ambil daftar unit iklan menggunakan
adunits.list.
Perhatikan bahwa client ID iklan diperlukan (dapatkan dari langkah 1). Setelah Anda memilih
unit iklan, gunakan ID-nya dalam
parameter filter untuk
reports.generate:
Unit Iklan adalah placeholder untuk iklan yang dikonfigurasi pengguna,
yang menentukan beberapa properti untuk iklan yang sedang ditampilkan (seperti ukuran dan
bentuk).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
Coba filter menurut saluran khusus atau URL, atau gabungkan beberapa filter.
Saluran adalah alat yang memungkinkan Anda melacak
performa sebagian unit iklan. Ada dua jenis saluran: URL dan kustom. Iklan pertama memungkinkan Anda melacak performa di halaman atau domain tertentu, sedangkan yang kedua membantu Anda melacak performa grup unit iklan tertentu yang dipilih pengguna.
Anda siap untuk memulai implementasi dengan mempelajari sisa
panggilan dan resource yang tersedia dalam dokumentasi
referensi.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
