Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento è rivolto agli sviluppatori che desiderano utilizzare l'API AdSense Management per ottenere
informazioni sul proprio account AdSense. In questo documento si presuppone che tu abbia familiarità con i concetti di programmazione web e i formati di dati web.
Nella pagina Librerie client ed esempi troverai informazioni sulle librerie e sugli esempi disponibili. Fai clic
sulla scheda della lingua scelta e segui i link per scaricare il codice sorgente.
Le librerie client gestiscono per te quanto segue:
autenticazione
scoperta di servizi
creando le richieste all'API
analisi della risposta
Leggi le istruzioni per installare e configurare la libreria client scelta,
in genere disponibile nel file README nella directory radice del repository.
Se la tua implementazione ha esigenze speciali, ad esempio l'utilizzo di un linguaggio
non supportato, puoi effettuare richieste
diretto all'API anziché utilizzare una libreria client.
Registra la tua applicazione
Per utilizzare l'API AdSense Management, devi registrare l'applicazione che stai sviluppando creando un progetto e generando un ID client.
Modifica i file di configurazione del progetto della libreria client con le nuove credenziali appena create. Per ulteriori dettagli, consulta la documentazione
della libreria client.
Nota: l'Account Google utilizzato per la registrazione deve essere il tuo account sviluppatore, ovvero l'account che vuoi che gli utenti della tua applicazione vedano come sviluppatore dell'applicazione. Non è necessario collegare questo account a credenziali di accesso ad AdSense, perché gli utenti potranno concedere l'accesso ai propri account mentre utilizzano l'applicazione.
Tutorial di avvio rapido
Segui i passaggi riportati di seguito per effettuare le prime richieste. Tieni presente che questi passaggi potrebbero variare leggermente a seconda della libreria o della lingua che stai utilizzando:
Utilizza l'esempio appropriato per recuperare un elenco di client pubblicitari da un account AdSense. Questa richiesta avvia un processo una tantum in cui l'utente AdSense autentica e autorizza il progetto.
I clienti di annunci rappresentano un'associazione tra un account AdSense e un prodotto AdSense, come gli annunci di contenuti o gli annunci della rete di ricerca.
Un account AdSense può avere uno o più client pubblicitari.
Per le applicazioni web, gli utenti verranno reindirizzati a un sito in cui
possono scegliere di concedere l'accesso. Una volta autorizzati, verranno reindirizzati all'URL di callback definito nella console API di Google.
Il funzionamento delle applicazioni installate è simile. La libreria client tenterà di aprire una finestra del browser e utilizzare un codice di autorizzazione. Per le applicazioni Android, Chrome e iOS, questo metodo è specifico della piattaforma.
I report forniscono informazioni sulle entrate e sul loro impatto. Possono essere pubblicate su un intero account o su un sottoinsieme di unità pubblicitarie tramite l'uso dei canali.
Prova a richiedere lo stesso report dalla tua applicazione.
Puoi filtrare i report in base alle unità pubblicitarie. Recupera l'elenco delle unità pubblicitarie utilizzando adunits.list.
Tieni presente che è necessario un ID client pubblicitario (recuperalo dal passaggio 1). Dopo aver scelto
un'unità pubblicitaria, utilizza il suo ID nel
parametro filtro per
reports.generate:
Le unità pubblicitarie sono segnaposto configurati dall'utente per gli annunci, che definiscono alcune proprietà per gli annunci mostrati (come dimensioni e forma).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
Prova a filtrare in base a canali URL o personalizzati o a combinare più filtri.
I canali sono strumenti che ti consentono di monitorare il rendimento di un sottoinsieme di unità pubblicitarie. Esistono due tipi di canali: URL e personalizzato. La prima ti consente di monitorare il rendimento in una pagina o un dominio specifico, mentre il secondo ti consente di monitorare il rendimento in gruppi di unità pubblicitarie specifici selezionati dall'utente.
Per iniziare l'implementazione, esplora le altre chiamate e risorse disponibili nella documentazione di riferimento.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
