Annunci nativi

Gli annunci nativi sono annunci formattati in modo da adattarsi al design visivo e ai contenuti circostanti, aumentando le loro probabilità di visualizzazione e clic da parte degli utenti. L'inventario di annunci nativi è disponibile su app mobile, nonché su siti web per computer e dispositivi mobili. Per ulteriori informazioni sugli annunci nativi, consulta Panoramica degli annunci nativi.

Gli annunci nativi sono supportati sia per Authorized Buyers sia per Open Bidding.

Ecco il flusso di lavoro per gli annunci nativi:

  1. Google riceve una chiamata per un annuncio nativo. La chiamata specifica uno o entrambi i seguenti modelli di annuncio nativo, ognuno dei quali specifica i campi nativi preferiti.
  2. Google invia agli acquirenti una richiesta di offerta RTB contenente un elenco dei campi richiesti.
  3. Gli acquirenti interessati rispondono con i campi richiesti.
  4. Google avvia un'asta per selezionare l'offerta vincente e invia al publisher gli asset della creatività forniti dall'acquirente.
  5. Il publisher assembla gli asset in un annuncio nativo e assegna loro uno stile adatto al design del sito.

Formati dei messaggi

Google supporta la specifica OpenRTB sia in JSON che in Protobuf.

Per gli annunci nativi OpenRTB Protobuf, i seguenti campi differiscono dalle specifiche:

JSON Tipo JSON Protobuf Tipo Protobuf
BidRequest.imp[].native.request string BidRequest.imp[].native.request_native NativeRequest
BidResponse.seatbid[].bid[].adm string BidResponse.seatbid[].bid[].adm_native NativeResponse

I campi OpenRTB Protobuf sono messaggi Protobuf anziché stringhe.

Se utilizzi l'implementazione Protobuf di OpenRTB, il tuo endpoint riceve richieste di offerta contenenti BidRequest.imp.native.request_native anziché BidRequest.imp.native.request. Inoltre, il tuo endpoint deve restituire risposte all'offerta che compilano BidResponse.seatbid.bid.adm_native anziché BidResponse.seatbid.bid.adm, altrimenti verrà filtrato dall'asta.

Quando fai un'offerta che include un annuncio nativo, l'endpoint di offerta deve specificare gli asset obbligatori e gli eventuali asset facoltativi che scegli di includere nel campo BidResponse.seatbid.bid.{adm/adm_native}.assets. Gli asset inviati nella risposta devono includere il valore id corrispondente specificato nella richiesta di offerta. id viene utilizzato per strutturare il modello e distinguere tipi simili di asset, come immagini principali e icone. L'esempio seguente mostra come vengono compilati gli oggetti NativeRequest e NativeResponse nei formati OpenRTB e JSON:

JSON OpenRTB (analizzato)

NativeRequest 
{
  "ver": "1.2",
  "assets": [
    {
      "id": 1,
      "required": 1,
      "title": {
        "len": 25
      }
    },
    {
      "id": 2,
      "required": 1,
      "data": {
        "type": 2,
        "len": 90
      }
    },
    {
      "id": 3,
      "data": {
        "type": 12,
        "len": 15
      }
    },
    {
      "id": 4,
      "required": 1,
      "img": {
        "type": 3,
        "wmin": 1200,
        "hmin": 627
      }
    },
    {
      "id": 5,
      "required": 1,
      "img": {
        "type": 1,
        "wmin": 100,
        "hmin": 100
      }
    },
    {
      "id": 6,
      "data": {
        "type": 3,
        "len": 5
      }
    },
    {
      "id": 7,
      "data": {
        "type": 6
      }
    }
  ],
  "eventtrackers": [
    {
      "event": 1,
      "methods": [
        1
      ]
    }
  ]
}
NativeResponse 
{
  "ver": "1.2",
  "assets": [
    {
      "id": 1,
      "title": {
        "text": "Luxury Mars Cruises"
      }
    },
    {
      "id": 2,
      "data": {
        "value": "Visit the planet in a luxury spaceship."
      }
    },
    {
      "id": 3,
      "data": {
        "value": "Book today"
      }
    },
    {
      "id": 4,
      "img": {
        "url": "https://native.test.com/image?id=123456",
        "w": 100,
        "h": 100
      }
    },
    {
      "id": 5,
      "img": {
        "url": "https://native.test.com/icon?id=123456",
        "w": 200,
        "h": 200
      }
    }
  ],
  "link": {
    "url": "https://www.google.com",
    "clicktrackers": [
      "https://native.test.com/click?id=123456"
    ]
  },
  "imptrackers": [
    "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
  ]
}

OpenRTB Protobuf

NativeRequest 
request_native {
  ver: "1.2"
  assets {
    id: 1
    required: true
    title {
      len: 25
    }
  }
  assets {
    id: 2
    required: true
    data {
      type: DESC
      len: 90
    }
  }
  assets {
    id: 3
    data {
      type: CTATEXT
      len: 15
    }
  }
  assets {
    id: 4
    required: true
    img {
      type: MAIN
      wmin: 1200
      hmin: 627
    }
  }
  assets {
    id: 5
    required: true
    img {
      type: ICON
      wmin: 100
      hmin: 100
    }
  }
  assets {
    id: 6
    data {
      type: RATING
      len: 5
    }
  }
  assets {
    id: 7
    data {
      type: PRICE
    }
  }
  eventtrackers {
    event: IMPRESSION
    methods: IMG
  }
}
NativeResponse 
adm_native {
  assets {
    id: 1
    required: true
    title {
      text: "Luxury Mars Cruises"
    }
  }
  assets {
    id: 2
    required: true
    data {
      value: "Visit the planet in a luxury spaceship."
    }
  }
  assets {
    id: 3
    data {
      value: "Book today"
    }
  }
  assets {
    id: 4
    required: true
    img {
      url: "https://native.test.com/image?id=123456"
      w: 1200
      h: 627
    }
  }
  assets {
    id: 5
    required: true
    img {
      url: "https://native.test.com/icon?id=123456"
      w: 128
      h: 128
    }
  }
  assets {
    id: 6
    data {
      value: "5"
    }
  }
  link {
    url: "https://www.google.com"
    clicktrackers: "https://native.test.com/click?id=123456"
  }
  imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}

Se utilizzi un SDK per gli acquirenti per eseguire il rendering degli annunci nativi, devi includere un'immagine type in declared_ad quando invii le creatività per la revisione.

Modelli di annunci nativi

I modelli di annunci nativi descrivono i componenti di un annuncio nativo e determinano i contenuti e la struttura di NativeRequest nella richiesta di offerta. Google supporta i due modelli di annunci nativi più comuni per gli annunci nativi video e non video:

Esistono altri modelli che possono avere un insieme di requisiti diverso per quanto riguarda campi, dimensioni e misure.

Modello di annuncio per l'installazione di app

Le tabelle seguenti mostrano i campi etichettati come Obbligatorio o Consigliato. Valgono le seguenti regole:

  • I campi contrassegnati come Obbligatorio sono richiesti dall'offerente.
  • I campi contrassegnati come Consigliato non sono obbligatori per l'offerente e il publisher può mostrarli o meno se forniti (ad esempio, la valutazione a stelle).
  • L'invito all'azione è sempre contrassegnato come Consigliato perché viene assegnato un valore predefinito se l'offerente non ne invia uno, ma verrà sempre visualizzato se inviato.

La tabella seguente elenca i campi di un modello di annuncio per l'installazione di app. Le app mobile utilizzano questi campi per creare annunci nativi per l'installazione di app.

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzato? Dimensioni consigliate dell'immagine/numero massimo di caratteri Esempio
Titolo Il titolo dell'app Obbligatorio Sì 25 caratteri Flood-It!
Immagine Uno screenshot dell'app o un'altra immagine pertinente Obbligatorio No 1200 x 627 px o 600 x 600 px a seconda delle proporzioni richieste dall'editore. <Screenshot del gioco Flood-It!>
Corpo Testo principale dell'app Obbligatorio No 90 caratteri Ingannevolmente semplice + incredibilmente impegnativo = deliziosamente avvincente.
Icona dell'app L'icona dell'app Obbligatorio No 128 x 128 px <Icona dell'app Flood-it!>
Call to action Azione utente preferita Consigliato Sì 15 caratteri Installa
Valutazione a stelle Numero di stelle (da 0 a 5) che rappresenta la valutazione dell'app nello store Consigliato No 0 - 5 4,5
Prezzo Il costo dell'app Consigliato No 15 caratteri Nessun costo

Note sulla lunghezza del testo

Se un acquirente invia un asset di testo (ad esempio il corpo del testo) più lungo del numero massimo di caratteri suggerito, il testo potrebbe essere troncato e potrebbero essere aggiunti puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per il cinese, il giapponese e il coreano. Ad esempio, il limite per i titoli è pari a 90 per l'inglese e a 45 per il cinese.

Note sulle dimensioni delle immagini

I publisher possono:

  • Ritaglia l'immagine principale simmetricamente fino al 20% in una dimensione (altezza o larghezza).
  • Ridimensiona l'immagine senza modificarne le proporzioni.
  • Le immagini con proporzioni sostanzialmente diverse da quelle implicite nell'altezza e nella larghezza potrebbero essere filtrate.

Modello di annuncio di contenuti

La tabella seguente elenca i campi di un modello di annuncio di contenuti. I publisher utilizzano questi campi per creare annunci di contenuti nativi.

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzato? Dimensioni consigliate delle immagini/numero massimo di caratteri * Esempio
Titolo L'intestazione dell'annuncio Obbligatorio Sì 25 caratteri Tassi di interesse più bassi per i mutui
Immagine L'immagine principale dell'annuncio Obbligatorio No 1200 x 627 px o 600 x 600 px a seconda delle proporzioni richieste dall'editore. <Immagine principale dell'annuncio>
Corpo Il contenuto dell'annuncio Obbligatorio No 90 caratteri La tua casa a Brooklyn, più economica e più vicina di quanto pensi.
Logo Logo dell'inserzionista o un'altra piccola immagine pertinente Consigliato No 128 x 128 px <Logo di NY Mortgage Inc.>
Call to action Azione preferita dell'utente Consigliato No 15 caratteri Richiedi un preventivo
Inserzionista Testo che identifica l'inserzionista o il brand Obbligatorio No 25 caratteri NY Mortgage Inc.

Modello di annuncio video per l'installazione di app

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzato? Dimensioni consigliate delle immagini/numero massimo di caratteri * Esempio
Video La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video. Obbligatorio No - Un URL al file XML VAST contenente un Flood-It! Annuncio video
Titolo Il titolo dell'app Obbligatorio Sì 25 caratteri Flood-It!
Immagine L'immagine (miniatura) mostrata nel player prima che venga fatto clic sull'annuncio video o durante il caricamento dell'annuncio. Obbligatorio No Dovrebbe avere le stesse proporzioni del video (ad esempio: 1280 x 720 per i video 16:9, 4:3 per i video 640 x 480). Uno screenshot del gioco Flood-It! Oppure dal video
Corpo Testo principale dell'app Obbligatorio No 90 caratteri Ingannevolmente semplice + incredibilmente impegnativo = deliziosamente avvincente.
Icona dell'app L'icona dell'app Obbligatorio No 128 x 128 px Icona dell'app Flood-it!
Call to action Azione utente preferita Obbligatorio Sì 15 caratteri Installa
Valutazione a stelle Numero di stelle (da 0 a 5) che rappresenta la valutazione dell'app nello store Consigliato No 0 - 5 4,5
Prezzo Il costo dell'app Consigliato No 15 caratteri Nessun costo

Restrizioni

  • Video: tutti i video devono essere sotto forma di URL VAST o tag VAST. Non è possibile specificare un file video non elaborato, ad esempio WebM, MP4 e così via.

  • Lunghezza del testo: se un acquirente specifica un asset di testo come body nella risposta, questo potrebbe essere troncato e potrebbero essere aggiunti puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per cinese, giapponese e coreano. Ad esempio, il limite per i titoli è pari a 90 in inglese e a 45 in cinese.

  • Dimensioni delle immagini: i publisher possono:

    • Ritaglia l'immagine principale simmetricamente fino al 20% in una dimensione (altezza o larghezza).
    • Ridimensiona l'immagine senza modificarne le proporzioni.

Esempio di annuncio per l'installazione di app

(annuncio) nativo video

Modello annuncio di contenuti video

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzato? Dimensioni consigliate delle immagini/numero massimo di caratteri * Esempio
Video La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video. Obbligatorio Sì - Un URL al file XML VAST contenente un Flood-It! Annuncio video
Titolo L'intestazione dell'annuncio Obbligatorio Sì 25 caratteri Tassi di interesse più bassi per i mutui
Immagine L'immagine (miniatura) mostrata nel player prima che venga fatto clic sull'annuncio video o durante il caricamento dell'annuncio. Obbligatorio No Dovrebbe avere le stesse proporzioni del video (ad esempio: 1280 x 720 per i video 16:9, 4:3 per i video 640 x 480). Uno screenshot del video
Corpo Il contenuto dell'annuncio Obbligatorio No 90 caratteri La tua casa a Brooklyn, più economica e più vicina di quanto pensi.
Logo Logo dell'inserzionista o un'altra piccola immagine pertinente Consigliato No 128 x 128 px Logo di NY Mortgage Inc.
Call to action Azione preferita dell'utente Obbligatorio No 15 caratteri Richiedi un preventivo
Inserzionista Testo che identifica l'inserzionista o il brand Obbligatorio No 25 caratteri NY Mortgage Inc.

Metafield

I seguenti campi meta sono condivisi da tutti i modelli di annuncio supportati:

Campo Descrizione
BidResponse.seatbid.bid.{adm/adm_native}.link.url

L'URL della pagina di destinazione finale a cui verrà indirizzato l'utente dopo aver fatto clic sull'annuncio. È obbligatorio utilizzare questo campo in caso di pagine di destinazione dinamiche.
BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers Facoltativo. URL aggiuntivi che consentono agli inserzionisti di monitorare i clic degli utenti sull'annuncio.
BidResponse.seatbid.bid.{adm/adm_native}.privacy Link a una pagina di preferenze o disattivazione degli annunci. Se presente, alla creatività nativa viene aggiunta un'icona Scegli Tu! standard che viene collegata a questo URL.
BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers Il monitoraggio delle impressioni può essere eseguito includendo eventtrackers nella risposta nativa, dove event è impostato su IMPRESSION.

Rappresentazione del modello di annuncio nativo nella richiesta di offerta

Quando ricevi una richiesta di offerta contenente inventario nativo, questa includerà il modello di annuncio nativo rappresentato dal messaggio NativeRequest di OpenRTB. Fornisce le seguenti informazioni sull'inventario di annunci nativi:

  • Asset facoltativi o obbligatori.
  • Dimensioni per immagini, loghi e icone dell'app.
  • Specifiche dello stile in cui viene visualizzato l'annuncio.

Asset facoltativi e obbligatori

Puoi trovare gli asset facoltativi e obbligatori per un'impressione di annuncio nativo in BidRequest.imp.native.{request/request_native}.assets. Descrive i componenti dell'annuncio nativo, ad esempio titolo, corpo o logo. Ogni asset incluso nella richiesta ha un id distinto e popola required come True per quelli che devono essere inclusi nella risposta all'offerta.

Rappresentazione di un annuncio nativo nella risposta all'offerta

Quando fai offerte per l'inventario nativo, devi includere un NativeResponse compilato con gli asset richiesti indicati nella richiesta di offerta e può anche includere gli asset facoltativi specificati. Puoi includerli in una risposta all'offerta con BidResponse.seatbid.bid.{adm/adm_native}.assets. Quando compili assets nella risposta, ognuno deve includere id corrispondente a quell'asset della richiesta di offerta.

Esempi di richieste di offerta

OpenRTB Protobuf

OpenRTB JSON

Risposte all'offerta di esempio

OpenRTB Protobuf

OpenRTB JSON