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 degli annunci nativi è disponibile nelle app mobile, nonché nei siti web per computer e dispositivi mobili. Per ulteriori informazioni sugli annunci nativi, consulta la 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 annunci nativi, ciascuno dei quali specifica i campi nativi preferiti.
  2. Google invia agli acquirenti una richiesta di offerta RTB che contiene 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 li personalizza in base 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 sono diversi rispetto alle 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 Protobuf di OpenRTB sono messaggi Protobuf anziché stringhe.

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

Se utilizzi un SDK per gli acquirenti per visualizzare gli 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 di OpenRTB o di NativeAdTemplate del protocollo Google RTB ritirato 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 contrassegnati come Obbligatorio o Consigliato. Valgono le seguenti regole:

  • I campi contrassegnati come Obbligatorio sono obbligatori per l'offerente.
  • I campi contrassegnati come Consigliati non sono obbligatori per l'offerente e il editore può decidere se mostrarli o meno, se forniti (ad es. la valutazione a stelle).
  • L'invito all'azione (CTA) è sempre contrassegnato come Consigliato perché viene assegnata un'impostazione predefinita se non viene inviata dall'offerente, ma verrà sempre visualizzata se inviata.

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

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzata? 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 dal publisher. <Uno screenshot del gioco Flood-It!>
Corpo Testo principale dell'app Obbligatorio No 90 caratteri Apparentemente semplice e allo stesso tempo stimolante = incredibilmente 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 rappresentano la valutazione dell'app nell'app store Consigliato No 0 - 5 4,5
Prezzo Il costo dell'app Consigliato No 15 caratteri Gratis

Note sulla lunghezza del testo

Se un acquirente invia un asset di testo (ad es. il testo del corpo) più lungo del numero massimo di caratteri suggerito, il testo potrebbe essere troncato e aggiungere puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per le lingue cinese, giapponese e 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 sono autorizzati a:

  • Ritaglia l'immagine principale simmetricamente fino al 20% in una dimensione (altezza o larghezza).
  • Modificare le dimensioni dell'immagine senza modificarne le proporzioni.
  • Le immagini con proporzioni notevolmente diverse da quelle implicite per altezza e 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 visualizzata? Dimensioni consigliate delle immagini/numero massimo di caratteri * Esempio
Titolo L'intestazione dell'annuncio Obbligatorio Sì 25 caratteri I tassi di mutuo più bassi
Immagine L'immagine principale dell'annuncio Obbligatorio No 1200 x 627 px o 600 x 600 px,a seconda delle proporzioni richieste dal publisher. <Immagine principale dell'annuncio>
Corpo Il contenuto dell'annuncio Obbligatorio No 90 caratteri La tua casa a Brooklyn, più economica e prima di quanto pensi.
Logo Logo dell'inserzionista o un'altra immagine piccola pertinente Consigliato No 128 x 128 px <Logo di NY Mortgage Inc.>
Call to action Azione preferita dall'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 visualizzata? 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 a un file VAST XML contenente un'esperienza Flood-It! Annuncio video
Titolo Il titolo dell'app Obbligatorio Sì 25 caratteri Flood-It!
Immagine L'immagine (miniatura) mostrata nel video 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! In alternativa, dal video
Corpo Testo principale dell'app Obbligatorio No 90 caratteri Apparentemente semplice e allo stesso tempo stimolante = incredibilmente 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 rappresentano la valutazione dell'app nell'app store Consigliato No 0 - 5 4,5
Prezzo Il costo dell'app Consigliato No 15 caratteri Gratis

Restrizioni

  • Video: tutti i video devono essere sotto forma di URL VAST o di 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 aggiungere puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per le lingue cinese, giapponese e coreano. Ad esempio, il limite per i titoli è pari a 90 in inglese e a 45 per il cinese.

  • Dimensioni delle immagini: i publisher possono:

    • Ritaglia l'immagine principale in modo simmetrico fino al 20% in una dimensione (altezza o larghezza).
    • Modificare le dimensioni dell'immagine senza modificarne le proporzioni.

Esempio di annuncio per l'installazione di app

(annuncio) nativo video

Modello di annuncio di contenuti video

Campo Descrizione Obbligatorio o consigliato? Sempre visualizzata? 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 a un file VAST XML contenente un'esperienza Flood-It! Annuncio video
Titolo L'intestazione dell'annuncio Obbligatorio Sì 25 caratteri I tassi di mutuo più bassi
Immagine L'immagine (miniatura) mostrata nel video 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 prima di quanto pensi.
Logo Logo dell'inserzionista o un'altra immagine piccola pertinente Consigliato No 128 x 128 px Logo di NY Mortgage Inc.
Call to action Azione preferita dall'utente Obbligatorio No 15 caratteri Richiedi un preventivo
Inserzionista Testo che identifica l'inserzionista o il brand Obbligatorio No 25 caratteri NY Mortgage Inc.

Campi meta

I seguenti metacampi sono condivisi da tutti i modelli di annunci supportati:

Protocollo RTB di Google Equivalente OpenRTB Descrizione
NativeAd.click_link_url Link.url L'URL che verrà chiamato dal browser quando l'utente fa clic sull'annuncio. Può essere il primo passaggio di una catena di reindirizzamenti che porta alla pagina di destinazione. Per gli annunci nativi, ti consigliamo di utilizzare click_link_url come campo per impostare la destinazione finale dell'utente. L'utilizzo di questo campo è obbligatorio nel caso di pagine di destinazione dinamiche.
Ad.click_through_url Bid.adomain

Deve essere impostato se l'offerente intende fare un'offerta. Si tratta dell'insieme degli URL di destinazione per lo snippet, inclusi gli URL a cui l'utente viene indirizzato se fa clic sull'annuncio visualizzato e tutti gli URL visibili nell'annuncio visualizzato. Non includere chiamate intermedie all'ad server non correlate alla pagina di destinazione finale. Un BidResponse che restituisce uno snippet o un annuncio video ma non dichiara click_through_url verrà ignorato. Imposta questo campo solo se sono impostati html_snippet, video_url o native_ad. Questi dati vengono utilizzati come dichiarazione dell'URL di destinazione, ad esempio per il post-filtro degli URL bloccati dal publisher o la classificazione degli annunci. Consulta NativeAd.click_link_url quando utilizzi gli annunci nativi.

Per gli annunci non nativi, non viene utilizzato per il monitoraggio dei clic o per qualsiasi altra funzionalità dell'annuncio; viene utilizzato solo come dichiarazione dell'URL di destinazione.

Per gli annunci nativi, se NativeAd.click_link_url non è impostato, viene utilizzato il primo valore di click_through_url per indirizzare l'utente alla pagina di destinazione. Inoltre, tutti i valori vengono utilizzati come dichiarazioni di URL di destinazione (in modo simile al caso non nativo).
NativeAd.click_tracking_urls Link.clicktrackers Facoltativo. URL aggiuntivi che consentono agli inserzionisti di monitorare i clic degli utenti sull'annuncio.
Ad.ad_choices_destination_url BidExt.ad_choices_destination_url Link a una pagina di disattivazione o delle preferenze relative agli annunci. Se presente, alla creatività nativa viene aggiunta un'icona Scegli Tu! standard che viene collegata a questo URL. Questa funzionalità è supportata per gli annunci nativi, ma non fa parte del messaggio nativo nella risposta all'offerta.
Ad.impression_tracking_url NativeResponse.imptrackers L'impressione nativa deve essere monitorata con impression_tracking_url nel protocollo delle offerte in tempo reale di Authorized Buyers o con gli imptracker nativi in OpenRTB.

required_fields e recommended_fields sono specificati dall'editore. Ti mostriamo come tradurre questi campi di bit per determinare se un campo è obbligatorio o consigliato.

Un campo di bit utilizza ogni bit di un valore binario per memorizzare un'istruzione true o false, equivalente all'invio di molti indicatori booleani come is_logo_required o is_header_required, ma tutti imballati insieme.

Esempio

Per questo esempio utilizzeremo un valore required_fields di 1085.

Innanzitutto, trova il valore binario equivalente: 10000111101

Una volta ottenuto il valore binario, puoi controllare i bit per verificare se un campo è obbligatorio (1) o facoltativo (0).

La seguente tabella mappa i campi alla loro posizione nel valore binario. Leggi il valore binario da destra a sinistra, con il bit 1 corrispondente alla posizione più a destra nel valore binario.

Campo Posizionamento del valore binario (da destra a sinistra)
HEADLINE 1
BODY 2
CALL_TO_ACTION 4
ADVERTISER 8
IMAGE 16
LOGO 32
APP_ICON 64
STAR_RATING 128
PRICE 256
STORE 512
VIDEO 1024

Se osserviamo il valore binario di esempio 10000111101, il bit 1 (all'estrema destra) è 1, che indica un valore obbligatorio. In base alla tabella, il bit 1 corrisponde a HEADLINE.

Il valore di 2 bit (secondo valore da destra) è 0, il che significa che non è obbligatorio. Il 2-bit corrisponde a BODY.

Di seguito sono riportati tutti i campi obbligatori interpretati nel nostro esempio:

Valore Descrizione Obbligatorio?
1 VIDEO Sì
0 STORE No
0 PRICE No
0 STAR_RATING No
0 APP_ICON No
1 LOGO Sì
1 IMAGE Sì
1 ADVERTISER Sì
1 CALL_TO_ACTION Sì
0 BODY No
1 HEADLINE Sì

Rappresentazione del modello di annuncio nativo nella richiesta di offerta

Quando ricevi una richiesta di offerta contenente inventario nativo, il modello di annuncio nativo sarà presente in forme diverse a seconda del protocollo utilizzato. Ti consigliamo di utilizzare OpenRTB perché il protocollo Google è deprecato.

In OpenRTB, il modello di annuncio nativo è descritto con il messaggio NativeRequest. Nel protocollo Google RTB, è descritto con NativeAdTemplate. Questi messaggi forniscono i seguenti dettagli sull'inventario degli annunci nativi:

  • Campi obbligatori o consigliati.
  • Dimensioni di immagini, loghi e icone di app.
  • Specifiche dello stile in cui viene visualizzato l'annuncio.

ID risorsa OpenRTB

OpenRTB passa un array di asset nella richiesta di offerta che descrivono la struttura dell'annuncio nativo da restituire nella risposta. Ogni asset nella richiesta avrà un ID che deve essere specificato per l'asset corrispondente nella risposta. Per un esempio di come questi ID corrispondono tra la richiesta e la risposta, consulta l'esempio di richiesta di offerta nativa e l'esempio di risposta di offerta nativa.

Rappresentazione di un annuncio nativo nella risposta all'offerta

Quando fa offerte per l'inventario nativo, un acquirente deve compilare i campi obbligatori identificati nella richiesta di offerta. In OpenRTB, puoi farlo con BidResponse.seatbid.bid.adm_native se utilizzi Protobuf o BidResponse.seatbid.bid.adm per JSON. Per il protocollo Google ritirato, questa operazione viene eseguita con il campo BidResponse.ad.native_ad.

Esempi di richieste di offerta

Richieste di offerta non video

Protobuf OpenRTBJSON OpenRTBGoogle
Richiesta serializzata
id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    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
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}
 
{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"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,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}
Richiesta serializzata
id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Richieste di offerta video

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

Risposte all'offerta di esempio

Risposte all'offerta non video

OpenRTB ProtobufJSON OpenRTBGoogle
Risposta serializzata
id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"
 
{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "adm": "{\"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\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}
Risposta serializzata
ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254 225"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

Risposte all'offerta video

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}