Anúncios intersticiais

Um anúncio intersticial (ou anúncio de tela cheia) é um tipo de anúncio que cobre a maior parte da tela. Assim, o conteúdo do publisher não aparece na tela quando um anúncio intersticial é mostrado.

Para identificar uma oportunidade de anúncio intersticial na solicitação de lance, verifique se o campo BidRequest.imp.instl da solicitação está definido como true em Protobuf ou 1 em JSON.

Tamanho do espaço do anúncio

O tamanho do espaço do anúncio para anúncios intersticiais indica a área que pode ser usada para renderizar criativos e depende de vários fatores, como formatos específicos e dimensões da tela.

O primeiro par de largura e altura no campo BidRequest.imp.banner.format do OpenRTB representa o tamanho real do espaço do anúncio, e os pares restantes representam uma lista de tamanhos de anúncio aceitáveis que estão dentro do intervalo dos requisitos do espaço do anúncio.

Os criativos não estão restritos aos tamanhos recomendados na solicitação de lance, mas todos os tamanhos recomendados na solicitação de lance estão garantidos dentro do intervalo de tamanho aceitável.

Você pode fazer lances com qualquer criativo cuja largura e altura atendam aos seguintes critérios:

  • Menor ou igual à largura e altura do espaço do anúncio
  • Maior ou igual a 50% da largura do espaço de anúncio
  • Maior ou igual a 40% da altura do espaço de anúncio

Se o tamanho do anúncio for muito grande ou muito pequeno, a resposta do lance será filtrada com o motivo da rejeição INTERSTITIAL_SIZE_MISMATCH.

Se você não especificar o tamanho do anúncio na resposta do lance, ela será filtrada com o motivo da rejeição MISSING_AD_SIZE.

Exemplos de solicitações de lance

Confira alguns exemplos de solicitações de lances para anúncios intersticiais.

Protobuf do OpenRTB

Mostrar exemplo

[Serialized request](/authorized-buyers/rtb/data/request-response/openrtb_protobuf_mobile_app_interstitial_ad_request.bin){: .download}
id: "D3x8RPLO96R6T137tQ6168"
imp {
  id: "1"
  banner {
    w: 360
    h: 715
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 715
    }
    format {
      w: 320
      h: 568
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.3.0"
  instl: true
  tagid: "5771994185"
  bidfloor: 2764.414643547123
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.03971313312649727
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.91
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 68640308112
    billing_id: 56606437068
    publisher_settings_list_id: 1984414516100776281
    publisher_settings_list_id: 5846951473307279661
    allowed_vendor_type: 0
    allowed_vendor_type: 57823
    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
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7405557148270612"
    [com.google.doubleclick.publisher] {
      country: "HK"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.7"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    zip: "RH20"
    type: IP
    utcoffset: 60
    accuracy: 2312
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9191103
    }
  }
  ipv6: "2a02:c7c:7c25::"
  make: "Huawei"
  model: "LYA-L09"
  os: "android"
  osv: "10"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16"
  w: 360
  h: 715
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "10"
    }
    mobile: true
    model: "LYA-L09"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    metereddata: false
    chargelevel: 0.93
    charging: false
    diskspace: 2100
    audioout: AUDIO_SILENT
  }
}
user {
  id: "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1205
      consented_providers: 415
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 6
      depth: 12
      requestssinceappopen: 12
      priorclicks: 0
    }
    idage: 44064000
  }
}
at: FIRST_PRICE
tmax: 1500
cur: "EUR"
cur: "JPY"
bcat: "32"
bcat: "33"
regs {
  [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-v251815999.232400000.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON do OpenRTB

Mostrar exemplo

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 360,
        "h": 715,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 360,
            "h": 715
          },
          {
            "w": 320,
            "h": 568
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.3.0",
      "instl": 1,
      "tagid": "5771994185",
      "bidfloor": 2764.414643547123,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.03971313312649727,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.91,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "68640308112",
          "56606437068"
        ],
        "publisher_settings_list_id": [
          "1984414516100776281",
          "5846951473307279661"
        ],
        "allowed_vendor_type": [
          0,
          57823
        ],
        "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,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7405557148270612",
      "ext": {
        "country": "HK"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.7",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "zip": "RH20",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 2312,
      "ext": {
        "geo_criteria_id": 9191103
      }
    },
    "ipv6": "2a02:c7c:7c25::",
    "make": "Huawei",
    "model": "LYA-L09",
    "os": "android",
    "osv": "10",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16",
    "w": 360,
    "h": 715,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "10"
        ]
      },
      "mobile": 1,
      "model": "LYA-L09",
      "source": 3
    },
    "ext": {
      "metereddata": 0,
      "chargelevel": 0.93,
      "charging": 0,
      "diskspace": 2100,
      "audioout": 3
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee",
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1205",
          "415"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 6,
        "depth": 12,
        "requestssinceappopen": 12,
        "priorclicks": 0
      },
      "idage": 44064000
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "EUR",
    "JPY"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "regs": {
    "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-v251815999.232400000.1"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Práticas recomendadas

O Google recomenda as práticas recomendadas abaixo:

  • Inclua atributos de formatação nos snippets de criativo HTML para centralizar os anúncios no espaço do anúncio. Caso contrário, os anúncios serão renderizados na parte superior esquerda do espaço do anúncio.

  • Responda com um anúncio intersticial que ocupe o máximo de espaço possível no espaço do anúncio. Não preencha um espaço do anúncio intersticial com um anúncio muito menor. Por exemplo, um anúncio de 320 x 480 é muito pequeno para um espaço intersticial de 420 x 800.

  • Não adicione um botão "Fechar":

    • Nosso SDK mostra automaticamente um botão de fechar (quando aplicável) para garantir que os usuários possam clicar nele.
    • MRAID useCustomClose() não é compatível.
  • Use os tamanhos recomendados da solicitação de lance para escolher tamanhos de anúncio aceitáveis para sua resposta de lance.

  • Compare os campos BidRequest.device.w e BidRequest.device.h para escolher criativos com uma orientação adequada.

    • Recomendamos ter criativos verticais e horizontais para dar lances com a orientação adequada.

Intersticiais sem tamanho (fluidos)

Os anúncios intersticiais sem tamanho (também conhecidos como responsivos ou flexíveis) são redimensionados dinamicamente para ocupar toda a largura e altura do espaço de anúncio. A Authorized Buyers não redimensiona os criativos para você. Você precisa fornecer um criativo que seja redimensionado de forma dinâmica.

Você só precisa enviar intersticiais sem tamanho para análise uma vez, mesmo que eles possam ser veiculados em vários tamanhos. Para garantir que seu criativo não seja analisado novamente para cada tamanho de espaço do anúncio individual, recomendamos o seguinte:

Resposta do lance

  • Use BidResponse.seatbid.bid.ext.attribute para declarar Rendering: Sizeless AdX (atributo 105) na resposta do lance. Os atributos declaráveis de criativo podem ser encontrados no arquivo de dados buyer-declarable-creative-attributes.txt.

  • Preencha BidResponse.seatbid.bid.w e BidResponse.seatbid.bid.h com o tamanho que você quer que o criativo seja renderizado com base nos requisitos de tamanho do anúncio. Por exemplo, 360 x 480 para um espaço de anúncio de 360 x 480. O criativo ainda pode ser veiculado em outros tamanhos. Para o protocolo RTB do Google descontinuado, você preencheria BidResponse.Ad.width e BidResponse.Ad.height.

Se você adicionar o atributo Rendering: Sizeless AdX a um criativo, ele precisará ser revisado novamente.

Pré-aprovação de criativos

  • Ao enviar um criativo para revisão, inclua o atributo RENDERING_SIZELESS_ADX no campo declaredAttributes. Na API de lances em tempo real, os atributos do criativo são representados usando um valor de enumeração de string. Para saber mais sobre como eles correspondem aos IDs numéricos de buyer-declarable-creative-attributes.txt, consulte o guia de mapeamento.
  • Envie o criativo usando um tamanho que você espera veicular, ou seja, um tamanho comum para criativos intersticiais. O criativo ainda pode ser veiculado em outros tamanhos.
  • Cada criativo sem tamanho conta apenas uma vez para o limite, mesmo que seja veiculado em vários tamanhos.