google. ima. AdsRequest
Uma classe para especificar propriedades da solicitação de anúncio.
Construtor
AdsRequest
new AdsRequest()
- Implementa
- google.ima.AdsRequestInterface
Propriedades
URL da tag de anúncio
string
Especifica o URL da tag de anúncio que é solicitado ao servidor de anúncios. Para ver detalhes sobre como criar o URL da tag de anúncio, consulte Criar uma tag de vídeo principal manualmente.
Este parâmetro é obrigatório.
Resposta de anúncio
(nulo, string ou documento não nulo)
Especifica um documento VAST 2.0 a ser usado como a resposta dos anúncios em vez de fazer uma solicitação por meio de um URL de tag de anúncio. Isso pode ser útil para depuração e outras situações em que uma resposta VAST já esteja disponível.
Esse parâmetro é opcional.
contentDuration
(nulo ou número)
Especifica a duração do conteúdo em segundos. Ela é usada em dois casos: 1) segmentação de anúncios do AdX e 2) decisão de quando pré-carregar o anúncio final do VMAP.
Este parâmetro é opcional.
contentKeywords
(matriz de string nula ou não nula)
Especifica as palavras-chave usadas para descrever o conteúdo a ser exibido. Usado em solicitações do AdX.
Este parâmetro é opcional.
título do conteúdo
(nulo ou string)
Especifica o título do conteúdo a ser exibido. Usado em solicitações do AdX.
Este parâmetro é opcional.
forçarNonLinearFullSlot
boolean
Força a renderização de anúncios não lineares do AdSense como espaço inteiro linear. Se definido, o conteúdo de vídeo será pausado e o anúncio gráfico ou de texto não linear será processado como espaço inteiro. O conteúdo de vídeo será retomado assim que o anúncio for ignorado ou fechado.
LinearAdSlotHeight
number
Especifica a altura da área retangular em que um anúncio linear é exibido. Esse valor é usado como um dos critérios para seleção de anúncios. Esse valor não precisa corresponder à altura real do anúncio.
Esse parâmetro é obrigatório.
Largura do espaço de anúncio linear
number
Especifica a largura da área retangular em que um anúncio linear é exibido. Esse valor é usado como um dos critérios para seleção de anúncios. Esse valor não precisa corresponder à largura real do anúncio.
Este parâmetro é obrigatório.
liveStreamPrefetchSeconds
number
Especifica o tempo máximo de espera em segundos, depois de chamar requestAds, antes de solicitar o URL da tag de anúncio. Isso pode ser usado para escalonar as solicitações durante um evento de transmissão ao vivo, para reduzir os picos no número de solicitações.
nonLinearAdSlotHeight
number
Especifica a altura da área retangular em que um anúncio não linear é exibido. Esse valor é usado como um dos critérios para a seleção de anúncios. Esse valor não precisa corresponder à altura real do anúncio.
Esse parâmetro é obrigatório.
nonLinearAdSlotWidth
number
Especifica a largura da área retangular em que um anúncio não linear é exibido. Esse valor é usado como um dos critérios para a seleção de anúncios. Esse valor não precisa corresponder à largura real do anúncio.
Esse parâmetro é obrigatório.
omidAccessModeRules
Objeto não nulo com propriedades de string
O objeto de configurações para mapear fornecedores de verificação para os modos de acesso OMID. As chaves precisam ser valores em google.ima.OmidVerificationVendor, e os valores precisam ser valores em google.ima.OmidAccessMode.
Os URLs do script de verificação são comparados internamente com as expressões regulares fornecidas pelo fornecedor para resolver uma chave OmidVerificationVendor. Em seguida, o IMA procura o modo de acesso do fornecedor especificado usando esse objeto.
Para URLs de script que não direcionam para um fornecedor conhecido ou se o OmidVerificationVendor resolvido não for fornecido neste objeto, o IMA usará o modo de acesso fornecido para OmidVerificationVendor.OTHER. Se OmidVerificationVendor.OTHER não for fornecido, o modo de acesso LIMITED será usado.
URL da página
(nulo ou string)
Especifica o URL completo da página que será incluída na solicitação de anúncio do Google para fins de segmentação. O URL precisa ser válido. Se especificado, esse valor será usado para a macro VAST [PAGEURL].
Este parâmetro é opcional.
vastLoadTimeout
number
Modifica o tempo limite de carregamento VAST padrão em milissegundos para um único wrapper. O tempo limite padrão é de 5.000 ms.
Este parâmetro é opcional.
Métodos
setAdWillAutoPlay
setAdWillAutoPlay(autoPlay) retorna nulo
Notifica o SDK se o player pretende iniciar o conteúdo e o anúncio em resposta a uma ação do usuário ou se ele será reproduzido automaticamente. Alterar essa configuração não terá impacto na reprodução do anúncio.
Parâmetro |
|
---|---|
Reprodução automática |
boolean Se o conteúdo e o anúncio serão reproduzidos automaticamente ou se serão iniciados por uma ação do usuário. |
- Retorna
-
void
setAdWillPlayMuted
setAdWillPlayMuted(muted) retorna nulo
Notifica o SDK se o player pretende iniciar o anúncio com o som desativado. Alterar essa configuração não terá impacto na reprodução do anúncio, mas enviará o sinal apropriado na solicitação de anúncio para permitir que os compradores façam lances em inventário sem som.
Parâmetro |
|
---|---|
silenciado |
boolean Indica se o anúncio será reproduzido com o som desativado. |
- Retorna
-
void
setContinuousPlayback
setContinuousPlayback(ContinuousPlayback) retorna nulo.
Notifica o SDK se o player pretende reproduzir continuamente os vídeos de conteúdo, um após o outro de forma semelhante à transmissão de TV. Alterar essa configuração não afetará a reprodução do anúncio, mas enviará o sinal apropriado nessa solicitação de anúncio para permitir que os compradores façam lances no tipo de inventário de anúncios.
Parâmetro |
|
---|---|
Reprodução contínua |
boolean Se o vídeo de conteúdo é reproduzido um após o outro continuamente. |
- Retorna
-
void