Do you build things with AMP? Fill out the AMP Developer Survey!
AMP

Important: this documentation is not applicable to your currently selected format email!

amp-pixel

Description

Um pixel de rastreamento usado para contar visualizações de páginas.

Supported Layouts

Descrição Pode ser usado como um pixel de rastreamento típico para contar visualizações de páginas.
Layouts compatíveis fixed, nodisplay
Exemplos Veja um exemplo de amp-pixel no site AMP By Example.

Comportamento

O componente amp-pixel se comporta como um pixel de rastreamento simples img. Ele usa um único URL, mas fornece variáveis que podem ser substituídas pelo componente na string de URL ao fazer a solicitação. Consulte a seção de substituições para ver mais detalhes.

Neste exemplo básico, o amp-pixel emite uma solicitação GET simples para o URL fornecido e ignora o resultado.

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"></amp-pixel>

ao processar URLs de AMP no cabeçalho do referenciador das solicitações de análise, remova ou ignore o parâmetro usqp. Esse parâmetro é usado pelo Google para acionar experimentos para o Google AMP Cache.

Atributos

src (obrigatório)

Um URL simples para um endpoint remoto que precisa ser o protocolo https.

referrerpolicy (opcional)

Este atributo é semelhante ao atributo referrerpolicy em <img>. No entanto, no-referrer é o único valor aceito. Se referrerpolicy=no-referrer for especificado, o cabeçalho de referrer será removido da solicitação HTTP.

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"
    referrerpolicy="no-referrer"></amp-pixel>
allow-ssr-img (opcional)

Este atributo usado em anúncios AMP4ADS indica que, como parte da transformação de pós-validação, um elemento img pode ser colocado diretamente no elemento amp-pixel, permitindo que o ping seja enviado em paralelo com a busca/execução do ambiente de tempo de execução de AMP. Isso significa que as macros no URL NÃO serão expandidas, então use-as somente se elas não estiverem presentes no src.

common attributes

Este elemento inclui atributos comuns estendidos a componentes de AMP.

Substituições

O amp-pixel permite todas as substituições de variáveis de URL padrão. Consulte o Guia de substituições (em inglês) para ver mais informações.

No exemplo a seguir, uma solicitação pode ser feita para algo como https://foo.com/pixel?0.8390278471201, em que o valor ALEATÓRIO é gerado de forma aleatória em cada impressão.

<amp-pixel src="https://foo.com/pixel?RANDOM"
    layout="nodisplay"></amp-pixel>

Estilo

amp-pixel não deve ser estilizado.

Validação

Veja as regras do amp-pixel (link em inglês) nas especificações do validador de AMP.

Precisa de mais ajuda?

Você já leu este documento várias vezes, mas ainda ficou com dúvidas sem respostas? Talvez outras pessoas pensem da mesma forma. Procure entrar em contato com elas no Stack Overflow.

Ir para o Stack Overflow
Encontrou um bug ou sente falta de um recurso?

O projeto AMP incentiva fortemente sua participação e contribuições! Esperamos que você se torne um participante assíduo de nossa comunidade de código aberto, mas também agradecemos contribuições pontuais para problemas que você tenha particular interesse.

Ir para o GitHub