English version of this post
La decisione di inserire l'advertising di Google AdSense sulle pagine di questo sito ha di fatto sviluppato l'esigenza di un'estensione (o plugin) per BlogEngine.NET che potesse consentire un'agevole gestione degli annunci pubblicati insieme agli articoli. Se, infatti, da un lato, l'inserimento del codice Adsense all'interno delle porzioni statiche del template di pagina è un'operazione relativamente semplice (è sufficiente infatti copiare il codice nella posizione voluta), il discorso cambia completamente nel momento in cui si desiderano inserire degli annunci anche negli articoli o nelle pagine.
Inoltre potrebbe essere interessante scegliere il targeting pubblicitario, riservando ad esempio la visualizzazione dell'advertising solo a determinate categorie di visitatori, che potrebbero essere più interessate a quanto reclamizzato, proprio in virtù del fatto che magari giungono sulle pagine da un motore di ricerca, non avendo ancora piena consapevolezza dell'obiettivo del loro cercare.
In tal modo si potrebbe risparmiare la visione (ed il fastidio nonchè ingombro) degli annunci ai visitatori abituali o ai visitatori provenienti da altre fonti che non siano i motori di ricerca.
Proprio per questo motivo ho sviluppato Adsense Injector: probabilmente si tratta della prima (se non unica almeno per il momento) estensione per BlogEngine.NET che consente un'agevole nonchè personalizzabile inserimento degli annunci Adsense all'interno degli articoli pubblicati.
Aggiornamento del 5 maggio 2008: release 2.0
La release 2.0 aggiunge una serie di nuove funzionalità tra le quali spicca il supporto multi autore alla pubblicazione degli annunci e la modalità di posizionamento casuale dell'annuncio all'interno del testo.
Installazione
Scaricare l'archivio compresso AdsenseInjector.zip (2,47 kb) (rel: 2.0.0), quindi:
- Decomprimere il file
- Copiare il file AdsenseInjector.cs nella cartella /App_Code/Extensions/
Aggiornamento da una versione precedente
- Disattivare l'estensione dal pannello di controllo estensioni
- Rimuovere l'estensione dalla cartella /App_Code/Extensions/
- Rimuovere l'intera sezione
<ManagedExtension Name="AdsenseInjector">
...
</ManagedExtension>
dal file extensions.xml presente nella cartella /App_Data/
- Copiare il nuovo file AdsenseInjector.cs nella cartella /App_Code/Extensions/
- Configurare l'estensione
Configurazione
Una volta terminata l'installazione, dal pannello di controllo dell'estensione è possibile inserire fino a 3 (tre) configurazioni differenti di annunci per ciascun autore (in realtà se ne possono inserire anche di più, ma il sistema di controllo ne pubblicherà sempre e comunque fino ad un massimo di 3, fra quelli attivi).
Per ciascuna configurazione si dovranno inserire (obbligatoriamente) i seguenti parametri:
- Author: nome dell'autore a cui dovrà essere associata la definizione dell'annuncio. L'annuncio verrà pubblicato solo nei post dell'autore medesimo. Inserendo "forever", l'annuncio sarà pubblicato indipendentemente dall'autore del post.
(questo parametro è presente dalla release 2.0)
- Publisher ID: ovvero il relativo codice rilasciato da Google Adsense.
- Description: descrizione dell'annuncio (se si lascia questo campo vuoto l'annuncio non verrà pubblicato e verrà considerato come inattivo).
- ID Slot: il codice univoco associato da Google Adsense in fase di creazione e personalizzazione dell'annuncio.
- Size (width): larghezza dell'annuncio (fare riferimento agli standard imposti).
- Size (height): altezza dell'annuncio (fare riferimento agli standard imposti).
- Style (code): codice CSS da associare all'annuncio per il suo corretto posizionamento.
- Position: valorizzare con T (top) per posizionare l'annuncio all'inizio del post, con B (bottom) per posizionarlo alla fine e con C (center) per inserirlo all'interno del testo (la posizione viene calcolata dividendo per 2 il numero di paragrafi contenuti nel post). Con R (random), il posizionamento verrà effettuato casualmente o all'inizio, o alla fine o al centro.
(quest'ultimo valore è disponibile dalla release 2.0)
- Display: valorizzare con A (always) per mostrare sempre l'annuncio, con R (referrer) solo ai visitatori provenienti da referrer (inclusi i motori di ricerca) e con S (search) solo ai visitatori provenienti da motori di ricerca.
- Insert: valorizzare con B (both) per mostrare l'annuncio sia nelle pagine che nei post, con P (post) solo nei post e con A (page) solo nelle pagine.
La visualizzazione dell'advertising viene automaticamente disattivata se l'autore (o amministratore) si è autenticato sul blog. (questa funzionalità è presente dalla release 2.0)
E' possibile escludere completamente l'inserimento di annunci pubblicitari dal singolo post (o pagina) semplicemente inserendo all'interno del testo (in una qualunque parte dello stesso) il tag(questa funzionalità è presente dalla release 2.0) :
[ noadsense ]
L'estensione inoltre racchiude ciascun post (o pagina) all'interno dei tag:
<!-- google_ad_section_start --> ... <!-- google_ad_section_end -->
per indicare con più precisione al crawler di Adsense quali sono i contenuti da contestualizzare per la scelta degli annunci.
Posizionamento degli annunci
Per posizionare correttamente l'annuncio all'interno del post è possibile valorizzare (ad esempio) il parametro Style, come segue:
- Allineamento float a destra e spaziatura di 10 pixel per lato :
float: left; padding: 10px
- Allineamento al centro e spaziatura di 10 pixel in alto e 20 in basso:
align: center; padding: 10px 0 20px
- ecc. ecc.
Attenzione!
Questa estensione è rilasciata "così com'è" e si declina qualunque tipo di responsabilità derivante dal suo uso o abuso. Allo stesso modo si declina qualunque responsabilità derivante da eventuali operazioni di banning effettuate da Google in caso di uso illecito o sconsiderato della stessa.
Adsense Injector extension for BlogEngine.NET
Adsense Injector is the first (if not unique, at least for the moment) BlogEngine.NET extension that allows smooth and customizable ad insertion within Google Adsense of articles published.
Update on May 5, 2008: release 2.0
Release 2.0 adds a lot of new features including support for multiple author and random placement of ads in posts or pages.
Installation
Download the compressed file AdsenseInjector.zip (2,47 kb) (rel: 2.0.0), then:
- Extract files.
- Copy AdsenseInjector.cs into /App_Code/Extensions/ folder
Upgrading from an earlier version
- Turn off the extension from the control panel of blog
- Remove the extension's file from the folder /App_Code/Extensions/
- Remove the entire section
<ManagedExtension Name="AdsenseInjector">
...
</ManagedExtension>
from file extensions.xml in /App_Data/ folder
- Copy the new file AdsenseInjector.cs into /App_Code/Extensions/ folder
- Setting the required extension's parameters
Configuration
From the extension control panel is possible to insert up to 3 different configurations of ads for each author (in fact you can pass even more, but the control system will always publish up to 3, among the actives).
The component is completely configurable valuing the following mandatory attributes :
- Author: author's name that should be associated to the definition of the ad. Entering "forever", the announcement will be published independently from the author's post.
( This feature is only present in release 2.0)
- Publisher ID: Publisher ID code issued by Google Adsense.
- Description: Description (if you leave this field blank ad will not run and will be treated as inactive).
- ID Slot: The ad unique code.
- Size (width): Ad width (refer to the standards imposed)
- Size (height): Ad height (refer to the standards imposed)
- Style (code): CSS code for its proper positioning.
- Position: T = top of post, B = bottom of post, C = middle of post. R = random position (Top, Middle or Bottom)
( Random position is only present in release 2.0)
- Display: A = display always, R = display only to referrers (including search engines), S display only to search engines.
- Insert: B = display in posts and pages, P = display only in posts, A = display only in pages
The display of advertising is automatically disabled if you are logged in. (This feature is only present in release 2.0)
If you do not want to show advertising in individual post or page, insert in the text the tag: (This feature is only present in release 2.0)
[ noadsense ]
The extension also encloses each post (or page) within tags:
<!-- google_ad_section_start --> ... <!-- google_ad_section_end -->
Style attributes examples:
- Alignment float right and spacing of 10 pixels per side:
Float: left; padding: 10px
- Align the center and spacing of 10 pixels above and 20 below:
Align: center; padding: 10px 0 20px
Attention!
This extension is granted "as is" and disclaims any liability arising from its use or abuse.
You can leave comments in English ...
P.S.: I'm sorry for my poor english
