Inizia

Questo documento è rivolto agli sviluppatori che vogliono utilizzare l'API AdSense Management per ottenere informazioni sul proprio account AdSense. Questo documento presuppone che tu conosca già i concetti di programmazione web e i formati dei dati web.

Prima di iniziare

Crea un account AdSense

Per iniziare, registrati o accedi al tuo account AdSense.

Impara a conoscere AdSense

Se non hai dimestichezza con i concetti di AdSense, leggi le informazioni introduttive su AdSense e prova a utilizzare l'interfaccia utente di AdSense prima di iniziare a programmare.

Scegli la libreria client

Nella pagina Librerie client ed esempi, troverai informazioni sulle librerie e gli esempi disponibili. Fai clic sulla scheda relativa alla lingua scelta e segui i link per scaricare il codice sorgente. Le librerie client gestiscono automaticamente 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 inviare richieste dirette 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 per il progetto della tua 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 l'account sviluppatore, ovvero l'account che desideri che gli utenti della tua applicazione visualizzino come sviluppatore dell'applicazione. Questo account non deve essere associato a dati di accesso AdSense, in quanto gli utenti concederanno l'accesso ai propri account durante l'utilizzo dell'applicazione.

Tutorial di avvio rapido

Segui i passaggi riportati di seguito per effettuare le tue prime richieste; tieni presente che questi passaggi potrebbero variare leggermente a seconda della libreria o della lingua in uso:

  1. Utilizza l'esempio appropriato per recuperare un elenco di client di annunci da un account AdSense. Questa richiesta avvia un processo una tantum in cui l'utente AdSense autentica e autorizza il tuo progetto.

    I clienti di annunci rappresentano un'associazione tra un account AdSense e un prodotto AdSense, come gli annunci della rete di contenuti o gli annunci della rete di ricerca. Un account AdSense può avere uno o più client di annunci.

    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.
    2. Le applicazioni installate funzionano in modo simile. La libreria client tenterà di aprire una finestra del browser e utilizzerà un codice di autorizzazione. Per le applicazioni Android, Chrome e iOS, questo metodo è specifico della piattaforma.
  2. Utilizza Explorer API per reports.generate per richiedere il seguente report:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    I report forniscono informazioni dettagliate su quanto stai guadagnando, nonché su cosa sta avendo un impatto su di esse. Possono essere pubblicate su un intero account o su un sottoinsieme di unità pubblicitarie, tramite l'uso di 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 devi disporre di un ID client annuncio (recuperalo dal passaggio 1). Dopo aver scelto un'unità pubblicitaria, utilizza il relativo ID nel parametro filter per reports.generate:

    Le unità pubblicitarie sono segnaposto per gli annunci configurati dall'utente che definiscono alcune proprietà per gli annunci pubblicati, come dimensione e forma.

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Prova a filtrare per canali URL o personalizzati oppure 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. Il primo consente di monitorare il rendimento in una pagina o un dominio specifico, mentre il secondo consente di monitorare il rendimento in specifici gruppi di unità pubblicitarie selezionati dall'utente.

Per iniziare l'implementazione, esplora le altre chiamate e risorse disponibili nella documentazione di riferimento.