Configurar o conector de dados
- Métricas adicionais do Snapchat, como as Advanced Conversions do Snapchat, podem ser extraídas criando eventos de conversão (ver instruções abaixo).
Detalhes rápidos
| Tecnologia do conector de dados | API (Snapchat API v. 1 - ver documentação) |
| Desagregação de dados (segmentação) |
Seus dados são desagregados por Campanha, Subcampanha ("Ad Squad"), Plataforma, e Criativo. Além disso, o Snapchat permite escolher uma das seguintes desagregações:
observação: a desagregação por país não pode ser extraído com eventos offline; é uma limitação da rede. |
| Fuso horário | O fuso horário configurado para a sua conta de anúncios no Snapchat. |
| Os dados estão disponíveis no nível criativo? | Sim |
| O Singular mostra seus ativos criativos? |
Sim, para os seguintes tipos de anúncio do Snapchat:
Os ativos criativos não estão disponíveis para outros tipos de anúncio. |
Mapeamento de dados
- O Subcampanha da Singular corresponde ao Ad Squad.
- da Singular Criativo corresponde ao Ad.
- O video_views_15s do Snapchat pode ser extraído, mas você não poderá usar uma desagregação de dados.
Para ver a descrição de todos os campos, consulte o Glossário de métricas e dimensões da Singular.
| Field in Singular UI | Field in Singular API | Field in Network |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | Ad Account ID |
| Account Name | adn_account_name | Ad Account Name |
| App | app | App Name |
| App Site ID | app_site_id | Either 'iOS App ID" or "Google Play Store ID" |
| Bid Type |
bid_type |
optimization_goal |
| Campaign Objective |
campaign_objective |
Campaign Objective |
| Campaign Status |
campaign_status |
campaign status |
| Country | country_field | "Country Code" from the Targeting Spec for the Ad Squad |
| Creative ID | creative_id | Ad ID |
| Creative Name | creative_name | Ad Name |
| Date | date_field | Date |
| DMA ID |
dma_id_field | dma |
| DMA Name |
dma_name_field | |
| Network Campaign ID | adn_campaign_id | Campaign ID |
| Network Campaign Name | adn_campaign_name | Campaign Name |
| Network Creative ID | adn_creative_id | Ad ID |
| Network Creative Name | adn_creative_name | Ad Name |
| Network Sub Campaign ID | adn_sub_campaign_id | Ad Squad ID |
| Network Sub Campaign Name | adn_sub_campaign_name | Ad Squad Name |
| Original Bid Amount | original_bid_amount | bid_micro |
| Placement |
placement |
Placement_v2.snapchat_positions (if placement_v2.config == “AUTOMATIC” we hard coding - ["INTERSTITIAL_USER", "INTERSTITIAL_CONTENT","INSTREAM", "FEED", "GAMES"] |
| Platform | platform | OS Type |
| Public Id | site_public_id | iOS App ID Google Play Store ID |
| Region |
region_field |
region (in Region breakdown) regions (in DMA breakdown - it's possible to have multiple regions in the same DMA) |
| Sub Campaign ID | sub_campaign_id | Ad Squad ID |
| Sub Campaign Name | sub_campaign_name | Ad Squad Name |
| Metrics | ||
| Cost | adn_cost | Spend |
| Network Clicks | adn_clicks | Swipes |
| Network Impressions | adn_impressions | Impressions |
| Network Installs | adn_installs |
Total Installs (Installs reported using Snap's Ad Manager attribution logic.) |
| Original Cost | adn_original_cost | Spend |
| Original Currency | adn_original_currency | Pulled from the Ad Account's Currency |
| Video Views | video_views | video_views |
| Video Views 25% | video_views_25pct | quartile_1 (Video Views to 25%) |
| Video Views 50% | video_views_50pct | quartile_2 (Video Views to 50%) |
| Video Views 75% | video_views_75pct | quartile_3 (Video Views to 75%) |
| Completed Video Views | completed_video_views | view_completion |
A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.
Instruções especiais de configuração
Além das métricas que a Singular extrai do Snapchat por padrão, você pode extrair qualquer métrica do Snapchat e as Advanced Conversions (ver a lista) criando um evento de conversão na Singular.
Para criar um evento de conversão:
- Na Singular, acesse Settings > Events. Se você tiver as abas Custom Events e Conversion Events, selecione Conversion Events.
- Clique em New Event.
-
No Snapchat, selecione a métrica desejada.
No dia seguinte, quando a Singular extrair os dados diários da sua conta, ela também extrairá as conversões concluídas.
- Depois que o novo evento for preenchido com alguns dados, execute um relatório na página Reports, e escolha o evento de conversão que você criou no menu suspenso Events.
Para que a Singular obtenha dados do Snap em seu nome, a chave de usuário da API deve vir de um usuário cujo papel no Snap seja Org Admin, Account Admin ou Campaign Manager. Você pode seguir as etapas descritas aqui (link) e gerar um token de acesso. Esse token de acesso será usado como token Bearer nas requisições GET para obter esses dados pela Marketing API do Snap.
FAQ e solução de problemas
Entre as diversas métricas fornecidas pelo Snapchat, a integração da Singular reúne as métricas relevantes para o marketing mobile:
- Impressions
- Clicks
- Installs
- Cost
Além disso, a Singular pode obter estatísticas sobre as ações do usuário (conhecidas no Snap como Advanced Conversions), que na Singular são conhecidas como eventos de conversão. Consulte Configurar eventos personalizados abaixo para saber como configurar a Singular para obter esses dados do Snapchat.
Para começar a extrair dados do Snapchat para a Singular:
- Na plataforma da Singular, acesse Settings > Data Connectors.
- Passe o cursor sobre o botão Add New Connector e comece a digitar "Snapchat". Na lista exibida, escolha Snapchat.
-
Clique em Connect with Snapchat e faça login com um usuário do Snapchat que tenha acesso às contas de anúncios necessárias.
Observação: Antes de clicar no botão, verifique se você não está conectado ao Snapchat com uma conta não relacionada (como sua conta pessoal).