DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

Snapchat Ads

Última atualização: 2 de outubro de 2026

Criado para:

  • Developer
NOTE
A origem Snapchat Ads está na versão beta. Leia a Visão geral das fontes para obter mais informações sobre o uso de conectores rotulados com beta.
IMPORTANT
A origem Snapchat Ads está disponível como parte da SKU Customer Journey Analytics.

A origem Snapchat Ads é um conector de mídia paga do Adobe Experience Platform. Use-o para conectar suas contas de anúncio do Snapchat e assimilar dados de campanha, publicidade e desempenho, como métricas de envolvimento, na Experience Platform.

O conector publica os dados capturados nos conjuntos de dados de Mídia paga. A Customer Journey Analytics usa esses conjuntos de dados para fornecer informações sobre suas campanhas de marketing do Snapchat.

Para conectar sua conta, entre no Snapchat e autorize a Experience Platform a acessar sua Organização do Ads Manager. Não é necessário gerar ou fornecer credenciais de API manualmente.

Como funciona

Depois de criar um fluxo de dados Snapchat Ads e selecionar as contas de anúncio para direcionamento, o Experience Platform executa automaticamente os seguintes trabalhos.

  • Se os conjuntos de dados de Mídia paga ainda não existirem para sua organização, a Experience Platform os criará.
  • Um trabalho de preenchimento retroativo é executado 30 minutos após a criação do fluxo de dados. Ele busca metadados e métricas de campanha e anúncios para as contas de anúncios dos últimos 30 dias e publica os resultados nos conjuntos de dados de Mídia paga.
  • Um job incremental é executado uma vez por dia, iniciando no dia seguinte à criação do fluxo de dados. Ele busca metadados e métricas do dia anterior e publica os resultados nos conjuntos de dados de Mídia paga.
  • Um job de reexpressão é executado após cada job incremental. A reexpressão ocorre três vezes: um, dois e três dias após o trabalho incremental ao qual corresponde.

Pré-requisitos

Antes de conectar Snapchat Ads ao Experience Platform, verifique se você tem o seguinte:

  • Uma conta de anúncio Snapchat existente ou a capacidade de criar uma.
  • Campanhas e anúncios já configurados em sua conta de anúncio Snapchat. O conector lê a partir desses dados de publicidade existentes. Ele não cria, modifica ou exclui Snapchat campanhas, anúncios ou outros recursos.

Provisionamento de esquema e conjunto de dados

A origem Snapchat Ads atribui automaticamente um conjunto de dados, esquema e mapeamento de campo de destino. Você não seleciona um conjunto de dados de destino ou mapeia campos sozinho ao criar o fluxo de dados.

O conector provisiona um conjunto de dados de Mídia paga por tipo de entidade: conta, campanha, grupo de anúncios, anúncio, ativo e métricas de resumo. Leia a seção a seguir para os campos de identidade principais que o conector mapeia para cada entidade.

Esquema XDM Snapchat Ads

Leia esta seção para obter informações sobre os campos de identidade e status principais que a origem Snapchat Ads mapeia para cada esquema de Mídia paga. Todo registro mapeado também inclui um valor entityType que identifica a entidade e um valor paidMedia.adNetwork de snapchat.

Campos de conta

O esquema de conta armazena os detalhes da sua conta de anúncio Snapchat.

Campo Snapchat
Campo XDM
Descrição
id
paidMedia.accountID
O identificador exclusivo da conta de anúncio em Snapchat.
name
paidMedia.accountDetails.accountName
O nome de exibição da conta do anúncio.
status
paidMedia.metadata.status
O status da conta, como ativo.
created_at
paidMedia.metadata.createdTime
O carimbo de data/hora de criação da conta.
updated_at
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação da conta.

Campos de campanha

O esquema de campanha armazena os detalhes da campanha Snapchat.

Campo Snapchat
Campo XDM
Descrição
id
paidMedia.campaignID
O identificador exclusivo da campanha em Snapchat.
ad_account_id
paidMedia.accountID
O identificador da conta de anúncio principal.
name
paidMedia.metadata.name
O nome de exibição da campanha.
status
paidMedia.metadata.status
O status da campanha, como ativo ou pausado.
created_at
paidMedia.metadata.createdTime
O carimbo de data e hora de criação da campanha.
updated_at
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação da campanha.

Campos de grupo de anúncios

Snapchat chama essa entidade de um esquadrão de publicidade. O esquema do grupo de anúncios armazena os detalhes do seu esquadrão de anúncios Snapchat.

Campo Snapchat
Campo XDM
Descrição
id
paidMedia.adGroupID
O identificador exclusivo do esquadrão de anúncios em Snapchat.
campaign_id
paidMedia.campaignID
O identificador da campanha principal.
name
paidMedia.metadata.name
O nome de exibição do esquadrão de anúncios.
status
paidMedia.metadata.status
O status do esquadrão de anúncios, como ativo ou pausado.
created_at
paidMedia.metadata.createdTime
O carimbo de data e hora de criação do esquadrão de publicidade.
updated_at
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação do esquadrão de anúncios.

Campos de publicidade

O esquema de anúncios armazena os detalhes do anúncio Snapchat.

Campo Snapchat
Campo XDM
Descrição
id
paidMedia.adID
O identificador exclusivo do anúncio em Snapchat.
ad_squad_id
paidMedia.adGroupID
O identificador do pelotão de anúncios principal.
name
paidMedia.metadata.name
O nome de exibição do anúncio.
status
paidMedia.metadata.status
O status do anúncio, como ativo ou pausado.
created_at
paidMedia.metadata.createdTime
O carimbo de data e hora de criação do anúncio.
updated_at
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação de anúncio.

Campos de ativos

Snapchat chama essa entidade de criativa. O esquema de ativo armazena seus detalhes criativos do Snapchat.

Campo Snapchat
Campo XDM
Descrição
id
paidMedia.assetID
O identificador exclusivo do criativo em Snapchat.
ad_account_id
paidMedia.accountID
O identificador da conta de anúncio principal.
name
paidMedia.metadata.name
O nome de exibição criativo.
review_status
paidMedia.metadata.status
O status da revisão criativa, como revisão pendente ou ativo.
created_at
paidMedia.metadata.createdTime
O carimbo de data e hora da criação criativa.
updated_at
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação criativa.

Campos de métricas de resumo

O esquema de métricas de resumo armazena dados de desempenho para suas contas, campanhas, esquadrões de anúncios, anúncios e criações do Snapchat. O Snapchat atualiza as métricas aproximadamente a cada 15 minutos e finaliza as métricas que não são de conversão 48 horas após o fim do dia no fuso horário da conta de anúncio.

Cada registro de métrica mapeia para o identificador da entidade que ele mede.

Entidade
Mapeia para o campo XDM
Conta
paidMedia.accountID
Campaign
paidMedia.campaignID
Grupo de publicidade
paidMedia.adGroupID
Anúncio
paidMedia.adID
Ativo
paidMedia.assetID

Próximas etapas

Depois de confirmar que você tem uma conta de anúncio Snapchat qualificada com campanhas e anúncios existentes, continue conectando o Snapchat Ads ao Experience Platform usando a interface do usuário.

Mais ajuda sobre este tópico

recommendation-more-help
experience-platform-help-sources