# Pixels de app x pixels personalizados na Shopify, explicado {#post-title}

[cPixel](/pt-br/blog/#blog-cpixel)

Por [B2B Gold](/about/#how-we-write) Publicado em 24 de setembro de 2026 Atualizado em 25 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/blog/shopify-app-pixels-vs-custom-pixels/)

## O que são pixels de app e pixels personalizados na Shopify? {#what-are-app-pixels-and-custom-pixels-in-shopify}

Na Shopify, pixels de app e pixels personalizados vivem em Settings, Customer events, e os dois rodam na sua loja, no checkout e na página de agradecimento. Pixels de app vêm com apps como o Facebook & Instagram e rodam num sandbox estrito; pixels personalizados são código que você mesmo cola e rodam num mais flexível. Os dois esperam o consentimento que exigem.

Customer events substituiu os lugares onde comerciantes costumavam colar trechos de rastreamento, como as preferências da loja online, scripts do checkout e apps, por pixels que rodam num sandbox ([pixels overview](https://help.shopify.com/en/manual/promoting-marketing/pixels/overview)). Três mudanças no último ano fazem essa escolha importar mais: [Additional scripts parou de funcionar](/pt-br/blog/shopify-additional-scripts-tracking/) na página de agradecimento, pixels de app passaram a ter acesso a dados **Optimized** por padrão, e a Shopify parou de definir o cookie `_shopify_y`. Todo dado da Shopify abaixo foi verificado em 24 de setembro de 2026.

## Qual você deveria usar? {#which-should-you-use}

Um pixel de app do próprio app da plataforma sempre que ele fizer o que você precisa: a Shopify recomenda pixels de app sempre que possível, pela segurança e pelas atualizações automáticas ([pixels e customer events](https://help.shopify.com/en/manual/promoting-marketing/pixels)). Escreva um pixel personalizado só quando nenhum app servir, sabendo que a Shopify não dá suporte a pixels personalizados ([custom pixels](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels)).

|  | Pixel de app | Pixel personalizado |
| --- | --- | --- |
| Adicionado por | Um app ou canal de vendas que você instala | Você ou seu desenvolvedor, em **Customer events** |
| Sandbox | Estrito: um web worker limitado às APIs da Shopify | Flexível: um iframe que pode carregar o script de um fornecedor mas não consegue acessar sua página |
| Acesso à página | Nenhum: seus dados vêm dos eventos da Shopify | Nenhum: o endereço que ele vê é o do sandbox |
| Permissões de consentimento | Definidas pelo desenvolvedor do app; você pode vê-las mas não mudá-las | Suas para definir; um pixel novo exige Marketing e Analytics |
| Configuração de acesso a dados | **Optimized** por padrão para pixels de marketing, ou **Always on** | Nenhuma na documentação da Shopify sobre pixels personalizados |
| Pixels de servidor | Alguns apps podem adicioná-los | Não |
| Roda em | Loja, checkout, e páginas de agradecimento e de status do pedido; páginas de conta de cliente só com um subdomínio personalizado | O mesmo |
| Suporte | O desenvolvedor do app | Você: a Shopify não dá suporte |

Fontes: as páginas da Shopify sobre [pixels de app](https://help.shopify.com/en/manual/promoting-marketing/pixels/app-pixels) e [gerenciando pixels personalizados](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels/manage), e o [guia de web pixels](https://shopify.dev/docs/apps/build/marketing/pixels) da shopify.dev.

O app de uma plataforma cobre só essa plataforma. Para enviar a várias a partir de um só app, um app de rastreamento faz o trabalho. O cPixel, que nós desenvolvemos, adiciona um único pixel de app, **cPixel**, que dispara os eventos do Meta, GA4 e Google Ads no navegador; seu app embed opcional carrega as tags das outras plataformas nas páginas da loja. Suas compras para Meta, TikTok, GA4, ChatGPT Ads, Pinterest e Snapchat saem dos seus próprios servidores, construídas a partir dos webhooks de pedido da Shopify em vez de um pixel de servidor: [como o cPixel envia eventos pelo servidor](/pt-br/docs/cpixel/getting-started/). Mais sobre [o cPixel, que envia compras da Shopify para sete plataformas de anúncios](/shopify/cpixel/).

## Como você adiciona um pixel personalizado? {#how-do-you-add-a-custom-pixel}

Escreva JavaScript simples, adicione-o em Settings, Customer events, escolha as configurações de privacidade dele, depois conecte-o. Ele não coleta nada até seu código assinar os eventos da Shopify.

1. Remova qualquer cópia existente do mesmo pixel do seu tema ou de qualquer outro lugar onde ainda rode, ou os eventos dele contam em dobro.
2. No seu admin da Shopify, vá em **Settings** → **Customer events**, dê um nome ao pixel e clique em **Add pixel**.
3. Em **Customer privacy**, defina **Permission** (**Required** para as finalidades que você escolher, ou **Not required**) e **Data sale**. Um pixel personalizado novo exige permissão de Marketing e Analytics e conta como venda de dados por padrão ([custom pixel code](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels/code)).
4. Cole seu código em **Code**. O sandbox só roda JavaScript, então remova as tags `<script>` e carregue o script do fornecedor por código em vez disso.
5. Clique em **Save**, depois em **Connect pixel**, e confirme com **Connect**.

Um pixel personalizado segue o mesmo formato seja qual for o fornecedor: carregue o SDK, depois passe os eventos da Shopify para ele.

```
// Load the vendor's SDK with JavaScript: the sandbox rejects HTML
const script = document.createElement("script");
script.setAttribute("src", "https://vendor.example/sdk.js");
script.setAttribute("async", "");
document.head.appendChild(script);

// Pass Shopify's standard events to it
analytics.subscribe("checkout_completed", (event) => {
  const checkout = event.data.checkout;
  // Call the vendor's purchase function here, with values such as
  // checkout.order?.id, checkout.totalPrice?.amount and checkout.currencyCode
});
```

Para um exemplo completo, veja como [rastrear conversões do ChatGPT Ads na Shopify](/pt-br/blog/chatgpt-ads-conversion-tracking-shopify/) com o pixel da OpenAI.

## O que um pixel não consegue fazer? {#what-cant-a-pixel-do}

Qualquer coisa que precise da própria página. Um pixel não consegue desenhar na página nem lê-la, então extrair dados da página, rastrear cliques para fora e rolagem, e mapas de calor não funcionam em nenhum dos dois sandboxes ([sandbox limitations](https://help.shopify.com/en/manual/promoting-marketing/pixels/overview#pixels-sandbox-limitations)).

- **Mostrar algo.** Nenhum botão, formulário, banner ou modal. Conteúdo para a página de agradecimento pertence a um bloco de app.
- **Ler a página.** Nenhum evento, detalhe de produto, e-mail ou telefone, clique para fora, rolagem nem dado de mapa de calor tirado dela. Publique o que precisar a partir do código do tema como um evento personalizado e assine-o: ``` // In your theme's code Shopify.analytics.publish("special_email_signup", { email_campaign_id: 123 }); // In the custom pixel analytics.subscribe("special_email_signup", (event) => { console.log(event.customData.email_campaign_id); }); ```
- **Ver o endereço real.** No sandbox flexível, o endereço de página que um script detecta é o do sandbox. A Shopify recomenda pegar a página do comprador a partir do evento `page_viewed`, por exemplo `event.context.document.location.href`.

A Shopify observa que nem todo pixel de app suporta eventos personalizados, então confira com o desenvolvedor do app antes de construir sobre eles.

## Por que um pixel está esperando consentimento? {#why-is-a-pixel-waiting-for-consent}

Porque sua loja pede consentimento onde o comprador está, e o pixel exige uma permissão que o comprador ainda não deu. O Pixel Helper da Shopify mostra isso como **Pixel is awaiting consent**: aceite seu banner de cookies ou clique em **Give consent to continue test**.

- **Os padrões.** Em mercados configurados para exigir consentimento, geralmente o EEE e o Reino Unido, um pixel roda só quando o comprador concede as permissões que exige. Um pixel novo exige Marketing e Analytics, e um pixel marcado como venda de dados não roda para compradores que optaram por não vender seus dados, a menos que suporte uso limitado de dados ([pixels overview](https://help.shopify.com/en/manual/promoting-marketing/pixels/overview)).
- **Consentimento dado, ainda esperando.** Um banner de cookies de terceiros precisa sincronizar suas escolhas pela Customer Privacy API da Shopify. Limpar seus cookies reinicia seu próprio banner. Com um domínio personalizado, contas de cliente precisam de um subdomínio dele, ou pixels e consentimento não vão funcionar na página de status do pedido ([troubleshooting an app pixel](https://help.shopify.com/en/manual/promoting-marketing/pixels/app-pixels#troubleshooting)).
- **Um caso real.** Num [tópico da comunidade](https://community.shopify.com/t/google-youtube-app-not-sending-purchase-events-to-ga4-after-reinstallation/660780) de agosto de 2026, as compras de uma loja pararam de chegar ao GA4 pelo app Google & YouTube. As respostas atribuíram isso ao banner de cookies que nunca passava as escolhas para a Customer Privacy API, então a Shopify retinha o pixel do app no checkout enquanto uma tag do tema que o banner liberava mantinha o fluxo de visualizações de página.

Um app também pode não exigir nenhuma permissão e conferir o consentimento no próprio código, usando a API de [privacidade de pixels](https://shopify.dev/docs/api/web-pixels-api/pixel-privacy) da Shopify. O cPixel funciona assim: [o que o cPixel envia, e como o consentimento muda isso](/pt-br/docs/cpixel/event-quality-and-consent/).

## O que significa “Optimized” para um pixel de app? {#what-does-optimized-mean-for-an-app-pixel}

É a configuração de acesso a dados padrão para pixels de app desde 13 de janeiro de 2026: quando a Shopify detecta que um pixel de marketing está compartilhando mais dados do que precisa, ela pode pausar parte ou a totalidade dos dados desse pixel até a atividade relevante voltar ([app pixels](https://help.shopify.com/en/manual/promoting-marketing/pixels/app-pixels), [changelog](https://changelog.shopify.com/posts/new-default-setting-for-pixel-data-sharing)).

- **As duas configurações.** **Always on** dá ao pixel acesso a dados sem limites; **Optimized** deixa a Shopify ajustar isso. A otimização se aplica a pixels de marketing; alguns pixels de app, como os de apps de analytics, não podem ser otimizados e ficam em **Always on**.
- **O que a Shopify avalia.** Referências pagas e orgânicas, vendas, maturidade da loja, configuração da loja e ajustes de campanhas sincronizadas. Seu próprio exemplo é um app de marketing que você parou de usar, cujos dados pausam depois de bastante inatividade. Quando o padrão chegou, a Shopify o aplicou a todos os pixels de marketing ativos, mas não restringiu nenhum por pelo menos sete dias.
- **O que ela deixa intocado.** Ferramentas de marketing que atualmente geram tráfego ou vendas, eventos pensados para analytics independente, e webhooks.
- **Como conferir.** Em **Settings** → **Customer events**, abra o menu do pixel e clique em **View details**. O log de atividade lista cada mudança de **Data access paused** ou **Data access granted** desde 3 de junho de 2026, com seu motivo.
- **Como mudar.** Clique no nome do pixel, escolha **Optimized** ou **Always on**, depois clique em **Save**.

Se os números de uma plataforma caíram enquanto as campanhas dela estavam pausadas, leia esse log antes de assumir que o rastreamento quebrou; para o Meta, as outras causas estão em [pixel do Meta não rastreia compras](/pt-br/blog/meta-pixel-not-tracking-purchases-shopify/). Se um pixel deveria estar em **Always on** é um julgamento sobre aquele app, então pergunte ao desenvolvedor dele.

## Como você testa um pixel? {#how-do-you-test-a-pixel}

Com o Pixel Helper da Shopify: em **Settings** → **Customer events**, clique num pixel personalizado e depois em **Test**, ou, para um pixel de app, clique no ícone de menu ao lado dele e escolha **Test** (um pixel de app por vez). Depois navegue e finalize a compra na aba que abrir ([testing custom pixels](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels/testing), [app pixels](https://help.shopify.com/en/manual/promoting-marketing/pixels/app-pixels)).

1. Para um pixel personalizado, a Shopify sugere esta assinatura enquanto você testa, que registra todo evento padrão no console: ``` analytics.subscribe("all_standard_events", (event) => { console.log("Event data ", event?.data); }); ```
2. Visite uma página, veja um produto, adicione-o ao carrinho, inicie o checkout, digite os dados de entrega e complete um pedido de teste. Cada evento deve receber um ponto verde; um ponto vermelho significa que seu callback falhou, e expandir o evento mostra o erro.
3. Confirme o recebimento também na própria ferramenta da plataforma; o exemplo da Shopify é o pixel helper do TikTok. O Tag Assistant do Google é a exceção, como explica a próxima seção. [Verificar todos os pixels da página](/blog/check-if-pixel-is-working/) aborda essas ferramentas.

O Pixel Helper testa um pixel por vez, você não pode editar um pixel enquanto ele roda, e seu log limpa toda vez que você abre uma página nova. A saída de console de um pixel personalizado fica no próprio frame dele, então escolha esse frame no console do seu navegador.

## Você pode usar o Google Tag Manager num pixel personalizado? {#can-you-use-google-tag-manager-in-a-custom-pixel}

Sim. A Shopify documenta a configuração, mas as tags que o Tag Manager carrega continuam rodando dentro do sandbox do pixel personalizado com as mesmas limitações, e a Shopify diz que o Google não recomenda nem dá suporte a isso. Para as tags do próprio Google, a Shopify recomenda o app Google & YouTube em vez disso.

1. Copie o código do Tag Manager para o head da página e remova suas tags HTML.
2. Cole o resto num pixel personalizado novo.
3. Assine os eventos da Shopify e envie cada um ao `dataLayer` do Tag Manager.
4. Configure o Tag Manager para aceitar esses eventos ([Google Tag Manager custom pixel](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels/gtm-tutorial)).

O recurso Troubleshoot tag do Tag Assistant não consegue ver tags dentro de um pixel personalizado, então teste com o Pixel Helper e os próprios relatórios das plataformas. Mais sobre isso em [Tag do Google não detectada](/blog/google-tag-not-detected/). Para tags que não são do Google e que você roda pelo Tag Manager, a Shopify sugere apps com pixels de app ([substituindo scripts do Google Tag Manager](https://help.shopify.com/en/manual/checkout-settings/customize-checkout-configurations/upgrade-thank-you-order-status/replace-google-tag)).

## Perguntas frequentes {#frequently-asked-questions}

### Por que Customer events está em cinza? {#why-is-customer-events-greyed-out}

Geralmente é uma permissão de equipe. **View customer events** deixa um membro da equipe ver pixels de app e personalizados, **Manage and add custom pixels** deixa adicionar e editar os personalizados, e gerenciar pixels de app exige **Manage and install apps and channels** ([permissões da loja](https://help.shopify.com/en/manual/your-account/users/roles/permissions/store-permissions)). Peça ao dono da loja para adicionar o que você precisa ao seu papel.

### Pixels rodam em páginas de conta de cliente? {#do-pixels-run-on-customer-account-pages}

Só depois de você conectar um subdomínio personalizado para contas de cliente, e mesmo assim eles rastreiam só o evento `page_viewed` ali ([pixels overview](https://help.shopify.com/en/manual/promoting-marketing/pixels/overview)).

### O que substituiu o cookie `_shopify_y`? {#what-replaced-the-_shopify_y-cookie}

O `clientId` nos eventos padrão e DOM da Shopify. A Shopify parou de definir `_shopify_y` e `_shopify_s` em 1º de janeiro de 2026; `event.clientId` traz o ID que o primeiro guardava. Não há substituto para `_shopify_s`, mas um pixel pode definir seu próprio cookie de duração de sessão pela API do navegador ([changelog da Shopify](https://shopify.dev/changelog/shopifyy-and-shopifys-cookies-will-no-longer-be-set)).

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Instalar grátis pela Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=blog&utm_content=pt-br/blog/shopify-app-pixels-vs-custom-pixels&utm_term=post-cta) [Planos e preços](/shopify/cpixel/#pricing) [Documentação do cPixel](/pt-br/docs/cpixel/)

Precisa de ajuda com o cPixel? Envie um e-mail para [support@b2bgold.app](mailto:support@b2bgold.app).

## Mais sobre o cPixel {#related-heading}

- 24 de setembro de 2026 **[Rastreamento pelo servidor na Shopify: você precisa disso?](/pt-br/blog/server-side-tracking-shopify/)** O que o rastreamento pelo servidor muda na Shopify, o que bloqueadores e o consentimento ainda escondem, quando os apps da Shopify bastam e quando vale ter mais um app.
- 24 de setembro de 2026 **[Additional scripts parou? Corrija o rastreamento de compras](/pt-br/blog/shopify-additional-scripts-tracking/)** Desde 26 de agosto de 2026, a página de agradecimento da Shopify não roda mais Additional scripts nem script tags em nenhum plano. O que quebrou e como mover para pixels.
- 24 de setembro de 2026 **[Como melhorar o Event Match Quality na Shopify](/pt-br/blog/event-match-quality-shopify/)** O que a pontuação Event Match Quality do Meta mede, quais dados de cliente a aumentam numa loja Shopify, como o consentimento a limita, e as correções sem código.