LinkedIn Ads
Login automático, nada para digitar. O ponto que mais gera discussão com cliente não é a conexão: é que o LinkedIn tem duas métricas de vídeo com nomes parecidos, e elas não são o mesmo número.
Começar
Conectarlogin do LinkedIn
Em Fontes · Conectar nova fonte · LinkedIn Ads, o cartão abre direto o login. A janela só fecha depois que o caOS já buscou as contas, então lista vazia significa que aquele login não alcança conta de anúncio.
Em seguida marque as contas do cliente. Descobrir não é o mesmo que ser dono: o caOS traz todas as contas que o login alcança, inclusive de outros clientes da mesma agência.
A grade tem dois blocos de LinkedIn, Ads e Pages. Os dois usam a mesma autorização: conectar por um já liga o outro.
Confirme antes que a pessoa pode conceder as permissões. Em cliente com política de aprovação de aplicativos, isso costuma exigir uma conversa antes, e não durante.
Sua credencial, e o que acontece com ela
Conectou uma vez, está conectado. A credencial se renova sozinha, indefinidamente. Você não precisa marcar data no calendário nem reconectar de tempos em tempos.
Só existe um jeito de a conexão cair: alguém revogar o acesso do lado da plataforma (senha trocada, pessoa removida da conta, autorização cancelada). Aí a conta aparece em Conexões perdidas e reconectar resolve, com as tags que ela já tinha.
A credencial fica cifrada de ponta a ponta. Ela é cifrada antes de ser gravada, e a chave não vive no banco: nem quem tem acesso ao banco lê o valor. Ninguém no caOS, nem você, vê a credencial de volta depois de salva; a tela mostra apenas que ela existe e está válida.
Só é lida a métrica que você pediu. O caOS não escreve na sua conta de anúncio para extrair dados, e não guarda dado pessoal de quem viu o anúncio. O tratamento segue a LGPD, e a exclusão é sua: revogar a conexão apaga a credencial guardada.
Referência
Métricas e dimensõeso que cada campo quer dizer
“Reproduções” e “Visualizações” não são a mesma métrica.
videoViews conta 2 segundos ou mais com metade do vídeo na tela, e
é o padrão do LinkedIn. videoStarts conta o vídeo ter começado a
tocar, e um quadro já vale. Reproduções é sempre o número maior: numa campanha
inteira medida, a diferença foi de 7,4%. O que vira visualização de vídeo nos
relatórios é a Visualização. Se o print do cliente diz Reproduções e o seu
painel mostra menos, as métricas são diferentes.
Métricas principais10
| Campo na API | O que é | Onde aparece |
|---|---|---|
| costInLocalCurrency | Investimento, na moeda da conta. | Chega como texto. Converta antes de somar. |
| impressions | Quantas vezes o anúncio foi exibido. | Impressões. |
| clicks | Todos os cliques. | Para clique que vai para o site, use landingPageClicks. |
| totalEngagements | Soma das interações que o LinkedIn considera engajamento. | É o campo pronto, em vez de somar reações, comentários e compartilhamentos na mão. |
| videoViews | Visualizações: 2 segundos com metade do vídeo na tela. | É o que vira visualização de vídeo nos relatórios. É o padrão do LinkedIn. |
| videoStarts | Reproduções iniciadas: um quadro já conta. | É o que a interface do LinkedIn chama de Reproduções. Sempre maior que o de cima. |
| videoCompletions | Assistiu até o fim. Há também os três quartis. | Só existe na tabela por campanha. |
| approximateMemberReach | Pessoas diferentes alcançadas, aproximado. | Não some. Some em janela longa, ver Bom saber. |
| oneClickLeads | Leads pelo formulário nativo. | Com oneClickLeadFormOpens, que é quem abriu. |
| externalWebsiteConversions | Conversões no site, pela tag do LinkedIn. | Depende de a tag estar instalada no cliente. |
Dimensões3
| Campo na API | O que é | Onde aparece |
|---|---|---|
| day | O dia da linha. | Toda tabela de desempenho vem por dia. |
| campaign_id | A campanha do LinkedIn, que é o conjunto. | O que o cliente chama de campanha é o grupo de campanha, tabela à parte. |
| account_id | A conta de anúncio. | Presente nas duas tabelas de desempenho. |
Parâmetros do relatório
Os campos acima dizem o que volta. Estes parâmetros dizem como: eles decidem o grão da linha, o período que ela cobre e o que conta como conversão. Dois relatórios da mesma conta com números diferentes quase sempre diferem aqui.
| Parâmetro | O que muda | Valores |
|---|---|---|
| pivot | O grão de cada linha. | CAMPAIGN (que é o conjunto) e CREATIVE. A API recusa dois pivots juntos: pedir campanha e região na mesma chamada devolve HTTP 400. |
| timeGranularity | A agregação. | O caOS pede DAILY. A API também aceita mensal e o período inteiro numa linha. |
| fields | As métricas pedidas. | A lista da tabela acima. Campo de segmentação não entra: são objetos complexos e derrubam a carga. |
| dateRange | O período. | Vem da fonte. Acima de ~90 dias o alcance para de vir, sem erro. |
Tudo que dá para puxar
As tabelas acima são as que a maior parte dos relatórios usa, mas você não está preso a elas. O catálogo inteiro do LinkedIn tem 8 tabelas e 148 campos, e ao montar a fonte você escolhe o que entra. O que aparece marcado como puxada por padrão é o que a fonte de exemplo usa; o resto está disponível do mesmo jeito.
A lista abaixo sai do próprio catálogo do Xtractor, o mesmo que a tela de nova fonte lê. Se um campo está aqui, a tela oferece.
campaigns36 campos
storyDeliveryEnabled, targeting, targetingCriteria, servingStatuses, totalBudget, version_tag, locale, version, associatedEntity, associated_entity_organization_id, associated_entity_person_id, optimizationTargetType, changeAuditStamps, campaignGroup, campaign_group_id, dailyBudget, unitCost, creativeSelection, costType, name, objectiveType, offsiteDeliveryEnabled, offsitePreferences, id, audienceExpansionEnabled, test, format, pacingStrategy, account, account_id, status, type, created_time, last_modified_time, run_schedule_start, run_schedule_end
ad_analytics_by_campaign puxada por padrão25 campos
campaign_id, clicks, costInLocalCurrency, comments, dateRange, day, impressions, landingPageClicks, likes, oneClickLeadFormOpens, oneClickLeads, otherEngagements, shares, totalEngagements, videoViews, videoFirstQuartileCompletions, videoMidpointCompletions, videoThirdQuartileCompletions, videoCompletions, reactions, follows, videoStarts, externalWebsiteConversions, approximateMemberReach, account_id
accounts21 campos
changeAuditStamps, created_time, last_modified_time, currency, id, name, notifiedOnCampaignOptimization, notifiedOnCreativeApproval, notifiedOnCreativeRejection, notifiedOnEndOfCampaign, notifiedOnNewFeaturesEnabled, reference, reference_organization_id, reference_person_id, servingStatuses, status, total_budget, total_budget_ends_at, type, test, version
creatives18 campos
account, account_id, campaign, campaign_id, content, reference, review, createdAt, created_time, last_modified_time, createdBy, lastModifiedAt, lastModifiedBy, id, intendedStatus, isServing, isTest, servingHoldReasons
campaign_groups15 campos
changeAuditStamps, created_time, last_modified_time, name, servingStatuses, backfilled, id, account, account_id, status, total_budget, test, allowed_campaign_types, run_schedule_start, run_schedule_end
ad_analytics_by_creative puxada por padrão14 campos
clicks, shares, landingPageClicks, comments, creative_id, costInLocalCurrency, dateRange, day, impressions, likes, oneClickLeadFormOpens, oneClickLeads, otherEngagements, totalEngagements
video_ads10 campos
account, account_id, changeAuditStamps, created_time, last_modified_time, content_reference, content_reference_ucg_post_id, content_reference_share_id, name, type
account_users9 campos
account, campaign_contact, account_id, changeAuditStamps, created_time, last_modified_time, role, user, user_person_id
Saída
Onde os dados chegamplanilha e banco são coisas diferentes
Planilha do Google
Para quem monta relatório na mão
Marque investimento, impressões, cliques e o nome. Lembre que o investimento do LinkedIn chega como texto: se a soma da planilha der zero, é isso.
Para o cliente reconhecer o nome da campanha, marque também a tabela de grupos de campanha: o que ele chama de campanha vive lá.
BigQuery
Para quem vai modelar em cima
8 conjuntos de dados. Desempenho em dois níveis, sempre por dia: por campanha do LinkedIn (que é o conjunto), com 25 campos incluindo alcance, engajamento e vídeo; e por criativo, com 14 campos, sem vídeo e sem alcance.
Estrutura: contas, usuários da conta, grupos de campanha, campanhas, criativos e anúncios de vídeo.
Confiança
Atualização do dadopor que o número de ontem ainda muda
Plataforma de anúncio reescreve o passado. Conversão que só é atribuída dias depois, gasto revisado, linha corrigida: o número de terça-feira muda na quinta. Se a extração só trouxesse o dia novo, sua planilha ficaria congelada no primeiro valor e passaria a divergir da plataforma sem ninguém perceber.
Por isso o caOS relê os últimos 30 dias a cada sincronização, e reescreve o que mudou. O histórico mais antigo continua no destino e não é tocado. Na prática: o que está na sua planilha ou no seu banco é o que a plataforma diz hoje, não o que ela dizia no dia da primeira carga.
Alcance é o caso especial. Ele é aproximado e o LinkedIn para de devolvê-lo, sem erro nenhum, quando o período pedido passa de cerca de 90 dias. Se a primeira carga tem data de início antiga e o alcance vem vazio, é isso. As outras métricas vêm normalmente.
Detalhe
Bom sabero que costuma gerar dúvida
A “campanha” do LinkedIn é o conjunto. O que o cliente chama de campanha é o grupo de campanha. A tabela de desempenho vem no nível do conjunto. Para ter o nome que ele reconhece, marque também a tabela de grupos.
Vídeo, reações, seguidores e alcance só existem por campanha. A tabela por criativo tem custo, impressões, cliques e engajamento, e nada de vídeo ou alcance.
Não há quebra por região nem demográfica. Quando essa quebra foi construída por fora, a plataforma recusou pedir campanha e região juntas, e a cobertura ficou perto de metade das impressões: o LinkedIn não atribui região ao resto, por limiar de privacidade.
Dois campos que quebram a carga. Os campos de segmentação da tabela de campanhas são objetos complexos e já derrubaram o carregamento. Marque só os campos simples que você usa.
Suporte
Quando dá erradoa mensagem e o que fazer
“Invalid state.” A janela ficou aberta mais de 10 minutos, ou o link foi usado duas vezes. Recomece pelo botão.
Diz que autenticou e nenhuma conta aparece. Ou o login não tem acesso a conta de anúncio nenhuma, ou a busca falhou. Recarregue Fontes; continuando vazio, refaça com o login certo.
O cartão aparece com cadeado ao criar a fonte. O caOS só libera o LinkedIn quando existe conta escolhida: credencial ativa sem conta adicionada vale o mesmo que nenhuma conexão.
Faltam contas, e não eram as descartadas. O caOS pede uma página de 100 contas e não continua a partir dali. Login que alcança mais de 100 traz só as 100 primeiras. Autorize com um login de escopo menor.