Documentação

Tudo o que precisa de saber para implementar o Consentio rapidamente

TikTok Pixel

Integração do TikTok Pixel com o Consentio

O que é o TikTok Pixel

Uma ferramenta de medição para monitorizar conversões e otimizar campanhas no TikTok. O TikTok Pixel permite medir a eficácia dos anúncios, criar audiências personalizadas e otimizar a entrega de anúncios.

Categoria de cookies

O TikTok Pixel pertence à categoria marketing.

Categoria Consentio Sinal GCM
marketing ad_storage, ad_user_data, ad_personalization

Instalação com o Consentio

Adicione o código do TikTok Pixel com os atributos type="text/plain" e data-category="marketing". O script do Consentio irá ativar o pixel apenas depois de o consentimento de marketing ser concedido.

HTML
<!-- TikTok Pixel -->
<script type="text/plain" data-category="marketing">
  !function (w, d, t) {
    w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];ttq.methods=["page","track","identify","instances","debug","on","off","once","ready","alias","group","enableCookie","disableCookie","holdConsent","revokeConsent","grantConsent"],ttq.setAndDefer=function(t,e){t[e]=function(){
        t.push([e].concat(Array.prototype.slice.call(arguments,0)))}};for(var i=0;i<ttq.methods.length;i++)ttq.setAndDefer(ttq,ttq.methods[i]);ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;n<ttq.methods.length;n++)ttq.setAndDefer(e,ttq.methods[n]);return e};ttq.load=function(e,n){var r="https://analytics.tiktok.com/i18n/pixel/events.js",o=n&&n.partner;ttq._i=ttq._i||{},ttq._i[e]=[],ttq._i[e]._u=r,ttq._t=ttq._t||{},ttq._t[e]=+new Date,ttq._o=ttq._o||{},ttq._o[e]=n||{};var i=d.createElement("script");i.type="text/javascript",i.async=!0,i.src=r+"?sdkid="+e+"&lib="+t;var a=d.getElementsByTagName("script")[0];a.parentNode.insertBefore(i,a)};
    ttq.load('YOUR_PIXEL_ID');
    ttq.page();
  }(window, document, 'ttq');
</script>
Nota: Substitua YOUR_PIXEL_ID pelo ID real do TikTok Ads Manager → Ativos → Eventos.

Alternativa com API JavaScript

Carregue o TikTok Pixel dinamicamente depois de o consentimento ser concedido:

JavaScript
Consentio.onConsentChange((consent) => {
  if (consent.marketing) {
    !function (w, d, t) {
      w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];
      ttq.methods=["page","track","identify","instances","debug",
      "on","off","once","ready","alias","group","enableCookie",
      "disableCookie","holdConsent","revokeConsent","grantConsent"];
      ttq.setAndDefer=function(t,e){t[e]=function(){
        t.push([e].concat(Array.prototype.slice.call(arguments,0)))}};
      for(var i=0;i<ttq.methods.length;i++)ttq.setAndDefer(ttq,ttq.methods[i]);
      ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;
        n<ttq.methods.length;n++)ttq.setAndDefer(e,ttq.methods[n]);return e};
      ttq.load=function(e,n){var r="https://analytics.tiktok.com/i18n/pixel/events.js";
        ttq._i=ttq._i||{},ttq._i[e]=[],ttq._i[e]._u=r,
        ttq._t=ttq._t||{},ttq._t[e]=+new Date,ttq._o=ttq._o||{},
        ttq._o[e]=n||{};var i=d.createElement("script");
        i.type="text/javascript",i.async=!0,
        i.src=r+"?sdkid="+e+"&lib="+t;
        var a=d.getElementsByTagName("script")[0];
        a.parentNode.insertBefore(i,a)};
      ttq.load('YOUR_PIXEL_ID');
      ttq.page();
    }(window, document, 'ttq');
  }
})

Google Consent Mode v2

O TikTok Pixel não suporta nativamente o Google Consent Mode v2. Por isso, deve utilizar o bloqueio de scripts através do atributo type="text/plain" com data-category="marketing", conforme descrito acima.

O Consentio garante que o pixel só é carregado depois de o consentimento de marketing ser concedido. Mapeamento de categorias:

Categoria Consentio Sinal GCM Descrição
marketing ad_storage Armazenamento de anúncios
marketing ad_user_data Partilha de dados do utilizador com plataformas de publicidade
marketing ad_personalization Personalização de anúncios

Verificação

  1. Instale a extensão TikTok Pixel Helper no Chrome
  2. Antes de conceder consentimento: o pixel não deve enviar quaisquer eventos
  3. Depois de conceder o consentimento de marketing: o pixel deve enviar um evento PageView
  4. Verifique no TikTok Ads Manager → Ativos → Eventos que os eventos estão a ser registados corretamente
Facebook PixelMicrosoft Ads