Configurar o conector de dados
Saiba como a Singular extrai os dados de custo de publicidade de Apple Search Ads (ASA) e os exibe nos seus relatórios.
Importante: o ASA tem duas soluções que os anunciantes podem usar: Advanced ou Basic (veja as diferenças aqui). As campanhas veiculadas na solução Basic do ASA não têm suporte na API de relatórios deles, portanto a Singular não conseguirá reportar os custos de publicidade dessas campanhas.
Atualizado em 11 de fevereiro de 2022: adicionada a dimensão Keyword Match Type.
Detalhes rápidos
| Tecnologia do conetor de dados | API (Apple Search Ads API v. 5) |
| Detalhamento de dados (segmentação) |
Os dados do Apple Search Ads são detalhados por:
Além disso, você pode escolher um dos seguintes detalhamentos:
Se você tiver interesse no detalhamento por cidade e região em vez do detalhamento por palavra-chave, entre em contato com seu Customer Success Manager ou com o suporte da Singular. |
| Qual o intervalo de tempo em que extraímos dados | 30 dias |
| Fuso horário | Por padrão, a Singular extrai os dados no fuso horário original que você definiu no dashboard da Apple. Entre em contato conosco se quiser que seus dados sejam extraídos em UTC. |
| Os dados estão disponíveis no nível criativo? | Sim |
| O Singular mostra seus ativos criativos? |
Sim — a Singular oferece suporte a prévias de criativos para o Apple Ads, tanto para Default e Custom Product Pages. A Singular reúne todos os ativos associados a uma página de produto e os combina em uma prévia em GIF. Observação: As prévias de criativos e o nome e ID da Custom Product Page só estão disponíveis no Creative IQ (CIQ). |
| A Singular oferece suporte ao ROI de Custom Product Page? |
Sim - Cada criativo do Apple Search Ads corresponde a uma e apenas uma Custom Product Page |
Mapeamento de dados
Dicas:
- da Singular Subcampanha corresponde ao Ad Group.
- O Publisher não é preenchido para este conector de dados, pois o publisher é o Apple Search Ads.
- Para ver a descrição de cada campo nos relatórios da Singular, consulte o Glossário de métricas e dimensões da Singular
| Field in Singular UI | Field in Singular API | Field in Apple |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | orgID |
| App | app | appName |
| App Site ID | app_site_id | adamId |
|
City |
city |
locality |
| Country | country_field | countryOrRegion OR countryCode |
|
Creative Format |
creative_format |
creativeType
|
| Creative ID | creative_id | adId |
| Creative Name | creative_name | adName |
| Date | date_field | date |
| Keyword | keyword | searchTermText OR keyword |
| Keyword ID | keyword_id | keywordId |
| Keyword Match Type | keyword_match_type | matchType |
| Network Campaign ID | adn_campaign_id | (campaign) id |
| Network Campaign Name | adn_campaign_name | (campaign) name |
| Network Creative ID | adn_creative_id | adId, |
| Network Creative Name | adn_creative_name | adName |
| Network Sub Campaign ID | adn_sub_campaign_id | (adGroup) id |
| Network Sub Campaign Name | adn_sub_campaign_name | (adGroup) name |
| OS | os | Always "iOS" (hardcoded) |
|
Platform |
platform |
deviceClass |
| Public Id | site_public_id | adamId |
|
Region |
region |
adminArea |
|
Sub Ad Network |
adn_subadnetwork |
adChannelType |
| Timezone | adn_timezone | timeZone |
| Ad Type | ad_type | SupplySources |
| Product Page ID | product_page_id | productPageId |
| Product Page Name | product_page_name | productPageName |
| Metrics | ||
| Network Clicks | adn_clicks | taps |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | installs |
| Original Cost | adn_original_cost | amount |
| Original Currency | adn_original_currency | currency |
A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.
Eventos/métricas adicionais
O Apple Search Ads também oferece relatórios de atribuição view-through autodeclarada. Atualmente, ele oferece esses dados apenas pela integração do conector de dados; a atribuição view-through de MMP ainda não tem suporte no Apple Search Ads. Para configurar os relatórios de view-through, você pode adicioná-lo à sua conta como um evento de conversão.
Para configurar eventos de conversão na Singular, siga estas etapas:
- Na Singular, acesse Settings > Events. Se você tiver as abas Custom Events e Conversion Events, selecione Conversion Events.
- Clique em New Event.
-
No Apple SearchAds você verá uma lista das métricas disponíveis no AppleSearchAds, incluindo "view installs count".
No dia seguinte, quando a Singular extrair os dados diários da sua conta, ela também extrairá as estatísticas dessas atividades.
Prévias de criativos
A Singular oferece suporte a prévias de criativos para o Apple Ads, tanto para Default Product Pages e Custom Product Pages.
A Singular reúne todos os ativos associados a uma página de produto e os combina em um único GIF animado, dando a você uma representação visual de como seu criativo aparece para os usuários.
Observação: As prévias de criativos e o nome e ID da Custom Product Page só estão disponíveis no Creative IQ (CIQ).
FAQ
R: Se você veicula uma campanha de "Search Results" e não atribuiu uma Custom Product Page (CPP) ou um Creative Set específico a um grupo de anúncios, a Apple usa automaticamente os metadados padrão do seu app (ícone, título, capturas de tela) para criar o anúncio. Como esse "anúncio" não foi criado explicitamente por você como um objeto separado, a API atribui a ele um ID de -1