Conector de datos de Apple Ads (formerly Apple Search Ads)

Apple Search Ads

Descubre cómo Singular extrae los datos de costo publicitario de Apple Search Ads (ASA) y los muestra en tus reportes.

Importante: ASA tiene dos soluciones que los anunciantes pueden usar: Advanced o Basic (consulta las diferencias aquí). Las campañas que se ejecutan en la solución Basic de ASA no están soportadas en su API de reportes, por lo que Singular no podrá reportar los costos publicitarios de esas campañas.

Actualizado el 11 de febrero de 2022: se agregó la dimensión Keyword Match Type.

Detalles rápidos

Tecnología del conector de datos API (Apple Search Ads API v. 5)
Desglose de datos (segmentación)

Los datos de Apple Search Ads se desglosan por:

  • Campaña
  • Subcampaña (Ad Group)
  • País

Además, puedes elegir uno de los siguientes desgloses:

  • Palabra clave (palabra clave de búsqueda) - predeterminado
  • Ciudad y región

Si te interesa el desglose por ciudad y región en lugar del desglose por palabra clave, comunícate con tu Customer Success Manager o con el soporte de Singular.

Desde cuándo extraemos datos 30 días
Zona horaria De forma predeterminada, Singular extrae los datos en la zona horaria original que definiste en el dashboard de Apple. Comunícate con nosotros si quieres que tus datos se extraigan en UTC.
¿Hay datos disponibles a nivel creativo?
¿Muestra Singular tus activos creativos?

Sí: Singular admite las vistas previas de creativos para Apple Ads, tanto para Default y Custom Product Pages.

Singular toma todos los activos asociados con una página de producto y los combina en una vista previa en GIF.

Nota: Las vistas previas de creativos y el nombre e ID de la Custom Product Page solo están disponibles en Creative IQ (CIQ).

¿Singular admite el ROI de Custom Product Page?

- Cada creativo de Apple Search Ads corresponde a una y solo una Custom Product Page
- Cuando no hay variaciones de página de producto asociadas con un creativo, se mostrará la página de producto predeterminada en product page id y product page name.
- ¿Cómo ver el ROI de la Custom Product Page?
Simplemente agrega métricas de ROI junto con el creativo y el Product Page ID en tus reportes de creativos de ASA.

Mapeo de datos

Sugerencias:

  • de Singular Subcampaña corresponde al Ad Group.
  • El Publisher no se completa para este conector de datos, ya que el publisher es Apple Search Ads.
  • Para ver la descripción de cada campo en los reportes de Singular, consulta el Glosario de métricas y dimensiones de 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
Possible values:

  • DEFAULT_PRODUCT_PAGE
  • CUSTOM_PRODUCT_PAGE
  • IMAGE
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

Singular también admite la extracción de propiedades de campaña para este partner: consulta más detalles aquí.

Eventos/métricas adicionales

Apple Search Ads también ofrece reportes de atribución view-through autodeclarada. Por ahora solo ofrece estos datos mediante la integración del conector de datos; la atribución view-through de MMP aún no está soportada por Apple Search Ads. Para configurar los reportes de view-through, puedes agregarlo a tu cuenta como un evento de conversión.

Para configurar eventos de conversión en Singular, sigue estos pasos:

  1. En Singular, ve a Settings > Events. Si tienes las pestañas Custom Events y Conversion Events, selecciona Conversion Events.
  2. Haz clic en New Event.
  3. En el Apple SearchAds verás una lista de las métricas disponibles en AppleSearchAds, incluida "view installs count".

    Al día siguiente, cuando Singular extraiga los datos diarios de tu cuenta, también extraerá las estadísticas de estas actividades.

Vistas previas de creativos

Singular admite las vistas previas de creativos para Apple Ads, tanto para Default Product Pages y Custom Product Pages.

Singular toma todos los activos asociados con una página de producto y los combina en un único GIF animado, dándote una representación visual de cómo se ve tu creativo para los usuarios.

Nota: Las vistas previas de creativos y el nombre e ID de la Custom Product Page solo están disponibles en Creative IQ (CIQ).

FAQ

P: ¿Por qué veo -1 en el nombre del creativo o en el Creative id?

R: Si ejecutas una campaña de "Search Results" y no has asignado una Custom Product Page (CPP) o un Creative Set específico a un grupo de anuncios, Apple usa automáticamente los metadatos predeterminados de tu app (icono, título, capturas de pantalla) para crear el anuncio. Como ese "anuncio" no lo creaste explícitamente como un objeto aparte, la API le asigna un ID de -1