A API do Pinterest para conversões permite aos anunciantes enviar conversões diretamente para o Pinterest através de uma ligação servidor a servidor. As conversões capturadas pela API do Pinterest podem ser usadas para nova segmentação de campanhas e podem ser analisadas nos relatórios de conversão para melhorar a visibilidade das conversões.
Através da API do Pinterest para conversões, os anunciantes podem enviar:
Os eventos podem ser recebidos em tempo real ou no espaço de uma hora após o evento ocorrer e ser capturado. Os eventos recebidos fora deste intervalo ou como parte de um evento de lote atrasado serão contados como conversões offline.
Usar a API do Pinterest para conversões juntamente com a Tag do Pinterest pode contribuir para maximizar a visibilidade das conversões capturadas. A nossa recomendação é usar ambas as soluções de captura de conversões, no sentido de obter uma visão abrangente do desempenho das campanhas de conversão.
A API do Pinterest para Conversões é um dos vários produtos que existem no nosso ecossistema da Pinterest API. Qualquer utilizador com uma conta do Pinterest Business poderá usar a API do Pinterest para conversões, mas isso não concede automaticamente acesso à API Pinterest mais alargada.
A
Qualquer utilizador com uma conta do Pinterest Business tem acesso à API do Pinterest para conversões.
Para começar, deves em primeiro lugar gerar um token de acesso. Um token de acesso é uma cadeia de caracteres que verifica os pedidos que estão a ser feitos e enviados para a conta de utilizador correta.
Para gerar um token de acesso:
Se estiveres a tentar aceder a uma conta que não te pertence, é necessário configurar em primeiro lugar o Acesso empresarial.
Eventos de conversão: todos os tipos de eventos disponíveis para captura na Tag do Pinterest também estão disponíveis por meio da API do Pinterest para conversões. Encontras uma lista completa dos eventos e mais informações sobre sua importância na
Configurar uma
Recomendamos vivamente que uses a API do Pinterest para Conversões juntamente com a Tag do Pinterest, com o objetivo de maximizar as tuas conversões.
Se já configuraste a Tag do Pinterest, deves assegurar que as conversões não estão a ser contabilizadas duas vezes: uma através da Tag do Pinterest e outra através da API.
Para tal, deves verificar se o parâmetro event_id está a ser transmitido com as conversões capturadas pela Tag do Pinterest e pela API do Pinterest para Conversões.
Desta forma, o nosso sistema reconhecerá os event_ids como duplicados e reterá apenas a primeira conversão capturada. Para garantir que essa eliminação de duplicação é bem-sucedida, event_ids deverá ser:
Com base nesse identificador de evento e no event_name, o Pinterest removerá os eventos duplicados do registo, desde que (a) o evento não tenha ocorrido offline (action_source não está offline) e (b) o Pinterest receba os eventos duplicados com um intervalo de 48 horas.
Depois de concluir a configuração da API, podes verificar se os eventos de conversão estão a ser recebidos, através das seguintes verificações:
- Inicia sessão na tua
Conta de empresa do Pinterest - Clica em Anúncios no menu superior e seleciona Conversões
- Seleciona Eliminação de duplicações, na navegação do lado esquerdo.
Resiliência é o estado de uma API para configuração de conversões, que permite o mais alto nível de correspondência e atribuição de sinal. Estes dados adicionais vão ajudar-nos a fornecer relatórios mais precisos à medida que as políticas do setor de anúncios mudam e evoluem.
Existem duas categorias de estado de resiliência: bom e mau. O estado de resiliência é visível na secção Estado de conversões do Gestor de anúncios.
Boa resiliência
Opção 1: cobertura do identificador específico
- 90% ou mais dos eventos devem ter IP/UA,
- 10% ou mais dos eventos do fundo do funil têm e-mails com hash ou MAID,
- 10% ou mais dos eventos têm ID externo.
- 90%* ou mais dos eventos da tag devem ser recebidos através do CAPI
Ou:
Opção 2: atingir a taxa de correspondência base
Má resiliência
Qualquer configuração que não seja boa.
Envia os seguintes sinais para atingir o estado de anunciante resiliente.
| ID/Sinais da API | Importância/Classificação |
|---|---|
| client_ip_address + client_user_agent | Alta |
| em | Alta |
| external_id | Alta |
| hashed_maid | Alta |
| click_id | Alta |
| fn + ln | Baixa |
| ph | Baixa |
| ge, bd, ct, st, zp, country | Baixa |
*Importância/classificação com base na probabilidade de aumentar a taxa de correspondência
O Pinterest tem várias integrações de terceiros para ajudar a apoiar o processo de adoção de API.
Gestor de Etiquetas da Google – lado do servidor
Associa a tua conta Gestor de Etiquetas da Google à API do Pinterest para conversões para teres noção da influência do Pinterest no tráfego para a tua loja e nas vendas dos teus produtos.
Esta integração requer que implementes um contentor de servidor com o teu fornecedor de nuvem preferencial e conhecimentos sobre tags do lado do servidor. Para mais informações sobre os pré-requisitos, visita o
Shopify
Esta integração da API para conversões complementa a Tag do Pinterest para garantir uma elevada cobertura e qualidade de dados. Desde que a app do Shopify esteja instalada, não é necessária nenhuma ação para tirar partido desta melhoria. As alterações serão aplicadas automaticamente na loja do comerciante.
Tealium
Os anunciantes interessados no Tealium podem configurar a API para conversões diretamente com terceiros. O Tealium constrói o modelo e ajudará a facilitar a integração com o anunciante.
O processo de implementação é descrito no
Se estiveres interessado em integrações de terceiros adicionais, entra em contacto com o teu representante de vendas para mais informações.
A partir de 1 de janeiro de 2023, os anunciantes podem usar um sinalizador de Tratamento de Dados Limitado, com o objetivo de os ajudar a cumprir a Lei de Privacidade dos Consumidores da Califórnia, tal como alterada pela California Privacy Rights Act (em conjunto, CCPA). Com a implementação deste sinalizador, o Pinterest irá limitar a forma como utilizamos determinados dados, para ajudar os anunciantes a cumprir as definições de privacidade dos utilizadores. Por exemplo, um anunciante pode implementar o sinalizador de Tratamento de Dados Limitado para utilizadores da Califórnia que tenham optado por não vender ou partilhar os seus dados ao abrigo do CCPA. Quando o sinalizador de Tratamento de Dados Limitado for utilizado, o Pinterest atuará como um prestador de serviços no âmbito do CCPA, no que diz respeito a dados sinalizados dos utilizadores na Califórnia.
Os anunciantes são responsáveis pelo cumprimento dos opt-outs dos utilizadores, bem como pela identificação do estado de residência do utilizador ao implementar o sinalizador de Tratamento de Dados Limitado.