Annunci HTML AMP su RTB

In questa pagina viene descritto come iniziare a utilizzare gli annunci HTML AMP con RTB. Consulta le risorse qui sotto per ulteriori informazioni sugli annunci e sugli strumenti HTML AMP che ti aiutano a iniziare.

Approccio generale

Richiesta di offerta RTB

La richiesta di offerta RTB indica se la richiesta proviene da una pagina AMP e i requisiti per gli annunci HTML AMP.

OpenRTB

pagina AMP

message SiteExt {
  enum AmpPage {
    // This is not an AMP page.
    DIALECT_HTML = 0;

    // This is an Amp page.
    DIALECT_HTML_AMP = 1;
  }

  // Whether this is an AMP page or not. Omitted if unknown.
  optional AmpPage amp = 1;
  enum VisibilityState {
    VISIBILITY_STATE_UNKNOWN = 0;

    // The page is at least partially visible. For example, in the foreground
    // tab of a non-minimized window.
    VISIBILITY_STATE_VISIBLE = 1;

    // The page is not visible to users. For example, when the page is in a
    // background browser tab, or in a minimized window.
    VISIBILITY_STATE_HIDDEN = 2;
  }

  // The visibility state of the web page containing the ad slot.
  // See https://www.w3.org/TR/page-visibility/.
  // [AdX: BidRequest.page_visibility]
  optional VisibilityState page_visibility = 2 [default =
    VISIBILITY_STATE_UNKNOWN];

  // Information about a browser window's user activation state. See
  // https://html.spec.whatwg.org/multipage/interaction.html#the-useractivation-interface.
  message UserActivation {
    // Indicates whether a user has completed an interaction since page load.
    optional bool wasact = 1;

    // Indicates whether a user is currently interacting with the page.
    optional bool isact = 2;
  }

  // User activation information from the browser for the current request, if
  // the request is for a web page.
  optional UserActivation uact = 5;

  // The set of possible web navigation types that predicate a page load. Each
  // of these types may have different performance characteristics. For example,
  // users going back and forth might experience a faster site than users
  // performing navigation for the first time or submitting forms. See
  // https://w3c.github.io/navigation-timing/#dom-performancenavigationtiming-type.
  enum NavigationType {
    NAVIGATION_TYPE_UNKNOWN = 0;

    // Navigation started by clicking a link, entering the URL in the browser's
    // address bar, form submission, or initializing through a script operation
    // other than reload and back_forward.
    NAVIGATION_TYPE_NAVIGATE = 1;

    // Navigation is through the browser's reload operation, location.reload(),
    // or a Refresh pragma directive like
    // <meta http-equiv="refresh" content="300">.
    NAVIGATION_TYPE_RELOAD = 2;

    // Navigation is through the browser's history traversal operation.
    NAVIGATION_TYPE_BACK_FORWARD = 3;

    // Navigation is initiated by a prerender hint (deprecated). See
    // https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/prerender.
    NAVIGATION_TYPE_PRERENDER = 4;
  }

  // The type of browser navigation that led to the current page. Unset for
  // non-web ad requests.
  optional NavigationType ntype = 6;

  // Indicates that the request is using semi-transparent branding,
  // which means only a truncated version of the request URL will
  // be provided. This decision is made by the publisher, see
  // https://support.google.com/admanager/answer/4584891#urls for context.
  optional bool is_semi_transparent_request = 3;

  // The domain of the partner (of the site owner) with ownership
  // of some portion of ad inventory on the site. The partner's ads.txt file
  // will be hosted here. More detail at
  // http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
  optional string inventorypartnerdomain = 4;
}

Requisiti degli annunci HTML AMP

// Ad Exchange extensions for the Imp object.
message ImpExt {
...
  // Possible requirement types for AMP ads.
  enum AmpAdRequirementType {
    // AMP ad requirements unknown.
    UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1;
    // AMP ads are not allowed.
    AMP_AD_NOT_ALLOWED = 2;
    // Either AMP ads or non-AMP ads are allowed;
    // AMP ads are not early rendered.
    AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3;
    // Either AMP ads or non-AMP ads are allowed;
    // AMP ads are early rendered.
    AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4;
    // AMP ads are required.
    // Ads that are non-AMP may be rejected by the publisher.
    AMP_AD_REQUIRED = 5;
    // Exchange-specific values above 500.
  }
  optional AmpAdRequirementType ampad = 8
    [default = UNKNOWN_AMP_AD_REQUIREMENT_TYPE];
}

RTB di Authorized Buyers

pagina AMP

// Whether this is an AMP page or not.
enum AmpPage {
  // AMP page status unknown.
  UNKNOWN_AMP_PAGE = 0;

Requisiti degli annunci HTML AMP

// Possible requirement types for AMP ads.
enum AmpAdRequirementType {
  // AMP ad requirements unknown.
  UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0;

Risposta all'offerta RTB

OpenRTB

In OpenRTB 3.0 e il relativo modello comune pubblicitario sono incluse diverse aggiunte per supportare gli annunci HTML AMP nelle più recenti specifiche in bozza rilasciate da IAB, tra cui le seguenti.

Offerta Campo Attr Tipo Descrizione
Richiesta Site.amp amp numero intero Il campo Site.amp indica se la pagina viene visualizzata in AMP, se non è nota:
0 = la pagina non è AMP
1 = la pagina è stata creata con HTML AMP
Richiesta ampformat rend numero intero La specifica di formato AMP indica i requisiti e il comportamento di rendering per gli annunci HTML AMP:
1 = I requisiti degli annunci AMP sono sconosciuti
2 = Gli annunci AMP non sono consentiti
3 = Sono consentiti gli annunci AMP o non AMP; gli annunci AMP non vengono sottoposti a rendering anticipato
4 = Sono consentiti gli annunci AMP o non AMP e gli annunci AMP vengono visualizzati in anticipo
5 = Sono richiesti gli annunci AMP. Gli annunci non AMP potrebbero essere rifiutati dal publisher
500+ = Valori specifici della piattaforma di scambio; devono essere comunicati agli offerenti a priori
Risposta display curl stringa Nella risposta all'offerta è stato aggiunto display.curl in modo da poter inviare creatività tramite un URL, incluso il supporto per gli annunci HTML AMP.
Questo è l'URL in cui verrà trovato il markup della creatività. Applicabile a tipi di creatività come: annunci AMP, VAST, DAAST e nativi. Solitamente, in un annuncio è valido solo uno dei due adm o curl.

RTB di Authorized Buyers

Il campo BidResponse.Ad.amp_ad_url nelle risposte all'offerta di Authorized Buyers accetta un URL che rimanda a contenuti dell'annuncio HTML AMP. Lo stesso campo esiste come estensione nell'oggetto Bid nell'implementazione OpenRTB di Google.

// The URL to fetch an AMPHTML ad. Only one of the following should be set:
// html_snippet, video_url, amp_ad_url, native_ad.
optional string amp_ad_url = 23;

Verifica di HTML AMP valido

Affinché gli annunci HTML AMP vengano visualizzati in anteprima, la piattaforma di scambio pubblicitario deve verificarli e firmarli, il che indica che l'annuncio è scritto nel formato della creatività <html amp4ads> amp4ads.

Gli annunci HTML AMP validi potranno essere visualizzati in anticipo dalle pagine AMP. Gli annunci non verificati come HTML AMP validi verranno visualizzati alla stessa velocità degli annunci non HTML AMP.

In amp_ad_url devono essere restituiti solo annunci HTML AMP.

In futuro, se un publisher richiederà solo annunci HTML AMP, gli annunci non firmati come HTML AMP non verranno visualizzati.

Con Authorized Buyers, agli offerenti vengono comunque addebitati costi se restituiscono un annuncio non HTML AMP in un'area annuncio richiesta per l'annuncio HTML AMP.

Recupero lato server

Per eseguire il rendering anticipato degli annunci HTML AMP, il contenuto dell'annuncio HTML AMP deve essere visualizzato senza richiedere hop aggiuntivi da parte del client. Questo approccio è progettato per evitare esperienze utente negative a causa della latenza degli annunci e delle chiamate lato client aggiuntive.

Dopo che un offerente vince l'asta, la piattaforma di scambio esegue una richiesta server-server per recuperare il contenuto dell'annuncio HTML AMP che si trova all'URL fornito in amp_ad_url. I server delle creatività devono rispondere e restituire i contenuti entro 300 ms.

L'annuncio HTML AMP restituito dal server delle creatività verrà inserito nell'area annuncio e successivamente visualizzato. Tieni presente che un annuncio HTML AMP valido non può contenere iframe o altri tag <amp-ad>. Per ulteriori dettagli, consulta le specifiche degli annunci HTML AMP.

Funzionalità solo beta: se ti serve, contatta il team dedicato al tuo account

Durante il recupero da server a server dell'annuncio HTML AMP (specificato in amp_ad_url), Authorized Buyers può trasmettere l'intestazione HTTP e l'IP dal browser dell'utente al server delle creatività. Questo garantisce che il server creatività riceva informazioni simili a quelle inviate da un recupero lato client standard. In alcuni casi, l'indirizzo IP può essere troncato solo ai primi 3 byte (IPv4) o ai primi 6 byte (IPv6). Contatta il team dedicato al tuo account se hai bisogno di questa funzionalità. Di seguito è riportata un'intestazione HTTP di esempio:

URL di monitoraggio delle impressioni e macro clic

Gli acquirenti RTB spesso includono il monitoraggio delle impressioni come campo strutturato nella risposta all'offerta (questo è Bid.burl, l'"URL notifica fatturazione" in OpenRTB 2.5).

Con Authorized Buyers, queste vengono attivate lato client; amp-pixel attiva gli URL di monitoraggio quando la creatività viene visualizzata. amp-analytics è in grado di gestire casi d'uso di monitoraggio più avanzati, oltre al rendering.

Gli annunci HTML AMP devono contenere una macro clic valida nel codice HTML AMP. in genere: 

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2my.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>
<a href=”https://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%”></a>

Le creatività spesso includono pixel di corrispondenza dei cookie all'interno del codice creatività. Gli annunci HTML AMP possono utilizzare i componenti amp-pixel e amp-analytics per questo caso d'uso. Se il tuo caso d'uso non può essere adattato utilizzando amp-analytics o amp-pixel, apri un problema di GitHub per discutere delle opzioni alternative. Accogliamo con favore le nuove estensioni utilizzate in modo più ampio da diverse aziende. Consulta linee guida dettagliate o una guida tecnica per creare una nuova estensione.

URL di annunci AMP di esempio per i test

Per il test puoi utilizzare il seguente contenuto dell'annuncio HTML AMP di esempio:

Risorse

Il progetto AMP e Google hanno rilasciato una serie di risorse per aiutarti a iniziare:

Creare annunci in AMP
Proposte specifiche per RTB al gruppo IAB / OpenRTB