Anúncios nativos

Os anúncios nativos são formatados para se ajustarem ao conteúdo e aos recursos visuais ao redor design, aumentando a probabilidade de serem visualizados e clicados pelos usuários. Anúncio nativo está disponível em apps para dispositivos móveis, bem como em sites para dispositivos móveis e computadores. Para mais informações sobre anúncios nativos, consulte Visão geral de anúncios nativos anúncios.

Os anúncios nativos são compatíveis com Authorized Buyers e Open Bidding

Veja o fluxo de trabalho dos anúncios nativos:

1. Uma chamada de anúncio nativo é feita ao Google. A chamada especifica um ou ambos os modelos de anúncios nativos abaixo, cada um especificando o campos nativos.
2. O Google envia aos compradores uma solicitação de lance RTB contendo uma lista dos campos que estão sendo solicitados.
3. Os compradores interessados respondem com os campos solicitados.
4. O Google realiza um leilão para selecionar o lance vencedor e envia o os recursos do criativo fornecidos pelo comprador ao editor.
5. O editor monta os recursos em um anúncio nativo e os estiliza para se adequar ao design do site.

Formatos de mensagem

O Google suporta Especificação do OpenRTB em JSON e Protobuf.

Para anúncios nativos em Protobuf do OpenRTB, os seguintes campos são diferentes da especificação:

Especificação JSON (PROTOCOL_OPENRTB_2_4)	Tipo de JSON	Implementação do OpenRTB (PROTOCOL_OPENRTB_PROTOBUF_2_4)	Tipo do OpenRTB
BidRequest.imp[].native.request	string	BidRequest.imp[].native.request_native	NativeRequest
BidResponse.seatbid[].bid[].adm	string	BidResponse.seatbid[].bid[].adm_native	NativeResponse

Os campos do OpenRTB são mensagens do Protobuf, e não strings.

Se você usar a implementação de Protobuf do OpenRTB, não vai receber BidRequest.imp[].native.request e responder com BidResponse.seatbid[].bid[].adm_native. Respostas de lance com BidResponse.seatbid[].bid[].adm foram filtradas. Os códigos de recurso não são necessários para o OpenRTB Respostas de lance do protobuf.

Se você usar um SDK do comprador para renderizar anúncios nativos, você precisa incluir uma imagem type no declared_ad ao enviar criativos para revisão.

Modelos de anúncios nativos

O Google oferece suporte aos dois modelos mais comuns de anúncios nativos para anúncios que não são de vídeo e anúncios nativos em vídeo:

• Modelo de anúncio de instalação de apps: promover e impulsionar instalações de apps para dispositivos móveis.
• Modelo de anúncio de conteúdo: mais genérico de texto e imagens para anúncios de marca ou da Web.
• Modelo de anúncio em vídeo de instalação de apps
• Modelo de anúncio de conteúdo em vídeo

Existem outros modelos, e eles podem ter um conjunto diferente de requisitos para campos, dimensões e tamanhos.

Modelo de anúncio de instalação de apps

Campos obrigatórios e recomendados

As tabelas abaixo mostram os campos rotulados como Obrigatório ou Recomendado. Aplicam-se as seguintes regras:

• Os campos marcados como Obrigatórios são obrigatórios para o bidder.
• Os campos marcados como Recomendado não são obrigatórios para o bidder, e o o editor poderá ou não exibi-los se forem fornecidos (por exemplo, marcar com estrela classificação).
• A call-to-action (CTA) é sempre marcada como Recomendada porque padrão será atribuído se não for enviado pelo proponente, mas sempre será serão exibidos, se enviados.

A tabela a seguir lista os campos de um modelo de anúncio de instalação de aplicativo. Os aplicativos para dispositivos móveis usam esses campos para criar anúncios nativos de instalação de apps.

Campo	Descrição	Obrigatório ou recomendado?	Sempre exibido?	Tamanho de imagem recomendado/número máximo de caracteres	Exemplo
Título	O título do app	Obrigatório	Sim	25 caracteres	Inundação!
Imagem	Uma captura de tela do app ou outra imagem relevante	Obrigatório	Não	1.200 px x 627 px ou 600 px x 600 px,dependendo da proporção necessária pelo editor.	<Uma captura de tela do jogo Flood-It!>
Corpo	Texto principal do app	Obrigatório	Não	90 caracteres	Simplesmente simples e desafiadores = deliciosamente viciante!
Ícone do app	O ícone do app	Obrigatório	Não	128 x 128 px	<Flood-it! ícone do app>
Call-to-action	Ação do usuário preferida	Recomendado	Sim	15 caracteres	Instalar
Star rating	O número de estrelas (0 a 5) representando classificação do app na app store	Recomendado	Não	0 a 5	4,5
Preço	Custo do app	Recomendado	Não	15 caracteres	Gratuito

Observações sobre o tamanho do texto

Se um comprador enviar um recurso de texto (corpo do texto, por exemplo) maior que o máximo sugerido de caracteres, o texto pode ficar truncado e cortadas pelo Google ou pelo editor. Observe que o truncamento têm metade do tamanho em chinês, japonês e coreano. Por exemplo, o o limite de títulos é 90 para inglês e 45 para chinês.

Observações sobre o tamanho da imagem

Os editores podem:

• Corte a imagem principal de forma simétrica em até 20% em uma dimensão (altura ou largura).
• Dimensione a imagem sem alterar a proporção.
• Imagens com proporções significativamente diferentes das implícitas por altura e largura podem ser filtradas.

Modelo de anúncio de conteúdo

A tabela a seguir lista os campos de um modelo de anúncio de conteúdo. Editoras use esses campos para criar anúncios de conteúdo nativo.

Campo	Descrição	Obrigatório ou recomendado?	Sempre exibido?	Tamanho de imagem recomendado/número máximo de caracteres *	Exemplo
Título	O cabeçalho do anúncio	Obrigatório	Sim	25 caracteres	Taxas de hipoteca mais baixas
Imagem	A imagem principal do anúncio	Obrigatório	Não	1.200 px x 627 px ou 600 px x 600 px,dependendo da proporção necessária pelo editor.	<Imagem principal do anúncio>
Corpo	O conteúdo do anúncio	Obrigatório	Não	90 caracteres	O lar do seu lar no Brooklyn. Mais barato e antes do que você imagina.
Logotipo	O logotipo do anunciante ou outra imagem pequena relevante	Recomendado	Não	128 x 128 px	<Logotipo da NY Mortgage Inc.>
Call-to-action	Ação preferida do usuário	Recomendado	Não	15 caracteres	Receber um orçamento
Advertiser	Texto que identifica o anunciante ou a marca	Obrigatório	Não	25 caracteres	Mortgage Inc. de Nova York

Modelo de anúncio em vídeo de instalação de apps

Campo	Descrição	Obrigatório ou recomendado?	Sempre exibido?	Tamanho da imagem recomendado/número máximo de caracteres *	Exemplo
Vídeo	É a resposta VAST de vídeo com todos os recursos necessários para reproduzir um anúncio em vídeo.	Obrigatório	Não	-	Um URL para XML VAST contendo um Flood-It! Anúncio em vídeo
Título	O título do app	Obrigatório	Sim	25 caracteres	Inundação!
Imagem	Imagem (miniatura) mostrada no player antes do clique no anúncio em vídeo ou durante o carregamento.	Obrigatório	Não	Precisa corresponder à proporção do vídeo (por exemplo, 1.280 x 720 para vídeos de 16 x 9, 4 x 3 para vídeos de 640 x 480).	Uma captura de tela do jogo Flood-It! Ou, no vídeo,
Corpo	Texto principal do app	Obrigatório	Não	90 caracteres	Simplesmente simples e desafiadores = deliciosamente viciante!
Ícone do app	O ícone do app	Obrigatório	Não	128 x 128 px	Flood-it! ícone do app
Call-to-action	Ação do usuário preferida	Obrigatório	Sim	15 caracteres	Instalar
Star rating	Número de estrelas (0 a 5) que representa a classificação do app na app store	Recomendado	Não	0 a 5	4,5
Preço	Custo do app	Recomendado	Não	15 caracteres	Gratuito

Restrições

• Vídeo: todos os vídeos precisam estar na forma de um URL VAST. ou uma tag VAST. Um arquivo de vídeo bruto como WebM, MP4 etc. não pode ser especificado.

• Comprimento do texto: se um comprador especificar um recurso de texto, como o body na resposta, ela pode ser truncada e reduzida por pelo Google ou pelo editor. Os limites de truncamento têm metade do tamanho em chinês, japonês e coreano. Por exemplo, o limite de títulos é 90 em inglês. e 45 para chinês.

• Tamanho da imagem: os editores podem:

  • Cortar a imagem principal de forma simétrica em até 20% em uma dimensão (altura ou largura.
  • Dimensione a imagem sem alterar a proporção.

Exemplo de anúncio de instalação de apps

Modelo de anúncio de conteúdo em vídeo

Campo	Descrição	Obrigatório ou recomendado?	Sempre exibido?	Tamanho da imagem recomendado/número máximo de caracteres *	Exemplo
Vídeo	É a resposta VAST de vídeo com todos os recursos necessários para reproduzir um anúncio em vídeo.	Obrigatório	Sim	-	Um URL para XML VAST contendo um Flood-It! Anúncio em vídeo
Título	O cabeçalho do anúncio	Obrigatório	Sim	25 caracteres	Taxas de hipoteca mais baixas
Imagem	Imagem (miniatura) mostrada no player antes do clique no anúncio em vídeo ou durante o carregamento.	Obrigatório	Não	Precisa corresponder à proporção do vídeo (por exemplo, 1.280 x 720 para vídeos de 16 x 9, 4 x 3 para vídeos de 640 x 480).	Uma captura de tela do vídeo
Corpo	O conteúdo do anúncio	Obrigatório	Não	90 caracteres	O lar do seu lar no Brooklyn. Mais barato e antes do que você imagina.
Logotipo	O logotipo do anunciante ou outra imagem pequena relevante	Recomendado	Não	128 x 128 px	Logotipo da NY Mortgage Inc.
Call-to-action	Ação preferida do usuário	Obrigatório	Não	15 caracteres	Receber um orçamento
Advertiser	Texto que identifica o anunciante ou a marca	Obrigatório	Não	25 caracteres	Mortgage Inc. de Nova York

Campos meta

Os metacampos a seguir são compartilhados por todos os modelos de anúncios compatíveis:

Autorizado Buffer de protocolo em tempo real do comprador	Autorizado Equivalente ao OpenRTB dos compradores	Descrição
NativeAd.click_link_url	Link.url	O URL que será chamado pelo navegador quando o usuário clicar no anúncio. Pode ser a primeira etapa de uma cadeia de redirecionamento que acaba levando ao página de destino. Para anúncios nativos, recomendamos usar click_link_url como o campo a ser definido o destino para onde o usuário irá. É obrigatório usar este campo no caso das páginas de destino dinâmicas.
Ad.click_through_url	Bid.adomain	Precisa ser definido se o bidder pretende dar um lance. Esse é o conjunto de URLs do snippet, incluindo os URLs que o usuário acessará se clicam no anúncio exibido e todos os URLs visíveis na imagem anúncio. Não inclua chamadas intermediárias para o servidor de anúncios que não estejam relacionadas à a página de destino final. Um BidResponse que retorna um snippet ou anúncio em vídeo mas declarar que nenhum click_through_url será descartado. Somente definido este campo se html_snippet, video_url ou native_ad foram definidos. Esses dados são usados como um URL de destino por exemplo, para pós-filtragem de URLs ou blocos de anúncios bloqueados pelo editor categorização. Consulte o NativeAd.click_link_url acima ao usar anúncios nativos. Para anúncios não nativos, ele não é usado para rastreamento de cliques ou qualquer outro funcionalidade ele será usado somente como uma declaração de URL de destino. Para anúncios nativos, se NativeAd.click_link_url não estiver definido, o o primeiro valor de click_through_url é usado para direcionar o usuário para a página de destino. Além disso, todos os valores são usados como URL de destino declarações (semelhante ao caso não nativo).
NativeAd.click_tracking_urls	Link.clicktrackers	Opcional. URLs adicionais que permitem aos anunciantes rastrear os cliques dos usuários em o anúncio.
Ad.ad_choices_destination_url	BidExt.ad_choices_destination_url	Vincule a uma página de preferências de anúncios ou a uma página de desativação. Se estiver presente, um padrão O ícone "Opções de anúncios" é adicionado ao criativo nativo e vinculado a esse URL. Isso é compatível com anúncios nativos, mas não faz parte da mensagem nativa no resposta do lance.
Ad.impression_tracking_url	NativeResponse.imptrackers	A impressão nativa deve ser rastreada com impression_tracking_url em lances em tempo real do Authorized Buyers proto ou impressões nativas no OpenRTB.

Campos obrigatórios e recomendados

required_fields e recommended_fields são especificados pelo editor. Mostramos como para converter esses campos de bit a fim de determinar se um campo é obrigatório ou recomendado.

Um campo de bit usa cada bit de um valor binário para armazenar um valor verdadeiro ou falso equivalente, o que equivale a enviar muitos sinais booleanos, como is_logo_required, is_header_required etc., mas todas amontoadas.

Exemplo

Para este exemplo, usaremos um valor required_fields de 1085.

Primeiro, encontre o valor binário equivalente: 10000111101

Assim que tiver o valor binário, você poderá verificar os bits para ver se um campo está obrigatório (1) ou não obrigatório (0).

A tabela abaixo mapeia os campos para seus respectivos locais no valor binário. Leia o da direita para a esquerda, com o 1 bit correspondente à posição mais à direita no valor binário.

Campo	Canal de valor binário (da direita para a esquerda)
HEADLINE	1
BODY	2
CALL_TO_ACTION	4
ADVERTISER	8
IMAGE	16
LOGO	32
APP_ICON	64
STAR_RATING	128
PRICE	256
STORE	512
VIDEO	1024

Analisando o exemplo de valor binário 10000111101, o de 1 bit (mais à direita) é 1, que significa um valor obrigatório. De acordo com as tabela, o 1 bit corresponde a HEADLINE.

O de 2 bits (segundo valor da direita) é 0, que significa não é obrigatório. A de 2 bits corresponde a BODY.

Estes são todos os campos obrigatórios interpretados no exemplo:

Valor	Descrição	Obrigatório?
1	VIDEO	Sim
0	STORE	Não
0	PRICE	Não
0	STAR_RATING	Não
0	APP_ICON	Não
1	LOGO	Sim
1	IMAGE	Sim
1	ADVERTISER	Sim
1	CALL_TO_ACTION	Sim
0	BODY	Não
1	HEADLINE	Sim

Mensagem NativeAdTemplate

Ao receber uma solicitação de lance com inventário nativo, ela terá um preenchido BidRequest.adSlot[].native_ad_template. A mensagem NativeAdTemplate fornece especificações para:

• Campos obrigatórios ou recomendados.
• Dimensões para imagens, logotipos e ícones do app.
• Especificações do estilo em que o anúncio é renderizado.

.

Observação:no campo style_layout_type, PIXEL indica que a unidade nativa tem um tamanho fixo, enquanto FLUID significa que ele é dimensionado para preencher a largura da coluna de delimitação e ajusta a altura para manter a proporção. Quando FLUID for a altura e a largura podem ser 1 x 1.

message BidRequest {
  //...
  message AdSlot {
    //...

    message NativeAdTemplate {
      // Defines the bits used in required_fields and recommended_fields.
      // There is one bit for each of the fields in BidResponse.Ad.NativeAd
      enum Fields {
        NO_FIELDS = 0x0;
        HEADLINE = 0x1;
        BODY = 0x2;
        CALL_TO_ACTION = 0x4;
        ADVERTISER = 0x8;
        IMAGE = 0x10;
        LOGO = 0x20;
        APP_ICON = 0x40;
        STAR_RATING = 0x80;
        PRICE = 0x100;
        DEPRECATED_STORE = 0x200;
        VIDEO = 0x400;
      }

      // Bitfield describing which fields are required by the publisher. Bid
      // responses with no value for these fields will be rejected. Click
      // and view tracking urls are always implicitly required.
      optional int64 required_fields = 1;

      // Bitfield describing which fields are recommended by the publisher.
      // All recommended field are supported, but not all recommended fields
      // are required.
      optional int64 recommended_fields = 2;

      // max_safe_length indicates the maximum number of Unicode characters that
      // are guaranteed to be shown without truncation. Longer strings may be
      // truncated and ellipsized by Ad Exchange or the publisher during
      // rendering.
      optional int32 headline_max_safe_length = 3;
      optional int32 body_max_safe_length = 4;
      optional int32 call_to_action_max_safe_length = 5;
      optional int32 advertiser_max_safe_length = 6;
      optional int32 price_max_safe_length = 15;

      // The width and height from which to calculate the required aspect ratio.
      // You can provide a larger image in the response. Images that have aspect
      // ratios substantially different than those implied by the height and
      // width may be filtered.
      optional int32 image_width = 7;
      optional int32 image_height = 8;
      optional int32 logo_width = 9;
      optional int32 logo_height = 10;
      optional int32 app_icon_width = 11;
      optional int32 app_icon_height = 12;

      // Globally distinct id for the specific style, HTML, and CSS with which
      // the native ad is rendered.
      optional int32 style_id = 16;

      // Type of style layout for each native ad template.
      enum LayoutType {
        PIXEL = 0;
        FLUID = 1;
      }
      optional LayoutType style_layout_type = 17 [default = PIXEL];

      // If the style_layout_type is Pixel, width and height of the
      // entire native ad after rendering. If the style_layout_type is
      // Fluid, the style_height and style_width may optionally
      // not be populated.
      optional int32 style_height = 18;
      optional int32 style_width = 19;
    }
    repeated NativeAdTemplate native_ad_template = 51;
  }

    // NativePlacementType describes placement of native ad slot with respect to
    // surrounding context.
    enum NativePlacementType {
      PLACEMENT_UNKNOWN = 0;
      // In the feed of content - for example as an item inside the organic
      // feed/grid/listing/carousel.
      PLACEMENT_IN_FEED = 1;
      // In the atomic unit of the content - for example, in the article page or single
      // image page.
      PLACEMENT_ATOMIC_UNIT = 2;
      // Outside the core content - for example in the ads section on the right
      // rail, as a banner-style placement near the content, etc.
      PLACEMENT_OUTSIDE = 3;
      // Recommendation widget, most commonly presented below the article
      // content.
      PLACEMENT_RECOMMENDATION = 4;
    }

    optional NativePlacementType native_placement_type = 45;

  // ...
}

Mensagem NativeAd

Ao definir lances para inventário nativo, um comprador precisa preencher BidResponse.ad[].native_ad com campos obrigatórios declarados no BidRequest.adSlot[].native_ad_template correspondente.

Observação: alguns campos adicionais encontrados em BidResponse.Ad são também estão incluídas abaixo por serem relevantes para anúncios nativos.

message BidResponse {
  //...
  message Ad {
    //...

    message NativeAd {
      // A short title for the ad.
      optional string headline = 1;

      // A long description of the ad.
      optional string body = 2;

      // A label for the button that the user is supposed to click.
      optional string call_to_action = 3;

      // The name of the advertiser or sponsor, to be displayed in the ad
      // creative.
      optional string advertiser = 4;

      // Next tag to use: 4
      message Image {
        optional string url = 1;

        // Image width and height are specified in pixels. You may provide a
        // larger image than was requested, so long as the aspect ratio is
        // preserved.
        optional int32 width = 2;
        optional int32 height = 3;
      }

      // A large image.
      optional Image image = 5;

      // A smaller image, for the advertiser's logo.
      optional Image logo = 6;

      // The app icon, for app download ads.
      optional Image app_icon = 7;

      // The video file. Only set this field if the video field is requested.
      oneof video {
        // The URL to fetch a video ad. The URL should return an XML response
        // that conforms to VAST standards.
        string video_url = 13;

        // The VAST document to be returned.
        string video_vast_xml = 16;
      }

      // The app rating in the app store. Must be in the range [0-5].
      optional double star_rating = 8;

      // The URL that the browser/SDK will load when the user clicks the ad.
      // This can be the landing page directly, or the first step of a redirect
      // chain that eventually leads to it. For backward compatibility, if this
      // is not set, the first Ad.click_through_url is used.
      optional string click_link_url = 14;

      // The URL to use for click tracking. The SDK pings click tracking url on
      // a background thread. When resolving the url, HTTP 30x redirects are
      // followed. The SDK ignores the contents of the response; this URL
      // has no effect on the landing page for the user.
      // This field is planned to be deprecated and we are moving to the
      // repeated click_tracking_urls field.
      optional string click_tracking_url = 11;

      // The URLs to use for click tracking. This will be used throughout the
      // serving stack and will incorporate any URL in click_tracking_urls.
      repeated string click_tracking_urls = 15;

      // The price of the promoted app including the currency info.
      optional string price = 10;

    };
    optional NativeAd native_ad = 18;

    // The set of destination URLs for the snippet. This includes the URLs that
    // the user will go to if they click on the displayed ad, and any URLs that
    // are visible in the rendered ad. Do not include intermediate calls to the
    // adserver that are unrelated to the final landing page. A BidResponse that
    // returns a snippet or video ad but declares no click_through_url will be
    // discarded. Only set this field if html_snippet or video_url or native_ad
    // are set. This data is used as a destination URL declaration, for example
    // for post-filtering of publisher-blocked URLs or ad categorization.
    //
    // For non-native ads, it is not used for click tracking or any
    // other ad functionality; it is only used as a destination URL
    // declaration.
    //
    // For native ads, if NativeAd.click_link_url is not set, the first
    // value of click_through_url is used to direct the user to the landing
    // page. In addition, all values are used as destination
    // URL declarations (similar to the non-native case).
    repeated string click_through_url = 4;

    //...

    // The URLs to call when the impression is rendered. The SDK pings
    // impression urls on a background thread and ignores the contents
    // of the response.
    repeated string impression_tracking_url = 19;

    // Link to ad preferences page. This is only supported for native ads.
    // If present, a standard AdChoices icon is added to the native ad creative and
    // linked to this URL.
    optional string ad_choices_destination_url = 21;
    // ...
  }
}

Exemplos de solicitações de lance

Observação: para entender o que é obrigatório ou opcional que aparece na resposta, consulte para BidRequest.adslot.native_ad_template na solicitação do Google abaixo. Para JSON do OpenRTB, os requisitos estão no campo request do BidRequest.imp.native. Para Protobuf do OpenRTB, consulte o campo request_native do BidRequest.imp.native.

Solicitações de lance que não são de vídeo

Google

Mostrar o exemplo

id: "\020?|;\324c\013\010b\323\321A\277]\017\3643\232.<\230?b"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0"
url: "https://www.google.com"
detected_language: "pl"
adslot {
  id: 1
  excluded_attribute: 95
  excluded_attribute: 16
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  excluded_sensitive_category: 4
  excluded_sensitive_category: 23
  matching_ad_data {
    billing_id: 63548360940
    billing_id: 73058881203
    minimum_cpm_micros: 210000
  }
  matching_ad_data {
    billing_id: 47396933418
    billing_id: 29288464031
    minimum_cpm_micros: 1000000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 13680
  ad_block_key: 7661032520
  publisher_settings_list_id: 3957665107521501273
  publisher_settings_list_id: 2660288298851198176
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 49
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: PDj94L0qm9"
    source: "OMITTED"
  }
  consented_providers_settings {
    consented_providers: 1186
    consented_providers: 1301
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 800
    image_height: 800
    style_id: 536714
    style_layout_type: FLUID
    style_height: 1
    style_width: 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
timezone_offset: 120
postal_code: "10011"
geo_criteria_id: 20858
encrypted_hyperlocal_set: "!\363\260\353\204l\255n\216\215\201G\261e/\t\305\350=\220\034\220\\J\310\305\247\266\247\027\347\212_\211\363\332\370baL\226\312\375\007}\017\0140\000\262\363\373Y\243\223d\022d=\342\257\340b]\367\356\304\357 \302\204\rC\000|\245\312\235\321\323\265\357K`\307vL\354\220V\346"
publisher_type: PUBLISHER_OWNED_AND_OPERATED
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  os_version {
  }
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "PL"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z31Byn-43v7X648f48t464c0VJ47168b3x66Lz451VGsHXp58L9O1o135IzD1F09ZZGb"
auction_type: FIRST_PRICE
geo {
  lat: 50.72
  lon: 21.32
  country: "POL"
  region: "PL-SK"
  zip: "27-570"
  utcoffset: 120
  accuracy: 4730
}
user_agent_data {
  platform {
    brand: "Windows NT"
    version: "10"
    version: "0"
  }
  mobile: false
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "Gecko"
    version: "20100101"
  }
  source: USER_AGENT_STRING
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "05nylT967i314zc0550QIR",
  "imp": [
    {
      "id": "1",
      "tagid": "9635174525",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"ext\":{\"style_id\":221281,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}",
        "ver": "1.2"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "viewability",
          "value": 0.02,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 7,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          97677444075
        ],
        "publisher_settings_list_id": [
          2939393531484090288,
          7076809137765332725
        ],
        "allowed_vendor_type": [
          42,
          144
        ],
        "ampad": 3,
        "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,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "livestream": 0,
      "language": "ja"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-21",
      "city": "Ogaki",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 1485
    },
    "ipv6": "2402:6b00:f311::",
    "make": "Sharp",
    "model": "shg05",
    "os": "android",
    "osv": "13",
    "devicetype": 4,
    "lmt": 0,
    "w": 320,
    "h": 721,
    "pxratio": 3.375,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "124",
            "0"
          ]
        },
        {
          "brand": "Google Chrome",
          "version": [
            "124",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "13",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SHG05",
      "source": 2
    }
  },
  "user": {
    "id": "RMnq2980sl68Ha7b7TUd4clG7ab",
    "buyeruid": "nc79n59R0Ubi1zrgc9X923Oe72M34CfD",
    "customdata": "I2P0IGi7dhNG943Ecm6436198j178K6v4nP3s99456bUbc27"
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB9",
    "IAB26"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp2.com",
          "sid": "pub-1111111111111112",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          },
          {
            "asi": "testssp2.com",
            "sid": "pub-1111111111111112",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-ze18lg-8rEH89k518130b8zL5N4Lm590d756ONF330Yg8zoqpisuOv2m5YH2o4712Z0A",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 0
    }
  }
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "4vO3ESnZs7gsbNlU3LHL56"
imp {
  id: "1"
  tagid: "4199517334"
  bidfloor: 1.88
  bidfloorcur: "USD"
  pmp {
    deals {
      id: "21043453"
      bidfloor: 1.88
      bidfloorcur: "USD"
      [com.google.doubleclick.deal] {
        deal_type: AUCTION_PACKAGE
      }
    }
  }
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_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: 90
        }
      }
      assets {
        id: 2
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 3
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      [com.google.doubleclick.native_ext] {
        style_id: 775009
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0011545843444764614
    vendor: "EXCHANGE"
  }
  metric {
    type: "session_depth"
    value: 1.0
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 85753840376
    publisher_settings_list_id: 5097279519468003913
    publisher_settings_list_id: 4840342404554094271
    allowed_vendor_type: 3
    allowed_vendor_type: 42
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    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
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.0"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "KY"
    metro: "659"
    city: "Russellville"
    zip: "42276"
    type: IP
    utcoffset: -300
    accuracy: 2548
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9014733
    }
  }
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "124"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "124"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "10"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "83b9429Xl4Xh2aj6j098Ep3qM0K"
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB23-1"
bcat: "IAB23-10"
regs {
  gpp: "OMITTED"
}
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-z2S2lv-WNT3r7KS3S939181y04U9RrC4mv4669j3v5FJ3F823683vd9W3j4q7T3hZr1P"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Solicitações de lance de vídeo

Mostrar

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

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

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

Exemplos de respostas de lance

Observe que os valores nesta resposta não devem corresponder ao solicitações correspondentes acima. No entanto, se o modelo na solicitação sugerir campos, as respostas aqui vão estar em conformidade com esses requisitos.

Respostas de lance que não são de vídeo

Google

Mostrar o exemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 14161
    billing_id: 63548360940
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_374241"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "213,99 z\305\202"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 21

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "Z8TDDaW77DBY91rct559D3",
  "seatbid": [
    {
      "bid": [
        {
          "id": "20g178F1nO1U81rq3l6",
          "impid": "1",
          "price": 0.12127,
          "adid": "test_creative_id_879318",
          "adm": "{\"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Galactic Luxury Cruises\"}}, {\"id\": 3, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 1200, \"h\": 628}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adomain": [
            "google.com"
          ],
          "cid": "97677444075",
          "crid": "test_creative_id_879318",
          "ext": {
            "app_promotion_type": "INSTALLS",
            "ad_choices_destination_url": "https://test.com/preferences"
          }
        }
      ],
      "seat": "9714:3611:768318"
    }
  ],
  "bidid": "V2drbz93-w5w09453-0766-pLu36cYs0I91"
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "Z1ooz319AuluM78c9gs382"
seatbid {
  bid {
    id: "27Zv77s98G1G6j81vg2"
    impid: "1"
    price: 1.9337624810013911
    adid: "test_creative_id_425686"
    adomain: "google.com"
    cid: "85753840376"
    crid: "test_creative_id_425686"
    dealid: "21043453"
    cat: "IAB7-5"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Book today"
        }
      }
      assets {
        id: 3
        data {
          value: "Galactic Luxury Cruises"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
  }
  seat: "1287:1720:806996"
}
cur: "USD"

Respostas de lance de vídeo

Mostrar

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