A integração pode estar em liberação gradual. Se o card não aparecer para sua conta, fale com o suporte.
Antes de começar
Tenha uma conta na plataforma e permissão para autorizar a conexão.
OAuth 2[.]0 com dois modos. (1) Authorization Code, que e o caminho para a Toca: o app e criado uma vez no Criteo Partner Dashboard (partners[.]criteo[.]com, servico C-Growth para Marketing Solutions), e cada lojista autoriza em https[:]//consent[.]criteo[.]com/request?response_type=code&client_id={client_id}&redirect_uri={redirect_uri}&state={state}. O redirect_uri precisa ser HTTPS e estar entre os ate 30 cadastrados no app. O code e trocado em POST https[:]//api[.]criteo[.]com/oauth2/token com Content-Type application/x-www-form-urlencoded e grant_type=authorization_code, client_id, client_secret, code e redirect_uri (o redirect_uri tem de ser identico ao do pedido de consentimento). O refresh e grant_type=refresh_token; o refresh token e longevo, expira em 6 meses, e e revogado se a pessoa que autorizou muda de papel ou sai da organizacao. PKCE so e exigido de cliente publico (app mobile, SPA) que nao guarda secret com seguranca, o que nao e o caso de um backend. (2) Client Credentials (grant_type=client_credentials, client_id, client_secret) serve a conexao simples em que o dono do dado e o dono do app sao o mesmo, sem segregacao por conta. O access token e Bearer e vale 15 minutos (900 s); 401 significa token expirado. As permissoes nao vao em parametro de scope: sao os dominios escolhidos na pagina do app no Partner Dashboard, e Account Manage, Balance Manage e Billing Read precisam ser liberados antes pelo contato Criteo. O anunciante nao e digitado pelo lojista: sai de GET /2026-07/advertisers/me.
Passo a passo
- Acesse Configurações → Integrações na Toca.
- Localize o card Criteo e clique em Conectar.
- Autorize o acesso na plataforma e retorne à Toca; selecione o recurso quando solicitado.
- Confirme que o card indica a conexão e faça uma primeira consulta no chat.
O que a Toca acessa
- Portfolio de anunciantes aos quais o app tem acesso
- Buscar campanhas
- Detalhe de uma campanha
- Buscar ad sets
- Detalhe de um ad set
- Relatorio de performance (statistics)
- Relatorio de transacoes
- Relatorio de placements (performance por publisher)
- Buscar audiencias
- Buscar segmentos de audiencia
- Detalhe de criativo
- Preview de criativo
Alterações disponíveis, sempre mediante aprovação explícita no chat:
- Cria uma campanha nova na conta do anunciante no Criteo, com objetivo e limite de gasto..
- Altera nome, objetivo ou limite de gasto da campanha, o que muda quanto ela pode gastar e por quanto tempo entrega..
- Cria um ad set na campanha, com orcamento, lance, agenda e segmentacao..
- Altera orcamento, estrategia de orcamento, lance, controle de custo, agenda ou segmentacao do ad set, mudando o quanto e para quem o anuncio aparece..
- Liga a veiculacao dos ad sets: o anuncio volta a aparecer para o consumidor e a conta volta a gastar..
- Desliga a veiculacao dos ad sets: o anuncio para de aparecer para o consumidor..
- Cria uma audiencia na conta do anunciante; sozinha nao veicula nada ate ser usada em segmentacao..
- Altera nome ou descricao de audiencias existentes..
- Exclui audiencias da conta. Ad set que segmentava por ela perde a segmentacao. — operação destrutiva; revise os efeitos antes de autorizar.
- Cria um segmento de audiencia na conta do anunciante..
- Altera segmentos de audiencia existentes..
- Cria um criativo na conta do anunciante, que passa a poder ser veiculado ao consumidor..
- Substitui o criativo: muda a peca que o consumidor final ve no anuncio..
- Exclui o criativo da conta; anuncio que dependia dele para de ter peca. — operação destrutiva; revise os efeitos antes de autorizar.
A integração está em homologação: o contrato foi preparado a partir da documentação e ainda precisa ser confirmado em conta real. Confira os dados importantes no painel da plataforma.
Manutenção da conexão
Se o acesso for revogado ou as credenciais mudarem, reconecte pelo card da plataforma. Não compartilhe credenciais no chat.
Problemas comuns
- O card não aparece: a liberação pode depender da sua conta; fale com o suporte.
- A conexão foi recusada: confira as permissões e os dados informados na plataforma.
- Uma consulta não retorna o esperado: confira o painel e informe ao suporte qual consulta falhou.
- Ponto pendente de homologação: Nao houve medicao em conta real do Criteo: nenhum endpoint foi chamado, so lido na documentacao. Paginacao, itemsPath, metodo das buscas e forma do relatorio precisam ser confirmados com credencial de verdade antes de promover a ativa.
- Ponto pendente de homologação: O app no Criteo Partner Dashboard nao fica usavel sozinho: a documentacao de criacao de app diz que as permissoes Account Manage, Balance Manage e Billing Read precisam ser liberadas antes pelo contato Criteo. Sem esse aval comercial nao ha client_id operacional, o que torna a integracao dependente de parceria, nao so de codigo.
- Ponto pendente de homologação: Nao achei publicada nenhuma string exata de scope OAuth: o pedido de consentimento (consent[.]criteo[.]com/request) leva apenas response_type, client_id, redirect_uri e state, e a permissao vem dos dominios marcados na pagina do app. Por isso fluxoAuth[.]scopes e os scopes de cada escrita ficaram vazios, e o gate de scope fica aberto.
- Ponto pendente de homologação: A lista de dominios de permissao que consegui ler (Account Management, Reporting, Audiences, Balance, Billing, Campaigns, Products Catalog, cada um com No access / Read / Manage) esta na pagina de criacao de app no contexto de Retail Media; nao encontrei a lista equivalente publicada para Marketing Solutions (C-Growth).
- Ponto pendente de homologação: Metodo das buscas de audiencia e de segmento nao esta fechado: a referencia da versao 2025-04 lista GET /audiences/search e GET /audience-segments/search, enquanto na 2026-07 as buscas de campanha e de ad set sao POST. Declarei os dois metodos como leitura para nao abrir card de autorizar numa consulta, mas o caminho real precisa ser confirmado.
- Ponto pendente de homologação: O prefixo de versao faz parte do path e a Criteo lancou politica nova de versionamento a partir de 2026[.]07, com spec de 2027-01 ja publicada. O manifest nasce preso a 2026-07 e exige revisao a cada release.
- Ponto pendente de homologação: O relatorio tem format obrigatorio entre csv, json, xml e excel. Nao confirmei na documentacao o formato da resposta json em relacao ao envelope data: com csv o itemsPath data certamente nao se aplica.
- Ponto pendente de homologação: Nao encontrei limite publicado de intervalo de datas, de numero de advertiserIds nem de tamanho de relatorio: so o 413 payload too large, sem numero. O teto real de uma consulta grande so aparece em medicao.
- Ponto pendente de homologação: Nao busquei fonte oficial para a cor da marca nem para o SVG do icone do cartao, por isso corDaMarca e icone ficaram em null.
- Ponto pendente de homologação: Retail Media (C-Max) e a Retailer Integration/Delivery API compartilham o mesmo OAuth e o mesmo host, mas tem referencia propria e nao foram levantadas aqui: ficam fora deste dossie.