Questa pagina è stata tradotta dall'API Cloud Translation.

Crea la risposta

Dopo che l'applicazione ha elaborato la richiesta di offerta da parte di Google, deve generare e inviare una risposta. Questa guida spiega come programmare la tua applicazione per creare la risposta.

Crea messaggio di risposta all'offerta

Authorized Buyers invia BidRequest come corpo del messaggio un POST HTTP. La risposta inviata dall'applicazione deve avere intestazione Content-Type impostata su application/octet-stream e un corpo del messaggio composto da un buffer di protocollo serializzato. Il protocollo buffer è un messaggio BidResponse come definito in realtime-bidding.proto. L'applicazione deve restituire una analisi BidResponse in risposta ogni BidRequest. Timeout. Le risposte che non possono essere analizzate sono considerate errori e limitazioni di Google gli offerenti con un tasso di errore elevato.

Se non vuoi fare offerte su un'impressione, puoi impostare il processing_time_ms campo solo e lascia tutti gli altri campi vuoto. Puoi ottenere realtime-bidding.proto dal pagina dati di riferimento.

ID creatività

Il BidResponse specifica una creatività tramite Campo buyer_creative_id (limite di 64 byte). Anche creatività simili devono avere valori univoci per buyer_creative_id se differiscono in caratteristiche degne di nota, inclusi, a titolo esemplificativo: dimensione, URL dichiarato, attributi delle creatività e tipi di fornitori. In altre parole, devi assegnare valori diversi ID creatività a due annunci che:

Hanno un aspetto o un comportamento diverso.
Esegui il rendering su immagini diverse.
Esegui il rendering con mezzi diversi (ad esempio, un annuncio è costituito da un'immagine, mentre l'altro contiene Flash).

Durante la progettazione dell'applicazione, devi decidere un modo sistematico generando identificatori significativi per i tipi di creatività che intendi per l'invio.

Attributi annuncio

Devi dichiarare gli attributi della creatività che descrivono in modo completo caratteristiche e il relativo targeting in BidResponse.Ad.attribute. La che devono essere dichiarati (vedi anche l'elenco completo dei attributi in buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
L'annuncio contiene un pixel o un beacon web allo scopo di creare un elenco di ID cookie per il successivo remarketing.
8 Remarketing: IsRemarketing
L'annuncio ha come target i consumatori in base al loro ID cookie o ID dispositivo, dove l'elenco di ID cookie o ID dispositivo rappresenta un insieme di consumatori che in precedenza hanno interagito con un sito di proprietà o rappresentato dall'acquirente.
9 UserInterestTargeting: IsUserInterestTargeted
L'annuncio ha come target i consumatori in base al loro ID cookie o ID dispositivo, dove l'elenco di ID cookie o ID dispositivo rappresenta un insieme di consumatori che l'acquirente definito come gruppo di interesse comune.
30 InstreamVastVideoType: Vpaid
Per eseguire il rendering dell'annuncio è necessario il supporto di VPAID.
32 MraidType: MRAID
Per il rendering dell'annuncio è necessaria l'API MRAID.

Inoltre, sono supportati i seguenti attributi, ma la relativa dichiarazione è non è obbligatorio, perché Authorized Buyers rileva automaticamente questi elementi e li blocca (o consentire) le tue creatività in base ai valori rilevati, anziché alla tua dichiarazione. Consulta API Creatives per ricevere spiegazioni su come ricevere feedback sulle proprietà rilevate del tuo creatività.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Per eseguire il rendering dell'annuncio è necessario il supporto Flash.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
L'annuncio non richiede Flash per il rendering.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
L'annuncio può essere visualizzato su una pagina SSL. Tieni presente che Authorized Buyers tratta le creatività con valori dichiarati diversi di questo attributo come distinti (verranno esaminati separatamente e hanno uno stato di approvazione distinto). Pertanto, se fai offerte sia con SSL versioni non SSL della stessa creatività, devi dichiarare questo attributo di conseguenza, in modo che questa distinzione si rifletta correttamente in AdX.

Campi di Open Bidding

Risposte all'offerta inviate dagli offerenti della piattaforma di scambio e della rete che partecipano a Open Le offerte sono simili a quelle degli utenti Authorized Buyers che partecipano al programma offerte in tempo reale. I clienti di Open Bidding possono specificare un numero limitato di campi aggiuntivi e alcuni campi esistenti potrebbero avere usi alternativi. Questi include:

OpenRTB	Authorized Buyers	Dettagli
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	L'ID deal dallo spazio dei nomi della piattaforma di scambio associato a questo l'offerta e riferito ai publisher. Nota: al momento questo campo viene inviato solo alla versione beta chiusa partecipanti.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Il tipo di deal segnalato ai publisher, che influisce sulle relative modalità trattati nell'asta. Nota: al momento questo campo viene inviato solo alla versione beta chiusa partecipanti.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Token utilizzato per identificare le informazioni sull'acquirente finale di terze parti se come Open Bidding è un intermediario. Si ottiene all'acquirente terzo e deve essere trasmessa a Google inalterata nell'offerta la risposta corretta.

Consigli

Abilita connessioni HTTPS permanenti (note anche come "keep-alive" o "riutilizzo della connessione") sui tuoi server. Imposta il timeout su 10 secondi alle minimo: in molti casi i valori più alti sono vantaggiosi. Google verifica durante i test iniziali della latenza dell'applicazione, perché Authorized Buyers invia le richieste con frequenza elevata e deve evitare di latenza creando una connessione TCP separata per ogni richiesta.
Includi l'URL di monitoraggio delle impressioni facoltativo per monitorare quando viene mostrata l'impressione anziché quando vince l'offerente. A causa dell'abbandono tra vincite e rendering, ciò consente un monitoraggio più accurato statistiche.

Nota: quando utilizzi OpenRTB 2.5 o versioni successive, il campo standard per questo è BidResponse.seatbid[].bid[].burl.
Mantieni il codice dello strumento di offerta privo di dipendenze nei campi ritirati e questo può causare errori nelle offerte.
Includi BidResponse.Ad.width e BidResponse.Ad.height nel tuo BidResponse. R BidResponse a una richiesta che include più dimensioni dell'annuncio deve includi i valori width e height, altrimenti sono stati esclusi dall'asta.
Limita le dimensioni della risposta a meno di 8K. Le risposte molto grandi possono aumentare latenza di rete e causare timeout.
Segui le linee guida per Offerte per l'inventario iOS che richiedono l'attribuzione SKAdNetwork.

Esempio di risposta all'offerta

I seguenti esempi rappresentano campioni leggibili di Protobuf e richieste JSON.

Google

Mostrami l'esempio

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

JSON OpenRTB

Mostrami l'esempio

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Protobuf OpenRTB

Mostrami l'esempio

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Importante: i messaggi Protobuf raffigurati negli esempi sono rappresentati qui come testo leggibile. Tuttavia, non è così i messaggi vengono inviati via cavo. Quando si utilizza il protocollo Google o OpenRTB Protobuf , verranno accettati solo messaggi BidResponse serializzati.

Puoi creare e serializzare un messaggio BidResponse utilizzando il metodo seguente codice C++:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Specifica creatività

La risposta all'offerta specifica la creatività da pubblicare se l'offerta si aggiudica l'asta. La tua offerta Deve includere uno dei formati di annunci supportati (AMP, video, nativo). In questo esempio, specifichiamo la creatività utilizzando il campo html_snippet.

In alternativa, puoi specificare la creatività utilizzando uno dei seguenti campi, in base al formato dell'annuncio:

Annuncio con rendering SDK
- BidResponse.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url o
- BidResponse.Ad.video_vast_xml
Nativi
- BidResponse.Ad.native_ad

Specifica un annuncio ospitato sui tuoi server utilizzando uno snippet HTML in il campo html_snippet di BidResponse. La è racchiuso in un iframe inserito nella pagina web, generando così un annuncio il recupero e il rendering della pagina. Devi creare il codice HTML in modo che l'annuncio (banner o interstitial) venga visualizzato correttamente all'interno di uno e con dimensioni appropriate per l'area annuncio per cui fai offerte.

Inoltre, le dimensioni dell'annuncio dichiarate nella risposta all'offerta devono corrispondere esattamente a uno. delle combinazioni di dimensioni nella richiesta di offerta quando:

Un annuncio è un banner normale (non video, nativo o interstitial).
L'offerente ha dichiarato le dimensioni nella risposta all'offerta. La dichiarazione relativa alle dimensioni è necessaria quando nella richiesta è presente più di una dimensione.
Fanno eccezione gli annunci interstitial. Per interstitial con larghezza deve essere almeno il 50% della larghezza dello schermo e l'altezza almeno fino al 40% l'altezza dello schermo.

Il campo html_snippet supporta qualsiasi codice HTML valido che il rendering sia eseguito correttamente, ma tieni presenti le restrizioni sulla specifica buyer_creative_id nella sezione Crea messaggio di risposta all'offerta. Uno. a questo scopo è inserire informazioni aggiuntive negli argomenti degli URL che sono recuperate dai server durante il rendering dell'annuncio. Ciò ti consente di passare di dati arbitrari sull'impressione ai tuoi server.

La maggior parte delle norme per gli snippet HTML restituiti nelle risposte all'offerta è la stessa della per gli annunci di terze parti. Consulta la pagina Authorized Buyers Linee guida del programma, Requisiti per terze parti pubblicazione di annunci e dichiarare gli URL di clickthrough negli annunci per saperne di più.

Specifica le macro

Lo snippet HTML che definisce una creatività può includere una o più costrutti chiamati macro. Al momento della pubblicazione degli annunci, i valori vengono sostituiti . Ad esempio, la tua applicazione di offerta client potrebbe utilizzare Macro WINNING_PRICE per determinare quanto ha pagato per l'annuncio, se vince l'asta. Per analizzare questa macro, devi implementare una funzione un'applicazione che decripta le conferme dei prezzi. Consulta la sezione Decrittografia dei prezzi Conferma per ulteriori informazioni.

Specifica una macro come parte di uno snippet HTML nel formato %%MACRO%%, dove MACRO è uno dei formati supportati elencate nella tabella sottostante.

Nota: solo per le risposte alle offerte per annunci AMP (amp_ad_url) Le macro WINNING_PRICE e WINNING_PRICE_ESC sono supportati.

Google richiede l'utilizzo dell'CLICK_URL_UNESC o Macro CLICK_URL_ESC nella creatività dell'annuncio pubblicato da terze parti annuncio. Google utilizza le macro CLICK_URL per il monitoraggio dei clic.

Per utilizzare una macro, includila nell'annuncio in modo che l'URL venga recuperato quando qualcuno vi fa clic sopra. Il valore restituito del recupero è un reindirizzamento a un altro URL che aggiungi a CLICK_URL.

Macro	Descrizione
`ADVERTISING_IDENTIFIER`	Consente agli acquirenti di ricevere un IDFA per iOS o un ID pubblicità di Android al momento del rendering delle impressioni. Consulta Decriptare gli identificatori degli inserzionisti. per maggiori dettagli.
`CACHEBUSTER`	Una rappresentazione stringa di un numero intero a quattro byte casuale, senza segno.
`CLICK_URL_UNESC`	L'URL di clic senza caratteri di escape dell'annuncio. Nello snippet, una versione l'URL di clic di terze parti deve seguire direttamente la macro. Ad esempio, se l'URL dei clic di terze parti è `http://my.adserver.com/some/path/handleclick?click=clk`, il seguente codice può essere utilizzato con la versione con escape singolo del terzo l'URL di clic di parte successivo alla chiamata della macro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Al momento della pubblicazione degli annunci, questo viene esteso a: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> L'URL registra prima il clic con Google, quindi reindirizza all'URL di clic di terze parti.
`CLICK_URL_ESC`	L'URL di clic con caratteri di escape dell'annuncio. Da utilizzare al posto di `CLICK_URL_UNESC` se devi prima trasmettere il valore tramite a un altro server che restituirà un reindirizzamento. Ad esempio, in uno snippet HTML potrebbe essere utilizzato il seguente codice: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Al momento della pubblicazione degli annunci, questo viene esteso a: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> In questo modo il clic verrà registrato con `my.adserver.com` sarà poi responsabile del reindirizzamento all'URL trasmesso nella `google_click_url`. Questo presuppone che `my.adserver.com` elimina la sequenza di escape `google_click_url` . Puoi aggiungere un URL con doppio escape dopo `%%CLICK_URL_ESC%%`. Dopo aver annullato i caratteri di escape `my.adserver.com`, lascia una versione dell'URL con escape singolo aggiunto al `google_click_url`. Quando Il campo `google_click_url` viene recuperato, verrà di nuovo eliminato la sequenza di escape e poi reindirizzamento.
`CLICK_URL_ESC_ESC`	L'URL con doppio escape dell'annuncio. Da utilizzare al posto di `CLICK_URL_UNESC` se devi prima trasmettere il valore tramite a un altro server che restituirà un reindirizzamento. Ad esempio, in uno snippet HTML potrebbe essere utilizzato il seguente codice: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Al momento della pubblicazione degli annunci, questo viene esteso a: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	Espanso a `http:` se la richiesta di offerta non richiede SSL oppure a `https:` se la richiesta di offerta richiede SSL.
`SITE`	Il dominio con caratteri di escape dell'URL di contenuti o l'ID anonimo per l'inventario anonimo.
`SITE_URL`	Deprecato. Sostituita dalla macro SITE che fornisce le stesse funzionalità.
`TZ_OFFSET`	La differenza con il fuso orario.
`VERIFICATION`	I diversi valori relativi alla produzione e al momento in cui la creatività viene analizzata nella verifica una pipeline o un blocco note personalizzato. Il formato è: `%%?VERIFICATION:true-val:false-val%%` dove qualsiasi i valori eccetto le macro possono essere utilizzati per `true-val` e `false-val`, incluse le stringhe vuote. Per Open Bidding, consigliamo alle piattaforme di scambio pubblicitario di utilizzare questa macro; dopo averlo fatto, le Demand-Side Platform non dovranno apportare modifiche. Ad esempio, se una creatività dovesse includere `%%?VERIFICATION:-1:5000%%` la sostituzione del testo sarà `5000` per la pubblicazione e `-1` nel pipeline di verifica. Ciò consente di distinguere tra questi due insiemi di ping.
`WINNING_PRICE`	Il costo delle impressioni codificato (ovvero CPI anziché CPM) relativo a micro della valuta dell'account. Ad esempio, un CPM vincente di 5 $ corrisponde a un CPM di 5.000.000 di micro o un CPI di 5000 micro. Lo strumento decodificato il valore di `WINNING_PRICE` in questo caso è 5000. Il prezzo vincente è specificato in CPI.
`WINNING_PRICE_ESC`	`WINNING_PRICE` con URL con caratteri di escape.

L'utilizzo di caratteri di escape nelle macro utilizza il seguente schema:

Il carattere spazio viene sostituito da un segno più (+).
I caratteri alfanumerici (0-9, a-z, A-Z) e i caratteri dell'insieme !()*,-./:_~ rimangono invariati.
Tutti gli altri caratteri vengono sostituiti da %XX, dove XX è il valore esadecimale numero che rappresenta il carattere.

Limitazioni per i publisher

I publisher utilizzano BidRequest per ignorare le limitazioni relative a quali annunci consentito. Devi applicare le limitazioni in questi campi:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Un campo specifica le funzionalità consentite dell'annuncio, mentre l'altro specifica elementi non consentiti. Non restituire mai un annuncio con una funzione non consentita. Per consentiti come il tipo di fornitore, restituiscono un annuncio solo se il tipo di fornitore è nel Elenco allowed_vendor_type in BidRequest. Consulta le commenti per questi campi nel buffer di protocollo BidRequest definizione per ulteriori dettagli.

Se uno snippet HTML viene restituito in BidResponse, necessaria per impostare con precisione attribute, category, e click_through_url nel campo BidResponse. Se un annuncio ha più valori applicabili per questi campi, è necessario includi ogni valore. Vedi i commenti per questi campi nella Definizione del buffer di protocollo BidResponse per ulteriori dettagli. Le risposte per cui non sono impostati questi campi vengono ignorate.

I valori possibili di BidRequest.excluded_attribute sono (consulta publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Gli annunci non sono consentiti se contengono un pixel o un beacon web allo scopo di creare un elenco di ID cookie per il successivo remarketing.
8 CookieTargeting: IsCookieTargeted
Gli annunci non sono consentiti se si rivolgono ai consumatori in base al loro ID cookie, dove l'elenco degli ID cookie rappresenta un insieme di consumatori che in precedenza interagivano con un sito di proprietà o rappresentato dall'acquirente.
9 UserInterestTargeting: IsUserInterestTargeted
Gli annunci non sono consentiti se si rivolgono ai consumatori in base al loro ID cookie, dove l'elenco degli ID cookie rappresenta un insieme di consumatori definiti dall'acquirente come gruppo di interesse comune.
21 CreativeType: Html
Gli annunci non possono utilizzare html_snippet o snippet_template in BidResponse.Ad.
22 CreativeType: VastVideo
Gli annunci non possono utilizzare il campo video_url in BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
Il rendering degli annunci non è consentito richiedere il supporto VPAID.
32 MraidType: MRAID
Gli annunci non possono richiedere l'API MRAID per il rendering.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
La visualizzazione degli annunci non è consentita.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Gli annunci non sono autorizzati a richiedere funzionalità HTML5 per il rendering.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Gli annunci non possono effettuare richieste non SSL.

Pertanto, se il campo excluded_attribute contiene il valore 7, non devi restituire un annuncio che utilizza un pixel o un beacon web per creando un elenco. Se per un annuncio viene eseguita questa operazione, è necessario impostare il valore 7 in il campo attributo di BidResponse. In modo simile, se il campo excluded_attribute contiene il valore 48, devi restituire solo annunci che possono essere visualizzati su una pagina SSL (e, di conseguenza, dichiara l'attributo 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Anche il campo excluded_sensitive_category nella BidRequest utilizza i codici del ad-sensitive-categories.txt disponibile nella pagina Dati di riferimento. Ecco le estensioni descrizioni di alcuni di questi codici:

3 Politics
Include politiche o questioni sociali controverse; non include annunci per agenzie di stampa generalmente non considerate di parte.
4 Dating
Sono inclusi i servizi di incontri e le community di incontri online.
5 Religion
Include annunci di argomento religioso e annunci che promuovono o condannano orientamenti religiosi; non include l'astrologia o spiritualità non confessionali.
7 Video Games (Casual & Online)
Include videogiochi, giochi online e giochi scaricabili; non include le console per videogiochi.
8 Ringtones & Downloadables
Componenti aggiuntivi per dispositivi mobili, tra cui suonerie, nonché altri componenti aggiuntivi scaricabili, come salvaschermo e sfondi per computer, nonché immagini e layout di profili per social network.
10 Get Rich Quick
Schemi che promettono rapidi utili.
18 Weight Loss
Include regimi dimagranti, diete ipocaloriche, programmi e prodotti correlati; non include annunci relativi alla sana alimentazione e al benessere generale.
19 Cosmetic Procedures & Body Modification
Sono inclusi lifting, suzioni, interventi con il laser, depilazione e interventi per la ricrescita dei capelli, tatuaggi e interventi di chirurgia plastica.
23 Drugs & Supplements:
Include prodotti farmaceutici, vitamine, integratori e rivenditori correlati; non include risorse che forniscono informazioni sui farmaci.
24 Sexual & Reproductive Health
Include annunci sulle funzioni sessuali e sulla fertilità; non include le normali risorse per la gravidanza.
35 Social Casino Games
Include giochi e scommesse simulati (inclusi, senza alcuna limitazione, poker, slot machine, bingo, lotterie, scommesse sportive, scommesse sulle corse, nonché altri giochi di carte e giochi da casinò) in cui non è possibile vincere beni di valore (come denaro o premi).
36 Significant Skin Exposure
Immagini degli annunci in cui qualsiasi parte del corpo umano, dallo sterno fino a metà coscia, non è vestita; Il corpo è vestito con biancheria intima, costumi da bagno, lingerie o altri indumenti trasparenti oppure con oggetti non di abbigliamento, come un asciugamano o lenzuolo.
37 Sensationalism
Annunci il cui scopo è indurre gli utenti a fare clic su di essi attirando la loro curiosità, spesso con messaggi teaser che utilizzano immagini o linguaggio iperbolico. Sono inclusi gli annunci incentrati su argomenti sensazionalistici (come l'arresto, la morte o il divorzio di celebrità) o con contenuti potenzialmente scioccanti.

Open Measurement

Con Open Measurement puoi specificare i fornitori di terze parti che forniscono misurazioni e strumenti di misurazione indipendenti servizi di verifica per gli annunci pubblicati in ambienti di app mobile.

I formati degli annunci attualmente supportati includono annunci video, banner e interstitial. Per ulteriori informazioni su come utilizzare Open Measurement in una risposta all'offerta contenente questi formati, consulta il Centro assistenza SDK Open Measurement .

Esempi di risposte alle offerte

Le seguenti sezioni mostrano esempi di risposte alle offerte per diversi tipi di annunci.

Google

Mostrami l'esempio

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

JSON OpenRTB

Mostrami l'esempio

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Protobuf OpenRTB

Mostrami l'esempio

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

Interstitial per app

Google

Mostrami l'esempio

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

JSON OpenRTB

Mostrami l'esempio

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Protobuf OpenRTB

Mostrami l'esempio

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

Video interstitial per app

Google

Mostrami l'esempio

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Protobuf OpenRTB

Mostrami l'esempio

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Nativo dell'app

Google

Mostrami l'esempio

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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\254106.40"
    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"
}
processing_time_ms: 20

JSON OpenRTB

Mostrami l'esempio

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Protobuf OpenRTB

Mostrami l'esempio

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      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"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

Video sul Web

Google

Mostrami l'esempio

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Protobuf OpenRTB

Mostrami l'esempio

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Crea la risposta

Crea messaggio di risposta all'offerta

ID creatività

Attributi annuncio

Campi di Open Bidding

Consigli

Esempio di risposta all'offerta

Google

Mostrami l'esempio

JSON OpenRTB

Mostrami l'esempio

Protobuf OpenRTB

Mostrami l'esempio

Specifica creatività

Specifica le macro

Limitazioni per i publisher

Open Measurement

Esempi di risposte alle offerte

Banner app

Google

Mostrami l'esempio

JSON OpenRTB

Mostrami l'esempio

Protobuf OpenRTB

Mostrami l'esempio

Interstitial per app

Google

Mostrami l'esempio

JSON OpenRTB

Mostrami l'esempio

Protobuf OpenRTB

Mostrami l'esempio

Video interstitial per app

Google

Mostrami l'esempio

Protobuf OpenRTB

Mostrami l'esempio

Nativo dell'app

Google

Mostrami l'esempio

JSON OpenRTB

Mostrami l'esempio

Protobuf OpenRTB

Mostrami l'esempio

Video sul Web

Google

Mostrami l'esempio

Banner web mobile per lo strumento di offerta della piattaforma di scambio pubblicitario

Protobuf OpenRTB

Mostrami l'esempio