Elabora la richiesta

Un'interazione con le offerte in tempo reale inizia quando Google invia una richiesta di offerta alla tua applicazione. Questa guida spiega come codificare l'applicazione per elaborare la richiesta di offerta.

Attenzione: il protocollo RTB di Google è deprecato. Gli esempi riportati in questa guida useranno l'implementazione di OpenRTB Protobuf di Google, se non diversamente specificato.

Analizza la richiesta protobuf

Google invia una richiesta di offerta come buffer di protocollo serializzato allegato come payload binario di una richiesta POST HTTP. L'opzione Content-Type è impostata su application/octet-stream. Per un esempio, consulta Esempio di richiesta di offerta.

Devi analizzare questa richiesta in un'istanza del messaggio BidRequest. A seconda del protocollo scelto, BidRequest è definito in openrtb.proto o nel valore deprecato realtime-bidding.proto, che può essere ottenuto dalla pagina Dati di riferimento. Puoi analizzare il messaggio utilizzando il metodo ParseFromString() nella classe generata per il BidRequest. Ad esempio, il seguente codice C++ analizza una richiesta in base a un payload POST in una stringa:

string post_payload = /* the payload from the POST request */;
BidRequest bid_request;
if (bid_request.ParseFromString(post_payload)) {
  // Process the request.
}

Una volta ottenuto il BidRequest, puoi utilizzarlo come oggetto, estraendo e interpretando i campi di cui hai bisogno. Ad esempio, in C++ l'iterazione dei deal in un "BidRequest" OpenRTB potrebbe avere il seguente aspetto:

for (const BidRequest::Imp::Pmp::Deal& deal : pmp.deals()) {
  DoSomething(deal.id(), deal.wseat());
}

ID fatturazione

Ricevi una richiesta di offerta quando l'inventario pubblicitario di un publisher è scelto come target da una o più delle tue configurazioni di pretargeting. BidRequest.imp.ext.billing_id viene compilato con gli ID fatturazione di tutti gli acquirenti idonei e con le configurazioni di pretargeting pertinenti. Inoltre, per l'inventario del deal, puoi trovare gli ID fatturazione associati all'acquirente pertinente utilizzando BidRequest.imp.pmp.deal.ext.billing_id. Quando fai un'offerta, puoi specificare solo gli ID fatturazione degli acquirenti inclusi nella richiesta di offerta.

Se nella richiesta di offerta sono inclusi più ID fatturazione, devi specificare l'ID fatturazione dell'acquirente a cui intendi attribuire l'offerta con il campoBidResponse.seatbid.bid.ext.billing_id.

File di dizionario

La richiesta di offerta utilizza gli identificatori definiti nei file di dizionario, disponibili nella pagina Dati di riferimento.

Macro URL di offerta del protocollo RTB di Google

Se vuoi, alcuni campi del BidRequest possono essere inseriti nell'URL utilizzato nella richiesta POST HTTP. Questo è utile, ad esempio, se utilizzi un frontend leggero che esegue il bilanciamento del carico su più backend utilizzando un valore della richiesta. Contatta il tuo Technical Account Manager per richiedere assistenza per le nuove macro.

Macro	Descrizione
%%GOOGLE_USER_ID%%	Sostituito con google_user_id del BidRequest. Ad esempio, l'URL dell'offerente http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% verrà sostituito da qualcosa di simile a http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl al momento della richiesta. Se l'ID utente Google non è noto, la stringa vuota viene sostituita con un risultato simile a http://google.bidder.com/path?gid=
%%HAS_MOBILE%%	Sostituito con 1 o 0 quando si chiamahas_mobile() di BidRequest.
%%HAS_VIDEO%%	Sostituito con 1 (true) o 0 (false) quando viene chiamato has_video() di BidRequest.
%%HOSTED_MATCH_DATA%%	Sostituito con il valore del campo hosted_match_data del BidRequest.
%%MOBILE_IS_APP%%	Sostituito con 1 (true) o 0 (false) dal campo mobile.is_app di BidRequest.

Trovare l'ID app mobile dall'URL transazione

Le transazioni delle applicazioni mobile registreranno URL simili al seguente:

mbappgewtimrzgyytanjyg4888888.com

Utilizza un decodificatore base 32 per decodificare la parte della stringa in grassetto (gewtimrzgyytanjyg4888888).

Puoi utilizzare un decodificatore online, ma dovrai usare le lettere maiuscole e sostituire i 8 finali con i valori =.

Pertanto, per decodificare questo valore:

GEWTIMRZGYYTANJYG4======

genera:

1-429610587

La stringa 429610587 è l'ID dell'app per l'app iOS iFunny.

Ecco un altro esempio. L'URL segnalato è:

mbappgewtgmjug4ytmmrtgm888888.com

Decodifica di questo valore:

GEWTGMJUG4YTMMRTGM======

genera:

1-314716233

Il risultato 314716233 è l'ID app per l'app iOS TextNow.

Trovare il nome dell'app mobile dall'URL della transazione

Ecco un esempio di recupero del nome dell'app. L'URL segnalato è il seguente:

mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888.com

Decodifica di questo valore:

MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q===

genera:

air.com.hypah.io.slither

Il risultato corrisponde all'app Android slither.io.

Campi Open Bidding

Le richieste di offerta inviate agli offerenti di piattaforme di scambio e reti che partecipano a Open Bidding sono simili a quelle di Authorized Buyers che partecipano alle offerte in tempo reale standard. I clienti Open Bidding riceveranno un numero limitato di campi aggiuntivi e alcuni campi esistenti potrebbero avere utilizzi alternativi. tra cui:

OpenRTB	Authorized Buyers	Dettagli
BidRequest.imp[].ext.dfp_ad_unit_code	BidRequest.adslot[].dfp_ad_unit_code	Contiene il codice di rete Ad Manager del publisher seguito dalla gerarchia delle unità pubblicitarie, separata da barre. Ad esempio, verrà visualizzato con una formattazione simile a: /1234/cruises/mars.
BidRequest.user.data[].segment[]	BidRequest.adslot[].exchange_bidding.key_value[]	Coppie chiave-valore ripetute inviate dal publisher all'offerente della piattaforma di scambio. Puoi stabilire che i valori sono coppie chiave-valore inviate dall'editore quando BidRequest.user.data[].name è impostato su “Publisher Passed”. Nota: al momento questo campo viene inviato solo ai partecipanti alla versione beta chiusa.

Dichiarare i fornitori consentiti

I fornitori di tecnologia che forniscono servizi come ricerca, remarketing e pubblicazione di annunci possono svolgere un ruolo nell'interazione tra acquirenti e venditori. Sono consentiti solo i fornitori che sono stati sottoposti a verifica da parte di Google per la partecipazione alle interazioni con Authorized Buyers.

Per comprendere il BidRequest e creare il tuo BidResponse, devi conoscere le due diverse possibilità per dichiarare i fornitori di tecnologia:

1. Alcuni fornitori non devono essere dichiarati; questi fornitori sono elencati in Fornitori esterni certificati Ad Manager.
2. Altri fornitori possono partecipare solo se sono dichiarati in BidRequest:
   • In BidRequest, il BidRequest.imp.ext.allowed_vendor_type specifica i fornitori consentiti dal venditore. I fornitori che verranno inviati nel allowed_vendor_type sono elencati nel vendors.txt file del dizionario.

Esempio di richiesta di offerta

Gli esempi riportati di seguito rappresentano esempi leggibili delle richieste Protobuf e JSON.

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "G44mF74ywRs183dKa9565D"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: BELOW_THE_FOLD
    expdir: LEFT
    expdir: RIGHT
    expdir: UP
    expdir: DOWN
    wmax: 320
    hmax: 50
    wmin: 214
    hmin: 33
    format {
      w: 320
      h: 50
    }
    format {
      w: 300
      h: 50
    }
    [com.google.doubleclick.banner_ext] {
      flexslot {
        wmin: 214
        wmax: 320
        hmin: 33
        hmax: 50
      }
    }
  }
  tagid: "3724651684"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 2.80155200016452e-05
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.14
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 61560909063
    dfp_ad_unit_code: "/2149822/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    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: "US"
    }
  }
  content {
    livestream: false
    language: "es"
  }
  mobile: true
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_HIDDEN
    inventorypartnerdomain: "OMITTED"
    uact {
      wasact: true
      isact: true
    }
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "MEX"
    region: "MX-NLE"
    zip: "67050"
    type: IP
    utcoffset: -360
    accuracy: 3447
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9143049
    }
  }
  make: "Motorola"
  model: "razr 2024"
  os: "android"
  osv: "14"
  devicetype: HIGHEND_PHONE
  lmt: false
  w: 320
  h: 783
  pxratio: 3.375
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Android WebView"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Android"
      version: "14"
      version: "0"
    }
    mobile: true
    model: "motorola razr 2024"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "7pWq9gH2c44W14G0diM896340U7"
  buyeruid: "ob9RP0311MR4X7c983o221v0B890U239"
  customdata: "77o24I2Ie6j9g1Svm1J60Nnn8zB185Bk1yBhM6i28cWp9wjb"
  [com.google.doubleclick.user] {
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
    idage: 1296000
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
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-zph5Vk-45u86x7963d1Se8v5W33W604M5WCTYJ4eH7jzh9702Y7A818s510l2vhC7tK4"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

Mostrami l'esempio

{
  "id": "G44mF74ywRs183dKa9565D",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 320,
        "h": 50,
        "pos": 3,
        "expdir": [
          1,
          2,
          3,
          4
        ],
        "wmax": 320,
        "hmax": 50,
        "wmin": 214,
        "hmin": 33,
        "format": [
          {
            "w": 320,
            "h": 50
          },
          {
            "w": 300,
            "h": 50
          }
        ],
        "ext": {
          "flexslot": {
            "wmin": 214,
            "wmax": 320,
            "hmin": 33,
            "hmax": 50
          }
        }
      },
      "tagid": "3724651684",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 2.80155200016452e-05,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.14,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "61560909063"
        ],
        "dfp_ad_unit_code": "/2149822/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test 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": "US"
      }
    },
    "content": {
      "livestream": 0,
      "language": "es"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 2,
      "inventorypartnerdomain": "OMITTED",
      "uact": {
        "wasact": 1,
        "isact": 1
      },
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "MEX",
      "region": "MX-NLE",
      "zip": "67050",
      "type": 2,
      "utcoffset": -360,
      "accuracy": 3447,
      "ext": {
        "geo_criteria_id": 9143049
      }
    },
    "make": "Motorola",
    "model": "razr 2024",
    "os": "android",
    "osv": "14",
    "devicetype": 4,
    "lmt": 0,
    "w": 320,
    "h": 783,
    "pxratio": 3.375,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Android WebView",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "14",
          "0"
        ]
      },
      "mobile": 1,
      "model": "motorola razr 2024",
      "source": 2
    }
  },
  "user": {
    "id": "7pWq9gH2c44W14G0diM896340U7",
    "buyeruid": "ob9RP0311MR4X7c983o221v0B890U239",
    "customdata": "77o24I2Ie6j9g1Svm1J60Nnn8zB185Bk1yBhM6i28cWp9wjb",
    "ext": {
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        },
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ],
      "idage": 1296000
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "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-zph5Vk-45u86x7963d1Se8v5W33W604M5WCTYJ4eH7jzh9702Y7A818s510l2vhC7tK4",
    "fcap_scope": 1
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "To1)\351\216ec%\362\220w\235\300\010\255G\020^\257\'[}"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  width: 336
  width: 300
  height: 280
  height: 250
  excluded_attribute: 70
  excluded_attribute: 16
  allowed_vendor_type: 445
  allowed_vendor_type: 704
  excluded_sensitive_category: 31
  excluded_sensitive_category: 24
  matching_ad_data {
    billing_id: 78614473201
    minimum_cpm_micros: 10000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10003
  excluded_product_category: 10017
  ad_block_key: 5501504864
  publisher_settings_list_id: 3066683014322168515
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 80
  click_through_rate: 0.001814635
  renderer: GOOGLE
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  consented_providers_settings {
    consented_providers: 1227
    consented_providers: 2140
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  flexible_adslot_settings {
    max_width: 412
    max_height: 361
    min_width: 206
    min_height: 46
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_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
cookie_version: 1
google_user_id: "Fl9o7N66Yl32fK90ZvfV50238gt"
timezone_offset: 120
mobile {
  app_id: "com.google.testapp"
  is_app: false
  is_mobile_web_optimized: true
  app_name: "Test App"
  app_rating: 3.9867892
}
cookie_age_seconds: 10368000
geo_criteria_id: 1008141
publisher_settings_list_id: 7538157606866003226
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 7568211982740612868
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "Samsung"
  model: "sm-a750fn"
  os_version {
    major: 10
  }
  carrier_id: 70150
  screen_width: 412
  screen_height: 846
  screen_pixel_ratio_millis: 2625
  screen_orientation: PORTRAIT
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zM40L2-685i3i9Pb9aV5D0nlcJ6vR1yvq0Xev4635927DQi781B2X403h2GoyQQdMl26"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-BO"
  city: "Bologna"
  utcoffset: 120
  accuracy: 5230
}
user_agent_data {
  platform {
    brand: "Android"
    version: "10"
    version: "0"
  }
  mobile: true
  model: "SM-A750FN"
  browsers {
    brand: "Android WebView"
    version: "129"
    version: "0"
  }
  browsers {
    brand: "Not=A?Brand"
    version: "8"
    version: "0"
  }
  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_BROWSER
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Per convertire la richiesta di offerta in un formato binario, come si otterrebbe dal payload POST in una richiesta reale, puoi procedere nel seguente modo (in C++). Tieni presente, tuttavia, che questo non è applicabile a OpenRTB JSON.

string text_format_example = /* example from above */;
BidRequest bid_request;
if (TextFormat::ParseFromString(text_format_example, &bid_request)) {
  string post_payload;
  if (bid_request.SerializeToString(&post_payload)) {
    // post_payload is a binary serialization of the protocol buffer
  }
}

Feedback in tempo reale

Il feedback in tempo reale è disponibile per Authorized Buyers, nonché per le piattaforme di scambio e le reti che utilizzano Open Bidding.

Il feedback sulla risposta all'offerta è supportato nella richiesta di offerta successiva sia per OpenRTB sia per il protocollo Google RTB deprecato. Per OpenRTB, viene inviato in BidRequest.ext.bid_feedback.

Oltre ai campi predefiniti inviati nel feedback sulla risposta all'offerta, puoi anche inviare dati personalizzati nella risposta all'offerta utilizzando il campo BidResponse.seatbid.bid.ext.event_notification_token. event_notification_token è un dato arbitrario noto solo all'offerente che potrebbe essere utile per il debug, ad esempio un nuovo ID targeting o ID offerta che rappresenta una nuova tattica o i metadati associati alla creatività noti solo all'offerente. Per maggiori dettagli, consulta OpenRTB Extensions Protocol Buffer per OpenRTB o il deprecated Google RTB protocol.

Avviso: se hai configurato endpoint di offerta per l'utilizzo di OpenRTB e Google RTB, è noto che un valore event_notification_token impostato in una risposta all'offerta per un protocollo può essere visualizzato nel feedback della risposta all'offerta nell'altro protocollo. Devi impostare event_notification_token nella risposta all'offerta su una stringa UTF-8 in entrambi i protocolli, altrimenti le richieste di offerta che includono il token potrebbero non riuscire a essere serializzate e non raggiungere i tuoi endpoint.

Quando Authorized Buyers invia una richiesta di offerta a un offerente, quest'ultimo risponde con un BidResponse. Se l'offerente ha attivato il feedback in tempo reale, in una richiesta di offerta successiva, Authorized Buyers invia un feedback sulla risposta in un messaggio BidFeedback:

message BidFeedback {
  // The unique id from BidRequest.id.
  optional string request_id = 1;

  // The status code for the ad. See creative-status-codes.txt in the
  // technical documentation for a list of ids.
  optional int32 creative_status_code = 2;

  // Deprecated. This field is not populated and will be removed after March,
  // 2025. If the bid won the auction, this is the price paid in your account
  // currency. If the bid participated in the auction but was out-bid, this
  // is the CPM that should have been exceeded in order to win. This is not
  // set if the bid was filtered prior to the auction, if the publisher or
  // winning bidder has opted out of price feedback or if your account has
  // opted out of sharing winning prices with other bidders. For first-price
  // auctions, minimum_bid_to_win is populated instead of this field.
  optional double price = 3 [deprecated = true];

  // The minimum bid value necessary to have won the auction, in your account
  // currency. If your bid won the auction, this is the second highest bid
  // that was not filtered (including the floor price). If your bid didn't win
  // the auction, this is the winning candidate's bid. This field will only be
  // populated if your bid participated in a first-price auction, and will not
  // be populated if your bid was filtered prior to the auction.
  optional double minimum_bid_to_win = 6;

  // The minimum bid value necessary to have won the server-side component of
  // the overall auction given that there was also an interest group bidding
  // component to the overall auction which ran using the Protected Audience
  // API. The value is expressed in CPM of the buyer account currency. The
  // minimum bid to win for the overall auction, including bids from the
  // server-side and the on-device interest group components, is populated in
  // the minimum_bid_to_win field of the same BidFeedback object.
  optional double sscminbidtowin = 14;

  // Billable event rate multiplier that was applied to this bid during
  // ranking. The adjustment reflects the likelihood that your bid would
  // generate a billable event (namely, the ad renders successfully) if it won
  // the auction, relative to the probability that other bids generate a
  // billable event if they won the auction. This adjustment can be larger or
  // smaller than 1. This affects the final ranking in the auction only; in
  // particular, this multiplier does not affect the payment or whether the
  // bid clears any floor price.
  optional float billable_event_rate_bid_adjustment = 13 [default = 1];

  // When a publisher uses an RTB auction and waterfall-based SDK mediation on
  // the same query, the winner of the real-time auction must also compete in
  // a mediation waterfall (which is ordered by price) to win the impression.
  // If the bid participated in the auction and there was no waterfall, the
  // value of this field is 0. If the bid participated in the auction and
  // there was a waterfall, the value of this field is a price representing a
  // sample bid from the eligible mediation networks that were higher than the
  // auction winner, weighted by expected fill rate. This field can be used
  // in conjunction with minimum_bid_to_win to train bidding models. The CPM
  // is in your account currency.
  optional double sampled_mediation_cpm_ahead_of_auction_winner = 8;

  message EventNotificationToken {
    // The contents of the token.
    optional string payload = 1;
  }

  // The token included in the corresponding bid.
  optional EventNotificationToken event_notification_token = 4;

  // The creative ID included in the corresponding bid.
  optional string buyer_creative_id = 5;

  // Possible types of bid response feedback objects.
  enum FeedbackType {
    FEEDBACK_TYPE_UNSPECIFIED = 0;

    // Feedback for a bid that was submitted on a bid response.
    BID_FEEDBACK = 1;

    // Feedback for an interest group buyer submitted on a bid response to
    // particpate in an interest group bidding component of the auction run
    // using the Protected Audience API.
    INTEREST_GROUP_BUYER_FEEDBACK = 2;
  }

  // The type of the BidFeedback message. Google will send separate
  // BidFeedback objects for:
  // a) Each bid submitted on a bid response
  // b) Each buyer submitted on a bid response to particpate in an interest
  // group bidding component of the auction run using the Protected Audience
  // API.
  optional FeedbackType feedbacktype = 15;

  // Origin of an interest group buyer that was included in the bid response.
  // This field is populated only for feedback where a bidder opted in an
  // interest group buyer to participate in the interest group bidding
  // component of the overall auction run using the Protected Audience API.
  // To learn more about origins, see https://www.rfc-editor.org/rfc/rfc6454.
  // To learn more about interest group bidding and the Protected Audience
  // API, see
  // https://developers.google.com/authorized-buyers/rtb/fledge-origin-trial.
  optional string buyerorigin = 16;

  // The status code for the submitted interest group buyer. This field is
  // only populated in the feedback for an interest group buyer that a bidder
  // requested to enter into the interest group auction through the bid
  // response. Individual creative status codes of bids submitted by the buyer
  // in the on-device interest group auction are not available. See
  // https://storage.googleapis.com/adx-rtb-dictionaries/interest-group-buyer-status-codes.txt
  // for a list of interest group buyer status codes.
  optional int32 igbuyerstatus = 17;
}

In questo messaggio, il primo campo da controllare è bid_feedback.creative_status_code; puoi trovare il significato del codice in creative-status-codes.txt. Tieni presente che se vinci l'offerta, puoi disattivare il feedback sul prezzo. Per ulteriori informazioni, consulta la sezione Come disattivare.

Il feedback in tempo reale include l'ID richiesta di offerta e uno dei seguenti elementi:

Risultato dell'asta	Feedback in tempo reale
L'acquirente non ha inviato un'offerta.	Niente.
L'acquirente ha inviato un'offerta che è stata filtrata prima di raggiungere l'asta.	Il codice dello stato della creatività (creative-status-codes.txt).
L'acquirente ha inviato un'offerta, ma ha perso l'asta.	Il codice di stato della creatività 79 (offerta superiore nell'asta).
L'acquirente ha inviato un'offerta che ha vinto l'asta.	Il prezzo di aggiudicazione e il codice di stato della creatività 1. Per un'impressione di app e un codice di stato della creatività 83, il Publisher dell'app potrebbe aver utilizzato una struttura a cascata della mediazione e quindi l'offerta migliore avrebbe gareggiato con altre richieste nella catena a cascata del passback del publisher. Scopri come utilizzare sampled_mediation_cpm_ahead_of_auction_winner quando fai offerte.

Esempio

Di seguito è riportato un esempio di feedback in tempo reale come visualizzato nei protocolli supportati:

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "01WjN3uc042XYP8Yw509Q7"
imp {
  id: "1"
  banner {
    w: 344
    h: 650
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 344
      h: 650
    }
    format {
      w: 300
      h: 600
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.6.0"
  instl: true
  tagid: "7282514850"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 14400
  clickbrowser: true
  metric {
    type: "viewability"
    value: 0.77
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 75441834964
    publisher_settings_list_id: 9268043626392948934
    publisher_settings_list_id: 2867966915706729060
    allowed_vendor_type: 113
    allowed_vendor_type: 41423
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    allowed_restricted_category: 33
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    is_app_open_ad: true
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "6.46.0"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7120195540802809"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.6"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GHA"
    type: IP
    utcoffset: 0
    accuracy: 8865
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9067654
    }
  }
  make: "Itel"
  model: "itel W6502"
  os: "android"
  osv: "10"
  connectiontype: CELL_4G
  devicetype: HIGHEND_PHONE
  lmt: true
  w: 360
  h: 722
  pxratio: 2.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "10"
    }
    mobile: true
    model: "itel W6502"
    source: USER_AGENT_STRING
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 660
    }
  }
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB19-22"
bcat: "IAB23-1"
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] {
  bid_feedback {
    request_id: "4004C52Z6Z7Fa39Lf6F2AQ"
    creative_status_code: 79
    buyer_creative_id: "test_creative_id_129669"
    minimum_bid_to_win: 0.1
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-zbp8Gw-Mv43u3ni49Ena0i57E0789881P6YVa8jXDHq36B3fNk8me8F20GS6114onx7A"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Mostrami l'esempio

{
  "id": "01WjN3uc042XYP8Yw509Q7",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 344,
        "h": 650,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 344,
            "h": 650
          },
          {
            "w": 300,
            "h": 600
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.6.0",
      "instl": 1,
      "tagid": "7282514850",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 14400,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "viewability",
          "value": 0.77,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "75441834964"
        ],
        "publisher_settings_list_id": [
          "9268043626392948934",
          "2867966915706729060"
        ],
        "allowed_vendor_type": [
          113,
          41423
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32,
          33
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "is_app_open_ad": 1,
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "6.46.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7120195540802809",
      "ext": {
        "country": "US"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.6",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GHA",
      "type": 2,
      "utcoffset": 0,
      "accuracy": 8865,
      "ext": {
        "geo_criteria_id": 9067654
      }
    },
    "make": "Itel",
    "model": "itel W6502",
    "os": "android",
    "osv": "10",
    "connectiontype": 6,
    "devicetype": 4,
    "lmt": 1,
    "w": 360,
    "h": 722,
    "pxratio": 2.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "10"
        ]
      },
      "mobile": 1,
      "model": "itel W6502",
      "source": 3
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 660
      }
    }
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB19-22",
    "IAB23-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": {
    "bid_feedback": [
      {
        "request_id": "4004C52Z6Z7Fa39Lf6F2AQ",
        "creative_status_code": 79,
        "buyer_creative_id": "test_creative_id_129669",
        "minimum_bid_to_win": 0.1,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-zbp8Gw-Mv43u3ni49Ena0i57E0789881P6YVa8jXDHq36B3fNk8me8F20GS6114onx7A",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "\334\225\241N\334P\373p\340\000\300C\327+\215\013\355Q\337\251Z\236g"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "es"
adslot {
  id: 1
  width: 320
  height: 50
  excluded_attribute: 19
  excluded_attribute: 20
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  matching_ad_data {
    billing_id: 58232806131
    billing_id: 71082687953
    minimum_cpm_micros: 1400000
  }
  matching_ad_data {
    billing_id: 82776154517
    billing_id: 59477532962
    minimum_cpm_micros: 78750000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 7742701593
  publisher_settings_list_id: 4723020262350940099
  publisher_settings_list_id: 6354748437627634678
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  viewability: 99
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 300
  api: OMID_1
  api: MRAID_1
  omidpn: "Google"
  omidpv: "afma-sdk-i-v10.14.0"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
  display_manager: "GoogleMobileAds-iOS"
  display_manager_version: "10.14.0"
}
is_test: false
timezone_offset: -420
mobile {
  app_id: "350328655"
  is_app: true
  is_mobile_web_optimized: true
  encrypted_advertising_id: ",\271\302R\363\232\001NA\001\240D\"\032\001N\251+\271\000\3510\026)\356n\3733\214a\276\321P\202\205\033"
  app_name: "Test App"
  advertising_id: "^\274v\200\002\333u\227Y\304\343u\304\272\312\247"
  skadn {
    sourceapp: "350328655"
    skadnetids: "6sZrk2l9"
    skadnetids: "L60y296B"
    versions: "2.0"
    versions: "2.1"
    supported_fidelity_types: STOREKIT_RENDERED_ADS
    supported_fidelity_types: VIEW_THROUGH_ADS
  }
}
postal_code: "10011"
geo_criteria_id: 9194140
bid_response_feedback {
  request_id: "\177f\245p\252\347p\251\266\326S(\272\335\013\257"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_923023"
  minimum_bid_to_win: 3750000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "6\374\201J\0355\275\014\335\270\202\307\261\253I\247"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_923023"
  minimum_bid_to_win: 570000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: HIGHEND_PHONE
  platform: "iphone"
  brand: "Apple"
  model: "iPhone14,5"
  os_version {
    major: 17
    minor: 6
    micro: 1
  }
  carrier_id: 0
  screen_width: 390
  screen_height: 844
  screen_pixel_ratio_millis: 3000
  screen_orientation: PORTRAIT
  hardware_version: "iPhone14,5"
  limit_ad_tracking: false
  app_tracking_authorization_status: AUTHORIZED
  connection_type: WIFI
}
publisher_country: "CA"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z73p95-804i3oEddT04Y8kl9v8C0D3k33ZDTAuc547f0v52955w82z36pq70wV1j5xKW"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "USA"
  metro: "807"
  city: "San Mateo"
  zip: "94401"
  utcoffset: -420
  accuracy: 997
}
user_agent_data {
  platform {
    brand: "iPhone"
    version: "17"
    version: "6"
  }
  mobile: true
  model: "iPhone"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "605"
    version: "1"
  }
  bitness: "64"
  source: USER_AGENT_STRING
}
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"
session_duration_seconds: 411

Creare un modello di offerta per le aste al primo prezzo

Dopo aver fatto un'offerta in un'asta al primo prezzo, riceverai un feedback in tempo reale, inclusi i campi minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner, se l'offerta non è stata filtrata dall'asta. Questi indicatori possono essere utilizzati per informare la logica di offerta su quanto più alta o più bassa avrebbe potuto essere l'offerta per vincere l'impressione.

• minimum_bid_to_win: l'offerta minima che avrebbe potuto essere presentata per vincere l'asta con offerte in tempo reale. Se hai vinto l'asta, si tratta dell'offerta più bassa che avresti potuto fare per vincere. Se hai perso l'asta, questa sarà l'offerta vincente.
• sampled_mediation_cpm_ahead_of_auction_winner: se nella catena di mediazione sono presenti altre reti, il valore di questo campo è un prezzo che rappresenta un'offerta di esempio di una delle reti di mediazione idonee superiore a quella del vincitore dell'asta, ponderato in base al tasso di riempimento previsto. Questo valore verrà impostato su 0 se non è previsto che nessuna delle reti nella catena di mediazione venga riempita o se il publisher non utilizza la mediazione tramite SDK.

Come funziona

Per descrivere i calcoli utilizzati per determinare i possibili valori per minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner, dobbiamo prima definire quanto segue:

• Di seguito sono riportati i CPM nella catena di mediazione in ordine decrescente:
  $$C_1, C_2, …, C_n$$
• Di seguito sono riportati i tassi di riempimento corrispondenti per i CPM nella catena di mediazione:
  $$f_1, f_2, …, f_n$$
• Di seguito è riportata una funzione utilizzata per determinare il CPM previsto e la relativa probabilità dall'elemento della catena di mediazione $i$, in base al tasso di riempimento specificato:
  $X_i = \{C_i$ con probabilità $f_i$; $0$ con probabilità $1 - f_i\}$
• La catena di mediazione vincente finale sarà:
  $$\{C_1, C_2, …, C_K, W\}$$
  dove $W$ è l'offerta vincente e $C_K > W >= C_{K+1}$
• Il prezzo di riserva, o minimo, è indicato come $F$.
• L'offerta seconda classificata è indicata come $R$.

Calcoli per il vincitore dell'asta

Campo	Calcolo
minimum_bid_to_win	$max\{F, R, X_{K+1}, …, X_n\}$
sampled_mediation_cpm_ahead_ of_auction_winner	$\{C_i$ con probabilità $\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}$ Per $1 <= i <= K$.

Calcoli per il perdente dell'asta

Campo	Calcolo
minimum_bid_to_win	$max\{F, W\}$
sampled_mediation_cpm_ahead_ of_auction_winner	$max\{X_1, …, X_K\}$

Esempio con una semplice catena di mediazione

Supponiamo che un publisher utilizzi sia le offerte in tempo reale sia una catena di mediazione SDK come segue:

Catena di mediazione SDK	CPM previsto	Tasso di riempimento
Rete 1	$C_1 = $3.00$	$f_1 = 5\%$
Rete 2	$C_2 = $2.00$	$f_2 = 45\%$
Rete 3	$C_3 = $0.50$	$f_3 = 80\%$
Rete 4	$C_4 = $0.10$	$f_4 = 85\%$

Supponiamo che il risultato dell'asta RTB sia il seguente:

Asta RTB	CPM
Vincitore dell'asta (W)	1,00 $
Secondo classificato dell'asta (R)	$ 0,05
Prezzo di riserva / prezzo minimo (F)	0 $

Offerta che ha vinto l'asta

Di seguito è riportato un esempio di come vengono calcolati i valori e le probabilità per minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner per un'offerta vincente.

minimum_bid_to_win	Probabilità
$max(F, R, C_3) = $0.50$	$f_3 = 80\%$
$max(F, R, C_4) = $0.10$	$(1-f_3) \cdot f_4 = 17\%$
$max(F, R, 0) = $0.05$	$(1-f_3) \cdot (1-f_4) = 3\%$

sampled_mediation_cpm_ ahead_of_auction_winner	Probabilità
$C_1 = $3.00$	$f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%$
$C_2 = $2.00$	$((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%$

Nota: se il vincitore dell'asta pubblica il suo annuncio e riceve una notifica di fatturazione, ad esempio tramite un endpoint specificato in BidResponse.seatbid[].bid[].burl, può dedurre che nessuno dei CPM di mediazione campionati è stato completato e può includere la frequenza con cui si verifica questo evento nel suo modello.

Offerte che hanno perso l'asta

Di seguito è riportato un esempio di come vengono calcolati i valori e le probabilità per minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner per un asta persa.

minimum_bid_to_win	Probabilità
$max(F, W) = $1.00$	$100\%$

sampled_mediation_cpm_ ahead_of_auction_winner	Probabilità
$C_1 = $3.00$	$f_1 = 5\%$
$C_2 = $2.00$	$(1-f_1) \cdot f_2 =~ 42.8\%$
$0$	$(1-f_1) \cdot (1-f_2) =~ 52.2\%$

Nota: un valore sampled_mediation_cpm_ahead_of_auction_winner pari a 0 indica che l'asta con offerte in tempo reale è stata vinta. Nell'esempio precedente, il vincitore dell'asta dovrebbe non essere superato da un'altra rete di mediazione concorrente nel 52,2% dei casi.

Suddivisione delle offerte

La suddivisione delle offerte descrive l'elaborazione di un singolo BidRequest complesso in più richieste di offerta inviate alla tua applicazione. Quando una richiesta di offerta viene appiattita, puoi capire quali richieste di offerta fanno parte dell'originale perché avranno un valore identico nel campo BidRequest.ext.google_query_id.

L'appiattimento delle offerte è abilitato per impostazione predefinita, ma puoi contattare il tuo account manager se preferisci disattivarlo.

Formati degli annunci

Alcune opportunità pubblicitarie possono accettare più formati. Con la semplificazione delle offerte, ogni formato viene inviato in una richiesta di offerta distinta in cui gli attributi come gli ID fatturazione idonei sono pertinenti al formato specificato nella richiesta.

Le richieste di offerta contenenti i seguenti formati verranno suddivise in richieste di offerta distinte:

• Banner
• Video
• Audio
• Nativo

Esempio di appiattimento del formato dell'annuncio

Di seguito è riportato un esempio che mostra una richiesta di offerta JSON OpenRTB semplificata senza appiattimento del formato dell'annuncio rispetto a un insieme equivalente di richieste appiattite:

Pre-appiattimentoPost-appiattimento

Mostrami l'esempio

{
  "id": "V5ar1wXqKP58nbsyJ6549D",
  "imp": [
    {
      "id": "1",
      "video": {
        "linearity": 1,
        "w": 300,
        "h": 250,
        "pos": 1,
        "skip": 1,
        "playbackmethod": [
          6
        ],
        "placement": 3,
        "mimes": [
          "video/mp4"
        ],
        "protocols": [
          2,
          3
        ]
      },
      "banner": {
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ],
        "w": 300,
        "h": 250,
        "pos": 1
      },
      "ext": {
        "billing_id": [
          47039494050,
          52030317241
        ]
      }
    }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Mostrami l'esempio

Richiesta 1

{
  "id": "B3xr1yZqRL48nbsyJ6367N",
  "imp": [
    {
      "id": "1",
      "video": {
        "linearity": 1,
        "w": 300,
        "h": 250,
        "pos": 1,
        "skip": 1,
        "playbackmethod": [
          6
        ],
        "placement": 3,
        "mimes": [
          "video/mp4"
        ],
        "protocols": [
          2,
          3
        ]
      }
      "ext": {
        "billing_id": [
          47039494050
        ]
      }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Richiesta 2

{
  "id": "M1dY8qHyNK74bMsjF393Gf",
  "imp": [
    {
      "id": "1",
      "banner": {
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ],
        "w": 300,
        "h": 250,
        "pos": 1
      },
      "ext": {
        "billing_id": [
          52030317241
        ]
      }
    }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Offerte

Un'opportunità pubblicitaria per un determinato offerente può essere applicabile a vari tipi di deal, oltre all'asta aperta. Con la suddivisione delle offerte per i deal, verrà inviata una richiesta di offerta per l'asta aperta e una per ogni tipo di deal a prezzo fisso. In pratica, i vincoli degli annunci possono variare tra le aste e i tipi di deal a prezzo fisso. Ad esempio, per una determinata opportunità pubblicitaria video disponibile sia per l'asta aperta sia per un deal a prezzo fisso, un offerente riceverà richieste di offerta distinte per ciascuno, in cui i vincoli, come la durata massima dell'annuncio e la possibilità di utilizzare annunci ignorabili, possono variare. Di conseguenza, l'appiattimento applicato all'opportunità pubblicitaria ti consente di distinguere più facilmente i vincoli degli annunci per l'asta aperta e il deal a prezzo fisso.

Nota: le aste private e i pacchetti di aste avranno vincoli identici a quelli dell'asta aperta e continueranno a essere inclusi nelle richieste di offerta per l'asta aperta.

Durata massima video ignorabili

Il protocollo di Google e l'implementazione di OpenRTB supportano i seguenti campi per la durata e la possibilità di saltare i video:

	Durata	Durata ignorabile	Possibilità di ignorare gli annunci
Protocollo Google	max_ad_duration	skippable_max_ad_duration	video_ad_skippable
OpenRTB	maxduration	n/a	skip

Ciò significa che, mentre il protocollo Google può avere una durata ignorabile e non ignorabile granulare, l'implementazione OpenRTB ha un solo valore di durata massima.

Prima dell'appiattimento delle offerte, il valore maxduration di OpenRTB veniva impostato sul valore più basso dei campi max_ad_duration e skippable_max_ad_duration del protocollo Google. Ora questo comportamento è cambiato e vengono inviate due richieste di offerta distinte quando questi valori sono diversi: una che rappresenta il valore maxduration per le opportunità ignorabili e l'altra per quelle non ignorabili.

Gli esempi riportati di seguito mostrano come una richiesta di protocollo Google viene tradotta in OpenRTB prima e dopo l'appiattimento delle offerte. La richiesta del protocollo Google equivalente ha un valore max_ad_duration di 15 e un valore skippable_max_ad_duration di 60.

Esempio	max_ad_duration	skip (true OPPURE false)
Richiesta originale senza appiattimento	15	true
Richiesta appiattita 1: non ignorabile	15	false
Richiesta piatta 2: ignorabile	60	true

La suddivisione delle richieste di offerta in base alla durata dei video ignorabili viene eseguita solo se sono soddisfatte queste condizioni:

• La richiesta consente i video.
• Sono consentiti sia i video ignorabili che quelli non ignorabili e le due rispettive durate massime differiscono nel valore.
• Questa richiesta è idonea per l'asta privata o l'asta aperta.
• L'account dell'offerente ha endpoint OpenRTB attivi.

Puoi disattivare questo tipo di appiattimento contattando il tuo Technical Account Manager.

Pod video

Le richieste di offerta per un pod video con più opportunità pubblicitarie vengono appiattite, in modo che ogni richiesta di offerta riguardi una singola opportunità pubblicitaria del pod. In questo modo puoi fare offerte per più opportunità pubblicitarie per un determinato pod.

Open Measurement

Open Measurement ti consente di specificare fornitori di terze parti che forniscono servizi di misurazione e verifica indipendenti per gli annunci pubblicati negli ambienti delle app mobile.

Puoi determinare se un publisher supporta Open Measurement nella richiesta di offerta controllando se l'opportunità pubblicitaria esclude l'attributo OmsdkType: OMSDK 1.0 presente negli attributi della creatività escludibili dal publisher. Lo puoi trovare nell'attributo battr per banner o video, a seconda del formato.

Per ulteriori informazioni su come interpretare le richieste di offerta contenenti gli indicatori di Open Measurement, consulta l'articolo del Centro assistenza sull'SDK Open Measurement.

Richieste di offerta di esempio

Le sezioni seguenti mostrano richieste di offerta di esempio per diversi tipi di annunci.

Nota: gli esempi di Protobuf includono link di download a richieste di offerta serializzate simili. Non è garantito che siano identici.

Banner app

Protobuf OpenRTBJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "8361O9Ep6E42p52Hu6v18o"
imp {
  id: "1"
  banner {
    w: 300
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    wmax: 390
    hmax: 61
    wmin: 261
    hmin: 46
    format {
      w: 300
      h: 50
    }
    format {
      w: 390
      h: 61
    }
    [com.google.doubleclick.banner_ext] {
      flexslot {
        wmin: 261
        wmax: 390
        hmin: 46
        hmax: 61
      }
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.2.0"
  tagid: "5609900911"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0028797138947993517
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.92
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 70614819650
    publisher_settings_list_id: 3994817494897795207
    publisher_settings_list_id: 8449380548613820850
    allowed_vendor_type: 550
    allowed_vendor_type: 79
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "Y8HK1z22"
      versions: "2.0"
      versions: "2.1"
      fidelities: STOREKIT_RENDERED_ADS
      fidelities: VIEW_THROUGH_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    billable_event_rate_bid_adjustment {
      bid_adjustment: 0.9408176
      creative_type: HTML_SNIPPET
    }
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "4.6.3"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-2905535032168301"
    [com.google.doubleclick.publisher] {
      country: "JP"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "ja"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "JPN"
    region: "JP-13"
    type: IP
    utcoffset: 540
    accuracy: 26487
    [com.google.doubleclick.geo] {
      geo_criteria_id: 20636
    }
  }
  carrier: "70002"
  make: "Apple"
  model: "iPhone13,2"
  os: "iOS"
  osv: "16.1.1"
  connectiontype: CELL_4G
  devicetype: HIGHEND_PHONE
  lmt: true
  hwv: "iPhone13,2"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "16"
      version: "1"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 61
    }
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB14-1"
bcat: "IAB7-39"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.2.0"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z60259-oh0d8s5Z26f34EZa77T0p62zWhI2939jRL32216xlr9483rnAC6t07lL0ky4q"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Mostrami l'esempio

{
  "id": "8361O9Ep6E42p52Hu6v18o",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 50,
        "pos": 1,
        "api": [
          3,
          5
        ],
        "wmax": 390,
        "hmax": 61,
        "wmin": 261,
        "hmin": 46,
        "format": [
          {
            "w": 300,
            "h": 50
          },
          {
            "w": 390,
            "h": 61
          }
        ],
        "ext": {
          "flexslot": {
            "wmin": 261,
            "wmax": 390,
            "hmin": 46,
            "hmax": 61
          }
        }
      },
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "11.2.0",
      "tagid": "5609900911",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0028797138947993517,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.92,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "70614819650"
        ],
        "publisher_settings_list_id": [
          "3994817494897795207",
          "8449380548613820850"
        ],
        "allowed_vendor_type": [
          550,
          79
        ],
        "ampad": 2,
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "Y8HK1z22"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            1,
            0
          ]
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "billable_event_rate_bid_adjustment": [
          {
            "bid_adjustment": 0.9408176,
            "creative_type": 1
          }
        ],
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "4.6.3",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-2905535032168301",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-13",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 26487,
      "ext": {
        "geo_criteria_id": 20636
      }
    },
    "carrier": "70002",
    "make": "Apple",
    "model": "iPhone13,2",
    "os": "iOS",
    "osv": "16.1.1",
    "connectiontype": 6,
    "devicetype": 4,
    "lmt": 1,
    "hwv": "iPhone13,2",
    "w": 390,
    "h": 844,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "16",
          "1"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 2
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 61
      }
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB14-1",
    "IAB7-39"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v11.2.0",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z60259-oh0d8s5Z26f34EZa77T0p62zWhI2939jRL32216xlr9483rnAC6t07lL0ky4q",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "%\360\313c\223\244&\242H\313\345\032T\223^\3325p;e\320\275\333"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "en"
adslot {
  id: 1
  width: 300
  width: 250
  height: 250
  height: 250
  excluded_attribute: 14
  excluded_attribute: 30
  allowed_vendor_type: 566
  allowed_vendor_type: 113
  excluded_sensitive_category: 36
  excluded_sensitive_category: 31
  matching_ad_data {
    billing_id: 99718422589
    minimum_cpm_micros: 40000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 1885999125
  publisher_settings_list_id: 3855970278395809335
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  viewability: 79
  click_through_rate: 0.00562083
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  api: OMID_1
  api: MRAID_1
  omidpn: "Google"
  omidpv: "afma-sdk-i-v11.3.0"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  billable_event_rate_bid_adjustment {
    bid_adjustment: 1.0
    creative_type: HTML_SNIPPET
  }
  excluded_app_ids: "1359763701"
  excluded_app_ids: "367003839"
  supported_auction_environment: SERVER_SIDE_AUCTION
  display_manager: "GoogleMobileAds-iOS"
  display_manager_version: "11.3.0"
}
is_test: false
timezone_offset: 330
mobile {
  app_id: "195751234"
  is_app: true
  is_mobile_web_optimized: true
  app_name: "Test App"
  skadn {
    sourceapp: "195751234"
    skadnetids: "DofiF4X5"
    versions: "2.0"
    versions: "2.1"
    supported_fidelity_types: VIEW_THROUGH_ADS
    supported_fidelity_types: STOREKIT_RENDERED_ADS
  }
}
geo_criteria_id: 1007776
publisher_settings_list_id: 8761862033459127079
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 9618759969316406640
device {
  device_type: HIGHEND_PHONE
  platform: "iphone"
  brand: "Apple"
  model: "iPhone15,3"
  os_version {
    major: 18
    minor: 0
  }
  carrier_id: 0
  screen_width: 430
  screen_height: 932
  screen_pixel_ratio_millis: 3000
  screen_orientation: PORTRAIT
  hardware_version: "iPhone15,3"
  limit_ad_tracking: true
  app_tracking_authorization_status: DENIED
  connection_type: CELL_4G
}
publisher_country: "SG"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 1000
google_query_id: "ANy-z77R39-62EWf097071AiV91giun09eX9bwHu5TL506725r73P656pqL7A344LmT9485F"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "IND"
  region: "IN-KL"
  city: "Cochin"
  utcoffset: 330
  accuracy: 11461
}
user_agent_data {
  platform {
    brand: "iPhone"
    version: "18"
    version: "0"
  }
  mobile: true
  model: "iPhone"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "605"
    version: "1"
  }
  bitness: "64"
  source: USER_AGENT_STRING
}
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_APP
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"
session_duration_seconds: 660

Interstitial per app

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "27q8F4ja125b5Ay5Lg5I8Y"
imp {
  id: "1"
  banner {
    w: 368
    h: 740
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 368
      h: 740
    }
    format {
      w: 300
      h: 600
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "21.5.0"
  instl: true
  tagid: "7072441745"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 14400
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.026930272579193115
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.82
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 14443955188
    publisher_settings_list_id: 7634109184153514733
    publisher_settings_list_id: 4552400977800686866
    allowed_vendor_type: 4374
    allowed_vendor_type: 4651
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    is_app_open_ad: true
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "9.1.6"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8897222327395144"
    [com.google.doubleclick.publisher] {
      country: "TH"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.7"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "IND"
    region: "IN-OR"
    zip: "751024"
    type: IP
    utcoffset: 330
    accuracy: 5126
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9149991
    }
  }
  ipv6: "2401:4900:3da4::"
  carrier: "70210"
  make: "Samsung"
  model: "SM-A705GM"
  os: "android"
  osv: "11"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  lmt: true
  w: 384
  h: 812
  pxratio: 2.813
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "11"
    }
    mobile: true
    model: "SM-A705GM"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    session_id: "LFcNok-qRI2ea_Z5FPgRiA"
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 89
    }
  }
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB23-3"
bcat: "IAB23-4"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v243220999.224400000.1"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Mostrami l'esempio

{
  "id": "27q8F4ja125b5Ay5Lg5I8Y",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 368,
        "h": 740,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 368,
            "h": 740
          },
          {
            "w": 300,
            "h": 600
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "21.5.0",
      "instl": 1,
      "tagid": "7072441745",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 14400,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.026930272579193115,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.82,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "14443955188"
        ],
        "publisher_settings_list_id": [
          "7634109184153514733",
          "4552400977800686866"
        ],
        "allowed_vendor_type": [
          4374,
          4651
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "is_app_open_ad": 1,
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "9.1.6",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-8897222327395144",
      "ext": {
        "country": "TH"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.7",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "IND",
      "region": "IN-OR",
      "zip": "751024",
      "type": 2,
      "utcoffset": 330,
      "accuracy": 5126,
      "ext": {
        "geo_criteria_id": 9149991
      }
    },
    "ipv6": "2401:4900:3da4::",
    "carrier": "70210",
    "make": "Samsung",
    "model": "SM-A705GM",
    "os": "android",
    "osv": "11",
    "connectiontype": 2,
    "devicetype": 4,
    "lmt": 1,
    "w": 384,
    "h": 812,
    "pxratio": 2.813,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "11"
        ]
      },
      "mobile": 1,
      "model": "SM-A705GM",
      "source": 3
    },
    "ext": {
      "session_id": "LFcNok-qRI2ea_Z5FPgRiA"
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 89
      }
    }
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB23-3",
    "IAB23-4"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v243220999.224400000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "\275\302\334\306\350\275\013\246\272\341\347:\001\261e\316\266A\345-\275KY"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "fa"
adslot {
  id: 1
  width: 756
  width: 336
  height: 384
  height: 280
  excluded_attribute: 27
  excluded_attribute: 18
  allowed_vendor_type: 414
  allowed_vendor_type: 780
  excluded_sensitive_category: 19
  excluded_sensitive_category: 4
  matching_ad_data {
    billing_id: 12608068331
    billing_id: 32735556853
    minimum_cpm_micros: 530000
  }
  matching_ad_data {
    billing_id: 57993817261
    billing_id: 38977320457
    minimum_cpm_micros: 220000
  }
  slot_visibility: ABOVE_THE_FOLD
  excluded_product_category: 10137
  excluded_product_category: 13314
  ad_block_key: 9588004964
  publisher_settings_list_id: 5660377215376132006
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  viewability: 74
  click_through_rate: 0.010888527
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  api: OMID_1
  api: MRAID_1
  omidpn: "Google"
  omidpv: "afma-sdk-a-v243220999.241199000.1"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
  display_manager: "GoogleMobileAds-Android"
  display_manager_version: "23.1.0"
}
is_test: false
timezone_offset: 210
mobile {
  app_id: "com.google.testapp"
  is_app: true
  is_interstitial_request: true
  is_mobile_web_optimized: true
  app_name: "Test App"
  app_rating: 4.392222
}
geo_criteria_id: 2276
publisher_settings_list_id: 12210881757835437691
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 5268591861321003271
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "Samsung"
  model: "SM-A546E"
  os_version {
    major: 14
  }
  carrier_id: 0
  screen_width: 756
  screen_height: 384
  screen_pixel_ratio_millis: 2813
  screen_orientation: LANDSCAPE
  limit_ad_tracking: false
  connection_type: CELL_4G
}
publisher_country: "GB"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-zCczd2-28ZNY4j78b8024p1s4MJUg62G4F8H3P1YS544377wezcJVi4h3I9LB3y7yW80"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "DEU"
  utcoffset: 210
  accuracy: 346648
}
user_agent_data {
  platform {
    brand: "Android"
    version: "14"
  }
  mobile: true
  model: "SM-A546E"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "537"
    version: "36"
  }
  bitness: "64"
  source: USER_AGENT_STRING
}
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_DEVICE
privacy_treatments {
  ip: IP_REDACTED
  user_agent: USER_AGENT_COARSE
  non_personalized_ads_reason: PUBLISHER_DECLARED_NPA
  allow_user_data_collection: false
}
inventory_partner_domain: "OMITTED"
navigation_type: NAVIGATION_TYPE_UNKNOWN
session_duration_seconds: 25

Video interstitial per app

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "Z75GBa308fk6hn20L15573"
imp {
  id: "1"
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    maxduration: 600
    w: 808
    h: 393
    startdelay: 0
    playbackmethod: AUTO_PLAY_SOUND_ON
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: FLOATING_PLACEMENT
    playbackend: COMPLETION_OR_USER
    maxseq: 2
    poddur: 30
    plcmt: PLCMT_INTERSTITIAL
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_INTERSTITIAL
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.7.0"
  instl: true
  tagid: "4967856214"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.1879923790693283
    vendor: "EXCHANGE"
  }
  metric {
    type: "video_completion_rate"
    value: 0.5191752910614014
    vendor: "EXCHANGE"
  }
  rwdd: true
  [com.google.doubleclick.imp] {
    billing_id: 11004606416
    publisher_settings_list_id: 8773808361916105146
    publisher_settings_list_id: 3073503389278955207
    allowed_vendor_type: 39523
    allowed_vendor_type: 237
    is_rewarded_inventory: true
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "O5O88B57"
      versions: "2.0"
      versions: "2.1"
      fidelities: VIEW_THROUGH_ADS
      fidelities: STOREKIT_RENDERED_ADS
      skoverlay: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "4.90.0"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7879459471889169"
    [com.google.doubleclick.publisher] {
      country: "TR"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "ar"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "SAU"
    region: "SA-02"
    city: "Jiddah"
    type: IP
    utcoffset: 180
    accuracy: 25209
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1012089
    }
  }
  ipv6: "2001:16a4:253::"
  make: "Apple"
  model: "iPhone12,1"
  os: "iOS"
  osv: "17.4.1"
  connectiontype: CELL_4G
  devicetype: HIGHEND_PHONE
  ifa: "cd6a5706-5a73-4ab8-a2bb-cd19244bf295"
  lmt: false
  hwv: "iPhone12,1"
  w: 896
  h: 414
  pxratio: 2.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "17"
      version: "4"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 3
  }
}
user {
  id: "19G1O820z9ay0DxfvVm89xd7Gbh"
  [com.google.doubleclick.user] {
    session {
    }
    idage: 2592000
  }
}
at: FIRST_PRICE
tmax: 1500
cur: "USD"
bcat: "IAB7-39"
bcat: "IAB14-1"
bapp: "372513032"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.7.0"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z8zAo9-0x39o5pDG1Y19AT868LK88gvsh49Y6357Sb40978n97j8nn75XXGGp19xFp5E"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Mostrami l'esempio

{
  "id": "Z75GBa308fk6hn20L15573",
  "imp": [
    {
      "id": "1",
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "maxduration": 600,
        "w": 808,
        "h": 393,
        "startdelay": 0,
        "playbackmethod": [
          1
        ],
        "pos": 7,
        "api": [
          3,
          5
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 5,
        "playbackend": 1,
        "maxseq": 2,
        "poddur": 30,
        "plcmt": 3,
        "ext": {
          "inferredplcmt": 3
        }
      },
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "11.7.0",
      "instl": 1,
      "tagid": "4967856214",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.1879923790693283,
          "vendor": "EXCHANGE"
        },
        {
          "type": "video_completion_rate",
          "value": 0.5191752910614014,
          "vendor": "EXCHANGE"
        }
      ],
      "rwdd": 1,
      "ext": {
        "billing_id": [
          "11004606416"
        ],
        "publisher_settings_list_id": [
          "8773808361916105146",
          "3073503389278955207"
        ],
        "allowed_vendor_type": [
          39523,
          237
        ],
        "is_rewarded_inventory": 1,
        "ampad": 2,
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "O5O88B57"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            0,
            1
          ],
          "skoverlay": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "4.90.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7879459471889169",
      "ext": {
        "country": "TR"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ar"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "SAU",
      "region": "SA-02",
      "city": "Jiddah",
      "type": 2,
      "utcoffset": 180,
      "accuracy": 25209,
      "ext": {
        "geo_criteria_id": 1012089
      }
    },
    "ipv6": "2001:16a4:253::",
    "make": "Apple",
    "model": "iPhone12,1",
    "os": "iOS",
    "osv": "17.4.1",
    "connectiontype": 6,
    "devicetype": 4,
    "ifa": "cd6a5706-5a73-4ab8-a2bb-cd19244bf295",
    "lmt": 0,
    "hwv": "iPhone12,1",
    "w": 896,
    "h": 414,
    "pxratio": 2.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "17",
          "4"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 3
    }
  },
  "user": {
    "id": "19G1O820z9ay0DxfvVm89xd7Gbh",
    "ext": {
      "idage": 2592000
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB7-39",
    "IAB14-1"
  ],
  "bapp": [
    "372513032"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v11.7.0",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z8zAo9-0x39o5pDG1Y19AT868LK88gvsh49Y6357Sb40978n97j8nn75XXGGp19xFp5E",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "\r[\217Z\313$\317\325\226\261\321\1775\317O7#\003\232\315\322y\242"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "ja"
adslot {
  id: 1
  width: 393
  width: 375
  height: 734
  height: 667
  excluded_attribute: 17
  excluded_attribute: 20
  allowed_vendor_type: 38523
  allowed_vendor_type: 797
  matching_ad_data {
    billing_id: 95400492935
    minimum_cpm_micros: 1610000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 2826108213
  publisher_settings_list_id: 4043976311652409571
  viewability: 87
  click_through_rate: 0.2761753
  video_completion_rate: 0.43977627
  is_rewarded: true
  allowed_ad_types: ALLOWED_AD_TYPE_VIDEO
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 1
  api: OMID_1
  api: MRAID_1
  omidpn: "Google"
  omidpv: "afma-sdk-i-v9.14.0"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
  display_manager: "GoogleMobileAds-iOS"
  display_manager_version: "9.14.0"
}
is_test: false
cookie_version: 1
google_user_id: "502CF94564uk2a9qWk698927A00"
timezone_offset: 540
mobile {
  app_id: "751592940"
  is_app: true
  is_interstitial_request: true
  is_mobile_web_optimized: true
  encrypted_advertising_id: "\371\014\274[\224\356\250D\210\224\023\2518\230P.\000\325j1\310\341\215i\336\2063\213a\276b\263\236\201\007n"
  app_name: "Test App"
  advertising_id: "}\372\006\246c\347\275s\243|\353\326\272\305\021|"
  skadn {
    sourceapp: "751592940"
    skadnetids: "113tdmXM"
    versions: "2.0"
    versions: "2.1"
    supported_fidelity_types: STOREKIT_RENDERED_ADS
    supported_fidelity_types: VIEW_THROUGH_ADS
  }
}
video {
  videoad_start_delay: 0
  video_ad_skippable: REQUIRE_SKIPPABLE
  skippable_max_ad_duration: 600000
  allowed_video_formats: VIDEO_MP4
  max_ads_in_pod: 2
  end_cap_support: END_CAP_OPTIONAL
  playback_method: AUTO_PLAY_SOUND_ON
  is_clickable: true
  placement: INTERSTITIAL
  protocols: VAST_2_0
  protocols: VAST_3_0
  is_livestream: false
  playback_cessation_mode: COMPLETION_OR_USER
  max_pod_duration_seconds: 30
  plcmt: PLCMT_INTERSTITIAL
  inferred_plcmt: PLCMT_INTERSTITIAL
}
cookie_age_seconds: 1987200
geo_criteria_id: 9198798
publisher_settings_list_id: 11747008975924952385
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 2681496334840881279
device {
  device_type: HIGHEND_PHONE
  platform: "iphone"
  brand: "Apple"
  model: "iPhone17,1"
  os_version {
    major: 18
    minor: 0
    micro: 1
  }
  carrier_id: 0
  screen_width: 393
  screen_height: 852
  screen_pixel_ratio_millis: 3000
  screen_orientation: PORTRAIT
  hardware_version: "iPhone17,1"
  limit_ad_tracking: false
  app_tracking_authorization_status: AUTHORIZED
  connection_type: WIFI
}
publisher_country: "JP"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 1000
google_query_id: "ANy-zFwQ7x-eW9k8bHJRKvLLM9e761HV19R7ov42ZD0Xgyt270Y690867s819cwM7RA163W7"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "JPN"
  region: "JP-34"
  city: "Hiroshima"
  utcoffset: 540
  accuracy: 6105
}
user_agent_data {
  platform {
    brand: "iPhone"
    version: "18"
    version: "0"
  }
  mobile: true
  model: "iPhone"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "605"
    version: "1"
  }
  bitness: "64"
  source: USER_AGENT_STRING
}
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_DEVICE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"
session_duration_seconds: 370

App nativa

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "3rF2U7Feg24806GjUY2Lr5"
imp {
  id: "1"
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.3.0"
  tagid: "3320317218"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    api: MRAID_1
    api: MRAID_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
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 5
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 6
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
    }
  }
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.10741956532001495
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.58
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 29846056590
    publisher_settings_list_id: 4793646945897060511
    publisher_settings_list_id: 3704654811398966070
    allowed_vendor_type: 780
    allowed_vendor_type: 237
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    billable_event_rate_bid_adjustment {
      bid_adjustment: 1.2858465
      creative_type: NATIVE
    }
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-9497839363952914"
    [com.google.doubleclick.publisher] {
      country: "HK"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.4"
    livestream: false
    language: "ar"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "EGY"
    region: "EG-ALX"
    city: "Alexandria"
    type: IP
    utcoffset: 180
    accuracy: 2052
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9198011
    }
  }
  make: "Xiaomi"
  model: "M2006C3MG"
  os: "android"
  osv: "10"
  connectiontype: CELL_4G
  devicetype: HIGHEND_PHONE
  lmt: false
  w: 360
  h: 725
  pxratio: 2.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "10"
    }
    mobile: true
    model: "M2006C3MG"
    source: USER_AGENT_STRING
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 14
    }
  }
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v243799999.232400000.1"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z2g135-A631Sj54M16BCG6dC277E40D9nL3r921i0k2974f1q051601623F0i9232692"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    non_personalized_ads_reason: USER_OPT_OUT
    allow_user_data_collection: false
  }
}

Mostrami l'esempio

{
  "id": "3rF2U7Feg24806GjUY2Lr5",
  "imp": [
    {
      "id": "1",
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.3.0",
      "tagid": "3320317218",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "api": [
          3,
          5
        ],
        "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,\"data\":{\"type\":1,\"len\":25}},{\"id\":5,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":6,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1}"
      },
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.10741956532001495,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.58,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "29846056590"
        ],
        "publisher_settings_list_id": [
          "4793646945897060511",
          "3704654811398966070"
        ],
        "allowed_vendor_type": [
          780,
          237
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "billable_event_rate_bid_adjustment": [
          {
            "bid_adjustment": 1.2858465,
            "creative_type": 3
          }
        ],
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-9497839363952914",
      "ext": {
        "country": "HK"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.4",
      "livestream": 0,
      "language": "ar"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "EGY",
      "region": "EG-ALX",
      "city": "Alexandria",
      "type": 2,
      "utcoffset": 180,
      "accuracy": 2052,
      "ext": {
        "geo_criteria_id": 9198011
      }
    },
    "make": "Xiaomi",
    "model": "M2006C3MG",
    "os": "android",
    "osv": "10",
    "connectiontype": 6,
    "devicetype": 4,
    "lmt": 0,
    "w": 360,
    "h": 725,
    "pxratio": 2.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "10"
        ]
      },
      "mobile": 1,
      "model": "M2006C3MG",
      "source": 3
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 14
      }
    }
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v243799999.232400000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z2g135-A631Sj54M16BCG6dC277E40D9nL3r921i0k2974f1q051601623F0i9232692",
    "fcap_scope": 2,
    "privacy_treatments": {
      "non_personalized_ads_reason": [
        3
      ],
      "allow_user_data_collection": 0
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "\\>\313j\000>Rh\321\301\367[\212\'j\204\273/\242\304\231\221\335"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "ja"
adslot {
  id: 1
  excluded_attribute: 25
  excluded_attribute: 34
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  excluded_sensitive_category: 36
  excluded_sensitive_category: 4
  matching_ad_data {
    billing_id: 41106584355
    billing_id: 30773030290
    minimum_cpm_micros: 130000
  }
  slot_visibility: ABOVE_THE_FOLD
  excluded_product_category: 10031
  ad_block_key: 1332130058
  publisher_settings_list_id: 8685019249309350543
  publisher_settings_list_id: 9740837501405857020
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  viewability: 83
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  api: MRAID_1
  api: MRAID_2
  native_ad_template {
    required_fields: 83
    recommended_fields: 388
    headline_max_safe_length: 25
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    image_width: 1200
    image_height: 627
    app_icon_width: 100
    app_icon_height: 100
  }
  omidpn: "Google"
  omidpv: "afma-sdk-i-v11.5.0"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 14400
  billable_event_rate_bid_adjustment {
    bid_adjustment: 1.0
    creative_type: NATIVE
  }
  supported_auction_environment: SERVER_SIDE_AUCTION
  display_manager: "GoogleMobileAds-iOS"
  display_manager_version: "11.5.0"
}
is_test: false
timezone_offset: 540
mobile {
  app_id: "627009739"
  is_app: true
  is_mobile_web_optimized: true
  app_name: "Test App"
  skadn {
    sourceapp: "627009739"
    skadnetids: "l6x39K4z"
    versions: "2.0"
    versions: "2.1"
    supported_fidelity_types: STOREKIT_RENDERED_ADS
    supported_fidelity_types: VIEW_THROUGH_ADS
  }
}
postal_code: "10011"
geo_criteria_id: 9161820
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: HIGHEND_PHONE
  platform: "iphone"
  brand: "Apple"
  model: "iPhone10,3"
  os_version {
    major: 16
    minor: 7
    micro: 10
  }
  carrier_id: 0
  screen_width: 375
  screen_height: 812
  screen_pixel_ratio_millis: 3000
  screen_orientation: PORTRAIT
  hardware_version: "iPhone10,3"
  limit_ad_tracking: true
  app_tracking_authorization_status: RESTRICTED
  connection_type: WIFI
}
publisher_country: "US"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-zrk77i-KbW4i79W0c018hwPx3aS9rl10TU52SMd7Sv82r01g5O4D20sxKTj53Xrr9VK0"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "JPN"
  region: "JP-36"
  zip: "771-0212"
  utcoffset: 540
  accuracy: 1031
}
user_agent_data {
  platform {
    brand: "iPhone"
    version: "16"
    version: "7"
  }
  mobile: true
  model: "iPhone"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "605"
    version: "1"
  }
  bitness: "64"
  source: USER_AGENT_STRING
}
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"

Video sul Web

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "474xe8G3edB9ZG60IaK880"
imp {
  id: "1"
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    w: 300
    h: 250
    playbackmethod: ENTER_SOUND_OFF
    pos: ABOVE_THE_FOLD
    api: OMID_1
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: IN_ARTICLE_PLACEMENT
    playbackend: LEAVING_OR_USER
    plcmt: PLCMT_NO_CONTENT_STANDALONE
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_NO_CONTENT_STANDALONE
      embeddedoffsite: true
    }
  }
  displaymanager: "GOOGLE"
  tagid: "8378930064"
  bidfloor: 0.19
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0012572698760777712
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.62
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 47460168025
    publisher_settings_list_id: 5764601004062573461
    publisher_settings_list_id: 9583254202940413383
    allowed_vendor_type: 3
    allowed_vendor_type: 42
    dfp_ad_unit_code: "/3049200/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    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
    }
    allowed_restricted_category: 33
    allowed_restricted_category: 32
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    livestream: false
    producer {
    }
    language: "en"
  }
  mobile: true
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: "OMITTED"
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "TX"
    metro: "618"
    city: "Houston"
    zip: "77032"
    type: IP
    utcoffset: -300
    accuracy: 3682
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9027607
    }
  }
  ipv6: "2600:100d:b045::"
  carrier: "70092"
  make: "Samsung"
  model: "sm-a037u"
  os: "android"
  osv: "13"
  devicetype: HIGHEND_PHONE
  lmt: false
  w: 412
  h: 915
  pxratio: 1.75
  sua {
    browsers {
      brand: "Google Chrome"
      version: "129"
      version: "0"
    }
    browsers {
      brand: "Not=A?Brand"
      version: "8"
      version: "0"
    }
    platform {
      brand: "Android"
      version: "13"
      version: "0"
    }
    mobile: true
    model: "SM-A037U"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  buyeruid: "8cw7780874mg61q5MBecJyQ8hXIoYQPM"
  customdata: "l7898Ufx682216u9F0WUQsxMFr1956dw76p8ZAdpwA3586Y2"
  data {
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 601
    }
  }
  [com.google.doubleclick.user] {
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: 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
      }
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  bid_feedback {
    request_id: "V68ZT9H20868b1ze4z5rWa"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_175726"
    minimum_bid_to_win: 8.62
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-z732H2-9Z57W2Ufp82238m3DQ5T47oEIDlSkITGYWkX1CgL2VPch1wbeQV6kb1631u7h"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

Mostrami l'esempio

{
  "id": "474xe8G3edB9ZG60IaK880",
  "imp": [
    {
      "id": "1",
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "w": 300,
        "h": 250,
        "playbackmethod": [
          6
        ],
        "pos": 1,
        "api": [
          7
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 3,
        "playbackend": 2,
        "plcmt": 4,
        "ext": {
          "inferredplcmt": 4,
          "embeddedoffsite": 1
        }
      },
      "displaymanager": "GOOGLE",
      "tagid": "8378930064",
      "bidfloor": 0.19,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0012572698760777712,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.62,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "47460168025"
        ],
        "publisher_settings_list_id": [
          "5764601004062573461",
          "9583254202940413383"
        ],
        "allowed_vendor_type": [
          3,
          42
        ],
        "dfp_ad_unit_code": "/3049200/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test 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
        },
        "allowed_restricted_category": [
          33,
          32
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "US"
      }
    },
    "content": {
      "livestream": 0,
      "language": "en"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "USA",
      "region": "TX",
      "metro": "618",
      "city": "Houston",
      "zip": "77032",
      "type": 2,
      "utcoffset": -300,
      "accuracy": 3682,
      "ext": {
        "geo_criteria_id": 9027607
      }
    },
    "ipv6": "2600:100d:b045::",
    "carrier": "70092",
    "make": "Samsung",
    "model": "sm-a037u",
    "os": "android",
    "osv": "13",
    "devicetype": 4,
    "lmt": 0,
    "w": 412,
    "h": 915,
    "pxratio": 1.75,
    "sua": {
      "browsers": [
        {
          "brand": "Google Chrome",
          "version": [
            "129",
            "0"
          ]
        },
        {
          "brand": "Not=A?Brand",
          "version": [
            "8",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "13",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SM-A037U",
      "source": 2
    }
  },
  "user": {
    "buyeruid": "8cw7780874mg61q5MBecJyQ8hXIoYQPM",
    "customdata": "l7898Ufx682216u9F0WUQsxMFr1956dw76p8ZAdpwA3586Y2",
    "data": [
      {
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 601
        }
      }
    ],
    "ext": {
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        },
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED"
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          },
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "bid_feedback": [
      {
        "request_id": "V68ZT9H20868b1ze4z5rWa",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_175726",
        "minimum_bid_to_win": 8.62,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-z732H2-9Z57W2Ufp82238m3DQ5T47oEIDlSkITGYWkX1CgL2VPch1wbeQV6kb1631u7h",
    "fcap_scope": 1
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "J#\010\024\351\000\207\247\265\033\315\nA\251\257}\216\313\206\214\323\312\215"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "ja"
adslot {
  id: 1
  width: 1176
  width: 480
  height: 1046
  height: 800
  excluded_attribute: 7
  excluded_attribute: 16
  allowed_vendor_type: 4513
  allowed_vendor_type: 485
  excluded_sensitive_category: 36
  excluded_sensitive_category: 31
  matching_ad_data {
    billing_id: 75752641104
    billing_id: 20395399239
    minimum_cpm_micros: 40000
  }
  matching_ad_data {
    billing_id: 97958384088
    billing_id: 56530052009
    minimum_cpm_micros: 530000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 5888439717
  publisher_settings_list_id: 4545709109957121468
  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: 86
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  renderer: GOOGLE
  is_rewarded: true
  allowed_ad_types: ALLOWED_AD_TYPE_VIDEO
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 1
  api: OMID_1
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_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
cookie_version: 1
google_user_id: "0bQri772Ba4h145n2m5dRK2e7IM"
timezone_offset: 540
mobile {
  is_interstitial_request: true
}
video {
  max_ad_duration: 30000
  video_ad_skippable: BLOCK_SKIPPABLE
  allowed_video_formats: VIDEO_MP4
  end_cap_support: END_CAP_OPTIONAL
  playback_method: CLICK_TO_PLAY
  is_clickable: true
  placement: INTERSTITIAL
  protocols: VAST_2_0
  protocols: VAST_3_0
  playback_cessation_mode: COMPLETION_OR_USER
  plcmt: PLCMT_INTERSTITIAL
  inferred_plcmt: PLCMT_INTERSTITIAL
}
cookie_age_seconds: 57024000
hosted_match_data: "\207r9\204\322\022\324Ezf\263\305\373\3153\311\271i\305"
geo_criteria_id: 1009341
publisher_settings_list_id: 6038657471597087436
bid_response_feedback {
  request_id: "\373\263!2t;\224C\363\372\224\220\376red"
  creative_status_code: 79
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_378410"
  minimum_bid_to_win: 114000000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 3153428956954513893
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  limit_ad_tracking: false
}
publisher_country: "JP"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zz9y8d-2p0141lC5k418ht4e0FOF2M06a40So6pmPJim2U4LWw2hERI5310mnf649802"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "JPN"
  region: "JP-14"
  city: "Saiwai"
  utcoffset: 540
  accuracy: 1785
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Google Chrome"
    version: "129"
    version: "0"
  }
  browsers {
    brand: "Not=A?Brand"
    version: "8"
    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_BROWSER
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Banner web mobile per l'offerente della piattaforma di scambio pubblicitario

OpenRTB ProtobufJSON OpenRTB

Mostrami l'esempio

Richiesta serializzata

id: "W5rO389B0p836803G6tI3T"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    expdir: LEFT
    expdir: RIGHT
    expdir: UP
    expdir: DOWN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 320
      h: 50
    }
    format {
      w: 320
      h: 100
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "23.1.0"
  tagid: "3758755668"
  bidfloor: 0.11
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "viewability"
    value: 0.71
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50962964480
    dfp_ad_unit_code: "/5025729/google/test"
    ampad: AMP_AD_NOT_ALLOWED
    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
  }
}
app {
  name: "Test App"
  ver: "6.8.1"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-6120362493380457"
    [com.google.doubleclick.publisher] {
      country: "PL"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.5"
    livestream: false
    language: "pl"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "POL"
    region: "PL-MZ"
    city: "Warsaw"
    zip: "04"
    type: IP
    utcoffset: 120
    accuracy: 2263
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9061066
    }
  }
  carrier: "70872"
  make: "Samsung"
  model: "SM-A346B"
  os: "android"
  osv: "14"
  connectiontype: CELL_4G
  devicetype: HIGHEND_PHONE
  ifa: "1f3ed9c7-e8d8-4cec-9167-2811375e2cbe"
  lmt: false
  w: 384
  h: 758
  pxratio: 2.813
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "14"
    }
    mobile: true
    bitness: "64"
    model: "SM-A346B"
    source: USER_AGENT_STRING
  }
}
user {
  id: "a9S5d7s7r38o1q8ifv4U80GBxKA"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1215
      consented_providers: 2567
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 464
    }
    idage: 25920000
  }
}
at: FIRST_PRICE
tmax: 1000
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] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v243799999.241199000.1"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z4luKF-u274F3WU34uUUoQ7E82k3L42z23v2K4T1k0eA7Rw8Xb6JeXDG6K703e88p491"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
}

Mostrami l'esempio

{
  "id": "W5rO389B0p836803G6tI3T",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 320,
        "h": 50,
        "pos": 1,
        "expdir": [
          1,
          2,
          3,
          4
        ],
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 320,
            "h": 50
          },
          {
            "w": 320,
            "h": 100
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "23.1.0",
      "tagid": "3758755668",
      "bidfloor": 0.11,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "viewability",
          "value": 0.71,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50962964480"
        ],
        "dfp_ad_unit_code": "/5025729/google/test",
        "ampad": 2,
        "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
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "6.8.1",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6120362493380457",
      "ext": {
        "country": "PL"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.5",
      "livestream": 0,
      "language": "pl"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "POL",
      "region": "PL-MZ",
      "city": "Warsaw",
      "zip": "04",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 2263,
      "ext": {
        "geo_criteria_id": 9061066
      }
    },
    "carrier": "70872",
    "make": "Samsung",
    "model": "SM-A346B",
    "os": "android",
    "osv": "14",
    "connectiontype": 6,
    "devicetype": 4,
    "ifa": "1f3ed9c7-e8d8-4cec-9167-2811375e2cbe",
    "lmt": 0,
    "w": 384,
    "h": 758,
    "pxratio": 2.813,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "14"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "SM-A346B",
      "source": 3
    }
  },
  "user": {
    "id": "a9S5d7s7r38o1q8ifv4U80GBxKA",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1215",
          "2567"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 464
      },
      "idage": 25920000
    }
  },
  "at": 1,
  "tmax": 1000,
  "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": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v243799999.241199000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z4luKF-u274F3WU34uUUoQ7E82k3L42z23v2K4T1k0eA7Rw8Xb6JeXDG6K703e88p491",
    "fcap_scope": 3
  }
}

Video e nativi multiformato

OpenRTB ProtobufJSON OpenRTBGoogle (deprecato)

Mostrami l'esempio

Richiesta serializzata

id: "o9j8MO3eW468670y7CVv1A"
imp {
  id: "1"
  banner {
    w: 300
    h: 250
    pos: ABOVE_THE_FOLD
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    api: MRAID_1
    api: MRAID_2
    format {
      w: 300
      h: 250
    }
    format {
      w: 320
      h: 50
    }
  }
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    w: 300
    h: 250
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    playbackmethod: ENTER_SOUND_OFF
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: IN_FEED_PLACEMENT
    playbackend: LEAVING_OR_USER
    plcmt: PLCMT_NO_CONTENT_STANDALONE
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_NO_CONTENT_STANDALONE
      embeddedoffsite: true
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.3.0"
  tagid: "6247365183"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    api: MRAID_1
    api: MRAID_2
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    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
          len: 15
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
    }
  }
  exp: 3600
  clickbrowser: true
  metric {
    type: "viewability"
    value: 0.64
    vendor: "EXCHANGE"
  }
  metric {
    type: "session_depth"
    value: 7.0
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 21221902373
    billing_id: 53569531917
    publisher_settings_list_id: 7651048085774412615
    publisher_settings_list_id: 3305930710629093223
    allowed_vendor_type: 3
    allowed_vendor_type: 42
    ampad: AMP_AD_NOT_ALLOWED
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    billable_event_rate_bid_adjustment {
      bid_adjustment: 1.1452553
      creative_type: HTML_SNIPPET
    }
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "14.27.7"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8822142511593237"
    [com.google.doubleclick.publisher] {
      country: "SE"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.5"
    livestream: false
    producer {
    }
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "NGA"
    region: "NG-LA"
    city: "Lagos"
    zip: "106104"
    type: IP
    utcoffset: 60
    accuracy: 1559
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9198908
    }
  }
  make: "Xiaomi"
  model: "23129RAA4G"
  os: "android"
  osv: "14"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "94b6ef8c-99d8-4997-98d2-c2377bd7abd1"
  lmt: false
  w: 393
  h: 792
  pxratio: 2.75
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "14"
    }
    mobile: true
    bitness: "64"
    model: "23129RAA4G"
    source: USER_AGENT_STRING
  }
}
user {
  id: "04X9BE2175274aL0C296l24WI68"
  [com.google.doubleclick.user] {
    session {
      duration: 439
    }
    idage: 7776000
  }
}
at: FIRST_PRICE
tmax: 1500
cur: "USD"
cur: "EUR"
bcat: "IAB23-9"
bcat: "IAB14-1"
bapp: "com.ayoba.ayoba"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v243799999.232400000.1"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zM284h-2Q24Y9v315v54F50lLaqQ3hq549685jR3ack28k6J6Ko65F1aS73r197eM8zX"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: false
  }
}

Mostrami l'esempio

{
  "id": "o9j8MO3eW468670y7CVv1A",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "pos": 1,
        "battr": [
          6,
          7
        ],
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 300,
            "h": 250
          },
          {
            "w": 320,
            "h": 50
          }
        ]
      },
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "w": 300,
        "h": 250,
        "battr": [
          6,
          7
        ],
        "playbackmethod": [
          6
        ],
        "pos": 1,
        "api": [
          3,
          5
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 4,
        "playbackend": 2,
        "plcmt": 4,
        "ext": {
          "inferredplcmt": 4,
          "embeddedoffsite": 1
        }
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.3.0",
      "tagid": "6247365183",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "api": [
          3,
          5
        ],
        "battr": [
          6,
          7
        ],
        "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,\"required\":1,\"img\":{\"type\":1,\"wmin\":100,\"hmin\":100}},{\"id\":6,\"data\":{\"type\":3,\"len\":5}},{\"id\":7,\"data\":{\"type\":6,\"len\":15}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1}"
      },
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "viewability",
          "value": 0.64,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 7.0,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "21221902373",
          "53569531917"
        ],
        "publisher_settings_list_id": [
          "7651048085774412615",
          "3305930710629093223"
        ],
        "allowed_vendor_type": [
          3,
          42
        ],
        "ampad": 2,
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "billable_event_rate_bid_adjustment": [
          {
            "bid_adjustment": 1.1452553,
            "creative_type": 1
          }
        ],
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "14.27.7",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-8822142511593237",
      "ext": {
        "country": "SE"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.5",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "NGA",
      "region": "NG-LA",
      "city": "Lagos",
      "zip": "106104",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 1559,
      "ext": {
        "geo_criteria_id": 9198908
      }
    },
    "make": "Xiaomi",
    "model": "23129RAA4G",
    "os": "android",
    "osv": "14",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "94b6ef8c-99d8-4997-98d2-c2377bd7abd1",
    "lmt": 0,
    "w": 393,
    "h": 792,
    "pxratio": 2.75,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "14"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "23129RAA4G",
      "source": 3
    }
  },
  "user": {
    "id": "04X9BE2175274aL0C296l24WI68",
    "ext": {
      "session": {
        "duration": 439
      },
      "idage": 7776000
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "USD",
    "EUR"
  ],
  "bcat": [
    "IAB23-9",
    "IAB14-1"
  ],
  "bapp": [
    "com.ayoba.ayoba"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v243799999.232400000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zM284h-2Q24Y9v315v54F50lLaqQ3hq549685jR3ack28k6J6Ko65F1aS73r197eM8zX",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 0
    }
  }
}

Mostrami l'esempio

Richiesta serializzata

id: "\3213\327N\305\205|\363P-\002\271\321\255\2422a\336\344w\032\315\364"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "ko"
adslot {
  id: 1
  width: 336
  width: 300
  height: 280
  height: 250
  excluded_attribute: 16
  excluded_attribute: 34
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  excluded_sensitive_category: 36
  excluded_sensitive_category: 27
  matching_ad_data {
    billing_id: 46229095026
    minimum_cpm_micros: 6000000
    direct_deal {
      direct_deal_id: 41020803
      fixed_cpm_micros: 6000000
      deal_type: AUCTION_PACKAGE
    }
    direct_deal {
      direct_deal_id: 83063356
      fixed_cpm_micros: 6000000
      deal_type: AUCTION_PACKAGE
    }
  }
  matching_ad_data {
    billing_id: 97161713426
    billing_id: 54565593373
    minimum_cpm_micros: 60000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10031
  excluded_product_category: 10080
  ad_block_key: 1676780364
  publisher_settings_list_id: 4302366834898588447
  publisher_settings_list_id: 5535773595467535705
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 3
  click_through_rate: 0.00045286646
  renderer: GOOGLE
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  session_depth: 1
  api: OMID_1
  flexible_adslot_settings {
    max_width: 412
    max_height: 371
    min_width: 300
    min_height: 250
  }
  native_ad_template {
    required_fields: 81
    recommended_fields: 132
    headline_max_safe_length: 25
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    image_width: 1200
    image_height: 627
    app_icon_width: 100
    app_icon_height: 100
    style_id: 188124
    style_height: 250
    style_width: 300
  }
  native_ad_template {
    required_fields: 25
    recommended_fields: 36
    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
    logo_width: 100
    logo_height: 100
    style_id: 192343
    style_height: 250
    style_width: 300
  }
  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
cookie_version: 1
google_user_id: "s13Tq1N7711701GoYey29S07G4O"
timezone_offset: 540
mobile {
  app_id: "com.google.testapp"
  is_app: false
  is_mobile_web_optimized: true
  app_name: "Test App"
  app_rating: 4.0387864
}
video {
  video_ad_skippable: ALLOW_SKIPPABLE
  allowed_video_formats: VIDEO_MP4
  playback_method: INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF
  is_clickable: true
  placement: IN_ARTICLE
  protocols: VAST_2_0
  protocols: VAST_3_0
  playback_cessation_mode: LEAVING_OR_USER
  plcmt: PLCMT_NO_CONTENT_STANDALONE
  inferred_plcmt: PLCMT_NO_CONTENT_STANDALONE
}
cookie_age_seconds: 28512000
hosted_match_data: "\017\345\237\340\225\030\327\003\332\303-\t\267\244E\365*K\367"
geo_criteria_id: 9207704
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "Samsung"
  model: "sm-n981n"
  os_version {
    major: 13
  }
  carrier_id: 0
  screen_width: 412
  screen_height: 915
  screen_pixel_ratio_millis: 2625
  screen_orientation: PORTRAIT
  limit_ad_tracking: false
}
publisher_country: "KR"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zPlGA9-Bn8zO1n4y6DiyW32gF8LE7901694954EJXoV4WF7nMGDL3Ao08pJ88w463SK6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "KOR"
  region: "KR-29"
  city: "Gwangju"
  utcoffset: 540
  accuracy: 3889
}
user_agent_data {
  platform {
    brand: "Android"
    version: "13"
    version: "0"
  }
  mobile: true
  model: "SM-N981N"
  browsers {
    brand: "Chromium"
    version: "130"
    version: "0"
  }
  browsers {
    brand: "Android WebView"
    version: "130"
    version: "0"
  }
  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_BROWSER
privacy_treatments {
  allow_user_data_collection: false
}
inventory_partner_domain: "OMITTED"
navigation_type: NAVIGATION_TYPE_NAVIGATE