Guida tecnica all'installazione e configurazione del motore di ricerca Google in un sito web

Da quando Google ha interrotto la vendita di Google Site Search, il 1° aprile 2017, molti utenti si sono trovati a dover fronteggiare una situazione poco chiara: la documentazione fornita dall'azienda di Mountain View, infatti, è stata - ed è tutt'ora - ben poca. Il primo Aprile 2018 GSS è stato completamente dismesso.

Indice dei contenuti

• Cosa succede dopo la dismissione di Google Site Search
• Come implementare il nuovo motore di ricerca gratuito Custom Search Engine
• Come utilizzare la versione a pagamento senza annunci pubblicitari (tramite API)
• La mia opinione sulle scelte di Google
• Quanto costa il Custom Search Engine a pagamento?

Allo stesso tempo stanno spingendo la diffusione del loro Custom Search Engine, che è molto simile a GSS, solo che è gratuito ed inserisce annunci pubblicitari tra i risultati di ricerca.

Ho dovuto anche io avere a che fare con questo caso più volte, ho scambiato varie email con il supporto di Google senza mai avere una risposta definitiva, ho cercato soluzioni alternative e già pronte all'uso, ma non ho trovato nulla. È chiaro che se un utente è abituato ad utilizzare il motore di Google nel suo sito, non è facile proporgli qualcosa di completamente diverso. Contemporaneamente, se non hai già qualcosa di pronto creato da te, devi investire molte ore (quindi molti soldi) per realizzare un tuo motore di ricerca, che in ogni caso non potrà mai competere con la potenza di Google, purtroppo, a meno che tu abbia una realtà solida alle spalle che è intenzionata a spendere migliaia di euro.

Insomma, se abbiamo decine di clienti il cui sito web utilizza/utilizzava Google Site Search... Come risolvere la cosa?

Andiamo per punti, in modo ordinato:

Cosa succede da quando Google ha dismesso il suo Site Search?

Risposta semplice: nulla. In realtà l'azienda americana informa via mail tutti gli utilizzatori del prodotto che il servizio termina, convertendosi però in CSE gratuito. La differenza principale per chi deve implementare il motore all'interno di un sito internet, sta nel codice da utilizzare. Infatti se utilizziamo un codice recente come questo, che utilizza il Custom Search Element 2.0, non dovremmo avere grossi problemi. Se invece stiamo sfruttando dei codici completamente diversi, o troppo vecchi? Allora:

Come implementare il nuovo motore di ricerca CSE gratuito?

Il Custom Search Engine di Google è la versione gratuita (e ora l'unica versione) del motore di ricerca che si può utilizzare nel proprio sito. All'interno dei risultati di ricerca possono apparire degli annunci pubblicitari. Supponiamo che un utente cerchi nel sito "libri" o "lampade", tra i risultati potrebbe vedere dei "libri" o delle "lampade" di una determinata azienda (magari concorrente), che sta pagando affinchè i suoi annunci appaiano nella rete Display di Google AdWords.

Per implementarlo, basta creare un nuovo motore (se non ne abbiamo già uno) nell'apposito sito. Dopodichè inseriamo l'indirizzo del sito in cui cercare, tipo "www.example.com" e scegliamo una lingua e un nome da assegnare. Ora possiamo già generare il codice per l'implementazione, copiarlo ed inserirlo come indicato da Google: quindi all'interno del tag HEAD della pagina.

Chiaramente, se stavamo già utilizzando CSE, possiamo limitarci ad aggiornare il codice generato, se vediamo che è diverso. Per chi invece utilizzava versioni particolari di GSS con codice completamente diverso, dovrà solo capire se vuole la versione gratuita ad annunci o la versione a pagamento senza pubblicità . Nel secondo caso, continua a leggere di seguito.

Complimenti, il tuo motore di ricerca è pronto! Ora devi verificare se il motore precedente aveva delle impostazioni particolari, che dovrai riportare anche qui.

Come implementare la versione a pagamento e senza annunci pubblicitari di CSE?

Qui entriamo più nel tecnico. Vi spiegherò la scelta che ho fatto io: non ho voluto utilizzare i sistemi indicati da Google, come la Custom Search Element Control API 2.0 o le librerie già pronte. Non mi sembrava che la documentazione fosse sufficientemente chiara. Ho optato invece per l'alternativa delle JSON/Atom API partendo però da zero. Nelle mail che ho scambiato con il supporto Google, quel poco che ho potuto capire è che l'unico modo per non avere gli annunci pubblicitari era di utilizzare la versione a pagamento, solo che nessuno ti dava una semplice implementazione. Invece di passare ore a capire come utilizzare le librerie, che poi magari non facevano comunque quello che volevo, ho voluto creare io una soluzione ad-hoc. Mi sembrava impossibile che la stessa Google, dismettendo GSS, non ti fornisse qualcosa di già pronto se volevi utilizzare CSE pagando le query... Eppure ancora adesso è cosi! Credo infatti che l'intento dell'azienda sia ben preciso, e alla fine di questo punto spiegherò brevemente la mia opinione.

Passaggi da seguire:

1. Creare o modificare il proprio motore di ricerca. Prendere il codice identificativo del motore. (leggi anche il punto 2 qui sopra)
2. Registrarsi a Google Cloud e impostare un metodo di pagamento (leggi il punto 4 per saperne di più sui costi)
3. Creare un progetto nel Cloud Google
4. Aggiungere al progetto creato l'API Custom Search dalla libreria disponibile
5. Creare una chiave API (api key) per Custom Search. Eventualmente imporre delle restrizioni. Questa chiave ci servirà per implementare il nostro motore.
6. Utilizzare il codice identificativo (ID cx del motore) e la chiave API nel proprio script.

Nel dettaglio:

1. Avremo bisogno del codice identificativo del motore di ricerca da implementare, che si chiama tecnicamente "cx"...
2. ... e della chiave API creata nel Cloud, che si definisce come "key".
3. Possiamo fare dei test con l'API Explorer o nella pagina delle reference dei parametri
4. La singola query è definita come paramentro "q".

Codice di esempio:

Di seguito riporto un esempio che ho realizzato in PHP.

Visualizza il codice su PasteBin

In pratica, sto solamente inviando una richiesta AJAX all'URL indicato nella documentazione Google, quindi ricevo ed elaboro il risultato in PHP e costruisco il mio motore di ricerca, decidendo separatamente se voglio mostrare anche i risultati "promossi" o solo quelli normali. I risultati promossi possono essere impostati dal pannello di CSE.

Un esempio di HTML di default per l'implementazione: Chiaramente il codice del motore viene generato in PHP come visto qui sopra.

E lo stile CSS basato sul colore rosso: Questo è liberamente modificabile, ma lo metto a disposizione come punto di partenza.

La mia opinione sulle scelte di Google:

Utilizzando CSE gratuito gli utenti che eseguono le ricerche possono vedere degli annunci inseriti a pagamento. Molto spesso chi acquistava una licenza di Google Site Search pagava per un tot. di query in blocco. Una query è ogni singola ricerca fatta dall'utente. Capitava spesso di acquistare 150.000, o 500.000 query, pagate in anticipo, e poi alla fine ne consumavi meno della metà . Giustamente ora Google, attraverso l'uso delle API, farà pagare le query "a consumo", quindi in base a quello che viene realmente utilizzato. Per maggiori dettagli su costi e pagamenti leggi il prossimo capitolo. In questo modo, a mio avviso, molti utenti inizieranno ad utilizzare il CSE gratuito al posto del GSS, quindi si amplierà il numero di persone che vedranno annunci pubblicitari.
Chi invece non vuole gli annunci di altre aziende nel suo sito web, come molti enti della pubblica amministrazione, oppure come molte imprese private, pagherà tranquillamente per il servizio perchè è comunque un qualcosa in più che viene offerto agli utenti finali. Secondo me questo permetterà da un lato di risparmiare per chi deve implementare il motore, e dall'altro di guadagnare per i publisher, advertiser, e quindi per la stessa Google.

Quanto costa il CSE a pagamento?

Il costo è quello del consumo delle query. Ricordando che una query è ogni singola richiesta effettuata tramite il motore di ricerca, il costo effettivo stabilito da Google è di 5$ ogni 1000 query. Le prime 100 richieste di ogni giorno sono gratuite, quindi se in media il sito utilizza 120 query al giorno, ne pagheremo solo 20.

Google addebiterà tramite il Cloud una fattura nei primi giorni di ogni mese. Se ci siamo registrati per la prima volta al Cloud Google, avremo un bonus di 300€ da spendere nelle varie API, quindi finchè non consumiamo questo bonus la nostra carta di credito (o conto bancario) non sarà addebitata.

Supponiamo quindi di prevedere per un sito una media di 25.000 ricerche annue. Il costo in preventivo sarà di 125€ (25.000*5/1000). Considerate comunque che il costo reale, essendo a consumo, sarà calcolato su quello che veramente viene utilizzato dagli utenti. Inoltre, se il motore riceverà meno di 100 richieste al giorno, alla fine non pagheremo nulla, proprio perchè le prime 100 ricerche al giorno sono a costo zero.

Consulta i prezzi sul sito del Custom Search Engine.

Congratulazioni per aver implementato il motore di ricerca CSE nel tuo sito!

Spero che questo articolo ti sia stato utile, in ogni caso lasciami un commento e, se ti va, condividilo sui tuoi social! Buon lavoro.