Come iniziare

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.

Prima di iniziare

Crea un account AdSense

Per iniziare, registrati o accedi al tuo account AdSense.

Impara a conoscere AdSense

Se non conosci i concetti di AdSense, leggi le informazioni introduttive su AdSense e prova l'UI di AdSense prima di iniziare a programmare.

Scegli la libreria client

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.

Registrare l'app

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:

  1. 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.

    1. 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.
    2. 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.
  2. Utilizza l'Explorer API di Google per reports.generate per richiedere il seguente report:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    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.

  3. Prova a richiedere lo stesso report dalla tua applicazione.
  4. 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
  5. 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.