Annunci nativi

Questa guida è per i publisher che vogliono mostrare annunci Native sui propri siti. Spiega come inserire il codice, personalizzare il CSS e creare layout su misura.

Crea uno strumento Native ads per una fonte di traffico approvata e incolla il codice dove devono apparire le schede. Scegli Immagine + titolo oppure Immagine + titolo + descrizione, poi il layout (griglia, riga o scheda singola), da una a quattro schede e i colori. I formati immagine sono 16:9 (predefinito), 1.91:1 e quadrato. Le descrizioni mancanti vengono omesse.

Gli annunci Native usano immagini statiche e CPM. Lo SDK segnala una visualizzazione fatturabile dopo il caricamento dell’immagine principale e quando almeno il 50% della scheda resta visibile per un secondo continuo con la pagina attiva. Il solo caricamento dei dati dell’annuncio non genera una visualizzazione fatturabile. I click vengono tracciati separatamente, registrando al massimo un click per scheda.

Personalizzare il CSS

Il codice aggiunge le classi elencate sotto e carica automaticamente /native/widget.min.css. Aggiungi le regole al foglio di stile del tuo sito: gli stili predefiniti hanno specificità zero, quindi !important non serve, indipendentemente dall’ordine di caricamento. Per personalizzare un solo posizionamento, anteponi [data-tm-native="ZONE"] alla classe. Mantieni visibili e leggibili il badge AD e l’eventuale link alle opzioni pubblicitarie.

CSSElemento
.tm-nativeContenitore delle schede
.tm-native-grid, .tm-native-row, .tm-native-singleLayout selezionato
.tm-native-cardSingola scheda
.tm-native-linkLink della creatività
.tm-native-imageImmagine principale
.tm-native-bodyContenitore del testo
.tm-native-disclosureBadge AD con link alla pagina privacy della piattaforma; brand facoltativo nel tooltip
.tm-native-titleTitolo
.tm-native-descriptionDescrizione
.tm-native-privacyLink alle opzioni pubblicitarie
/* Replace ZONE with your placement key. */
[data-tm-native="ZONE"] { gap: 24px; }
[data-tm-native="ZONE"] .tm-native-card {
    border-radius: 0;
    background: #f8fafc;
    color: #172033;
    font-family: inherit;
}
[data-tm-native="ZONE"] .tm-native-title { font-size: 20px; }
[data-tm-native="ZONE"] .tm-native-image { aspect-ratio: 16 / 9; }
[data-tm-native="ZONE"] .tm-native-disclosure { font-size: 12px; }

JSON e layout personalizzato

Per un layout personalizzato, carica lo SDK con ?k=ZONE&sdk=1, richiedi i dati con TMNative.request(config) e inserisci i contenuti con textContent. Passa allo SDK la scheda inserita nel DOM e la sua immagine principale. Non rimuovere l'indicazione pubblicitaria. Ogni scheda richiede un'asta separata; non riutilizzare la risposta per altre impressioni.

Per più schede personalizzate, richiedile in sequenza. Passa i valori campaignKey delle risposte precedenti in config.exclude (fino a quattro chiavi) per selezionare ogni campagna al massimo una volta per widget ed evitare che più schede utilizzino lo stesso cap della campagna. Il codice di incorporamento predefinito lo fa automaticamente.

Il badge AD rimanda a ad.disclosureUrl, la pagina privacy della piattaforma. Il brand, se presente, appare nel tooltip. Se la risposta include ad.privacy, mostralo come link separato alle opzioni pubblicitarie. L’SDK di tracciamento aggiunge gli elementi informativi mancanti alle schede personalizzate. Mantieni questi link separati dall’URL di clic dell’inserzionista.

<script src="https://YOUR-TRACKING-DOMAIN/native/?k=ZONE&sdk=1"></script>
<div id="native-slot"></div>
<script>
const config = {key: 'ZONE', endpoint: 'https://YOUR-TRACKING-DOMAIN/native/ads.php'};
TMNative.request(config).then(ticket => {
    if (!ticket) return;
    TMNative.render(document.getElementById('native-slot'), ticket, config);
    // Custom DOM instead: TMNative.track(card, mainImage, ticket, config).
});
</script>