API de Chartboost — Métodos de analíticas

Última actualización:

 

El endpoint de analíticas de campaña ofrece informes detallados que pueden agruparse por aplicación o creatividad. Al especificar un campo de groupBy (agrupar por), el sistema de analíticas en espera devolverá un ID de trabajo tal y como se detalla en la sección "Antes de empezar".


Método HTTP GET
Endpoint https://analytics.chartboost.com/v3/metrics/campaign
Ejemplo de solicitud https://analytics.chartboost.com/v3/metrics/campaign?dateMin={{fecha mínima}}&dateMax={{fecha máxima}}&userId={{ID de usuario del cliente de Chartboost}}&userSignature={{firma de usuario del cliente de CB}}

Parámetros
Parámetro Tipo de solicitud ¿Requerido? Descripción Por defecto
aggregate String Opcional Agregar resultados con el tiempo (diario, semanal, mensual) Diario
campaignId String Opcional ID de campaña (puede ser A ID de campaña o De ID de campaña basado en groupBy y rol) N/D
campaignType String Opcional network, cross_promo, direct_deal network, direct_deal
dateMin String Requerido La fecha mínima (AAAA-MM-DD) N/D
dateMax String Requerido La fecha máxima (AAAA-MM-DD) N/D
groupBy String Opcional Uno de los siguientes: 'country' 'app' 'app,creative' 'target_creative' 'date' 'campaign' 'campaign_target' 'campaign_type' Ninguna
plataforma String Opcional Filtrar por plataformas específicas (iOS, Google Play, Amazon) Todo
rol String Opcional anunciante u ofertante Ambos

Campos de respuesta
Parámetro Descripción Devuelto para ...
adTypeId 1 = interstitial
2 = more_apps
3 = in_play
4 = rewarded_video
5 = video_interstitial
Todos
app Nombre de la aplicación Todos
campaña Nombre de la campaña Todos
campaignId ID de campaña (puede ser A ID de campaña o De ID de campaña basado en groupBy y rol) Todos
campaignTarget Nombre del objetivo de campaña (devuelto solo al agrupar por campaign_target) Anunciantes
campaignSubType user_acquisition o retargeting Todos
clicksDelivered Clics entregados Ofertantes
clicksReceived Clics recibidos Anunciantes
cpcvEarned Ratio de dinero ganado por vistas de video completadas a número de vistas de video completadas Ofertantes
cpcvSpent Ratio de dinero gastado por vistas de video completadas a número de vistas de video completadas Anunciantes
creatividad Nombre de la creatividad anunciada (devuelto solo al agrupar por creative) Anunciantes
ctrDelivered Ratio de cliqueo para las impresiones entregadas Ofertantes
ctrReceived Ratio de cliqueo para las impresiones recibidas Anunciantes
dt Fecha (AAAA-MM-DD) Todos
ecpmEarned Ganancias por 1000 impresiones Ofertantes
ecpmSpent Costo por 1,000 impresiones Anunciantes
impressionsDelivered Impones entregadas por el ofertante Ofertantes
impressionsReceived Impressions recibidas por el anunciante Anunciantes
installDelivered Instalaciones entregadas Ofertantes
installRateDelivered Ratio de instalaciones Ofertantes
installRateReceived Ratio de instalaciones Anunciantes
installReceived Instalaciones Anunciantes
moneyEarned Dinero ganado Ofertantes
moneySpent Dinero gastado Anunciantes
videoCompletedDelivered Vistas de video completadas entregadas Ofertantes
videoCompletedReceived Vistas de video completadas recibidas Anunciantes

▲ Volver arriba

 

El endpoint de analíticas de aplicación ofrece informes detallados que pueden agruparse por aplicación, tipo de anuncio o ubicación de anuncio.


Método HTTP GET
Endpoint https://analytics.chartboost.com/v3/metrics/app
Ejemplo de solicitud https://analytics.chartboost.com/v3/metrics/app?dateMin={{fecha mínima}}&dateMax={{fecha máxima}}&userId={{ID de usuario del cliente de Chartboost}}&userSignature={{firma de usuario del cliente de CB}}

Parámetros
Parámetro Tipo de solicitud ¿Requerido? Descripción Por defecto
aggregate String Opcional Agregar resultados con el tiempo (diario, semanal, mensual) Diario
appId String Opcional Uno o más IDs de aplicación (separados por comas) Todo
dateMax String Requerido La fecha máxima (AAAA-MM-DD) N/D
dateMin String Requerido La fecha mínima (AAAA-MM-DD) N/D
groupBy String Opcional Uno de los siguientes: app, ad_type,app, date, ad_location (solo ofertantes), platform, campaign_type Ninguna
plataforma String Opcional Cualquiera de los siguientes: iOS, Google Play, Amazon Todo
rol String Opcional anunciante u ofertante Ambos

Campos de respuesta
Parámetro Descripción Devuelto para ...
ad_type Tipo de anuncio creativo
Más información sobre tipos de anuncios ▶
Todos, solo cuando groupBy=ad_type,app
allInstalls Número de instalaciones totales acumuladas independientemente de su origen (Chartboost u otro) Todos
app Nombre de la aplicación Todos
appBundleId Ya no se envía; el usuario verá Desfasado en los informes Todos
appId ID de aplicación de Chartboost Todos
Iniciaciones Número de veces que un usuario abre tu aplicación en un dispositivo Todos
campaignType network, cross_promo, direct_deal Todos
clicksDelivered Clics entregados Ofertantes
clicksReceived Clics recibidos Anunciantes
cpcvEarned Ratio de dinero ganado por vistas de video completadas a número de vistas de video completadas Ofertantes
cpcvSpent Ratio de dinero gastado por vistas de video completadas a número de vistas de video completadas Anunciantes
ctrDelivered Ratio de cliqueo para las impresiones entregadas Ofertantes
ctrReceived Ratio de cliqueo para las impresiones recibidas Anunciantes
dt Fecha (AAAA-MM-DD) Todos
ecpmEarned Ganancias por 1000 impresiones Ofertantes
ecpmSpent Costo por 1,000 impresiones Anunciantes
eventLocation La ubicación con nombre de Chartboost del anuncio publicado en la aplicación. Los anunciantes verán default en el campo de respuesta. Todos
impressionsDelivered Impones entregadas por el ofertante Ofertantes
impressionsReceived Impressions recibidas por el anunciante Anunciantes
installDelivered Instalaciones entregadas Ofertantes
installRateDelivered Ratio de instalaciones Ofertantes
installRateReceived Ratio de instalaciones Anunciantes
installReceived Instalaciones Anunciantes
moneyEarned Dinero ganado Ofertantes
moneySpent Dinero gastado Anunciantes
plataforma iOS, Google Play o Amazon Todos
únicos Número de dispositivos únicos que han inicializado la aplicación Todos
videoCompletedDelivered Vistas de video completadas entregadas Ofertantes
videoCompletedReceived Vistas de video completadas recibidas Anunciantes

▲ Volver arriba

 

El endpoint de exportar instalaciones ofrece una lista completa de instalaciones recibidas y/o proporcionadas. Este endpoint siempre devuelve un ID de trabajo del sistema de analíticas en espera como se detalla en la sección "Antes de empezar".


Método HTTP GET
Endpoint https://analytics.chartboost.com/v3/metrics/install
Ejemplo de solicitud https://analytics.chartboost.com/v3/metrics/install?dateMin={{fecha mínima}}&dateMax={{fecha máxima}}&userId={{ID de usuario del cliente de Chartboost}}&userSignature={{firma de usuario del cliente de CB}}

Parámetros
Parámetro Tipo de solicitud ¿Requerido? Descripción Por defecto
campaignIds Cadena Opcional Uno o más IDs de campaña (separados por comas) Todas las campañas
campaignType Cadena Opcional networkcross_promo o direct_deal Todo
dateMax Cadena Requerido La fecha máxima (AAAA-MM-DD) N/D
dateMin String Requerido La fecha mínima (AAAA-MM-DD) N/D
plataforma Cadena Opcional Cualquiera de los siguientes: iOS, Google Play, Amazon Todo
rol String Opcional anunciante u ofertante Ambos

Campos de respuesta
Parámetro Descripción Devuelto para ...
Tipo de anuncio Tipo de anuncio creativo
Más información sobre tipos de anuncios ▶
Todos
Registro de fecha del clic Fecha y hora (DD-MM-AAA HH:MM:SS) Todos
Tipo de costo Tipo de puja de anuncio
Más información sobre los tipos de puja ▶
Todos
Valor del costo Cantidad de la puja de anuncio Todos
País Código de país de dos letras del dispositivo Todos
Fecha Fecha y hora (DD-MM-AAA HH:MM:SS) Todos
Del bundle de aplicación ID de bundle de la aplicación ofertante Todos
De ID de la aplicación ID de la aplicación ofertante Todos
De nombre de la aplicación Nombre de la aplicación ofertante Todos
De ID de campaña ID de la campaña de ofertas Ofertantes
De nombre de campaña Nombre de la campaña de ofertas Ofertantes
De tipo de campaña networkcross_promodirect_deal Ofertantes
GAID ID de Google Advertising Todos (el ofertante solo si la segmentación por comportamiento está desactivada)
IFA Identificador de iOS para anunciantes (si el Limit Ad Tracking de iOS 10 está desactivado) Todos (el ofertante solo si la segmentación por comportamiento está desactivada)
MAC Dirección MAC (desfasada) N/D
Modelo Modelo de dispositivo Todos
OS Sistema operativo del sistema Todos
A bundle de aplicación ID de bundle de la app anunciada Todos
A ID de la aplicación ID de la app anunciada Todos
A nombre de la aplicación Nombre de la app anunciada Todos
A ID de campaña ID de la campaña de anuncios Anunciantes
A nombre de la campaña Nombre de la campaña de anuncios Anunciantes
A objetivo de campaña ID del objetivo de la campaña de anuncios Todos
A Tipo de campaña networkcross_promodirect_deal Anunciantes
UUID Identificador único universal de dispositivo (si está disponible) Todos (el ofertante solo si la segmentación por comportamiento está desactivada)

▲ Volver arriba

 

Además de los endpoints que encontrarás en la página Explorador de APU del panel de control, hemos creado uno diseñado para ofrecer datos de analíticas a nivel de aplicación, fecha y país. Los servicios de atribución y mediación de terceros que necesiten datos de país pueden utilizar este endpoint en nombre de clientes de Chartboost.

Nota para redes de mediación: Te recomendamos que omitas el campo campaignType, ya que el API devuelve automáticamente resultados de network,direct_deal.
Los datos de MoreApps no están incluidos en esta API. Puede haber discrepancias entre los endpoints de aplicación y campaña en las analíticas de tu panel de control. Utiliza el endpoint de campaña y agrupa por país para obtener datos de aplicación, país y ad_type.

Método HTTP GET
Endpoint https://analytics.chartboost.com/v3/metrics/appcountry
Ejemplo de solicitud https://analytics.chartboost.com/v3/metrics/appcountry?dateMin={{fecha mínima}}&dateMax={{fecha máxima}}&userId={{ID de usuario del cliente de Chartboost}}&userSignature={{firma de usuario del cliente de CB}}

Parámetros
Parámetro Tipo de solicitud ¿Requerido? Descripción Por defecto
appIds String Opcional Uno o más IDs de aplicación (separados por comas) Todas las aplicaciones
dateMin String Requerido La fecha mínima (AAAA-MM-DD) N/D
dateMax Cadena Requerido La fecha máxima (AAAA-MM-DD) N/D
campaignType Cadena Opcional networkcross_promo o direct_deal network,direct_deal
adTypeIds String Opcional Una o más IDs de tipo de anuncio (separados por comas):1 = interstitial, 3 = in_play, 4 = rewarded_video, 5 = video_interstitial 1,4,5
rol String Opcional anunciante u ofertante ofertante
adLocation String Opcional Una o más adLocations
(separadas por comas)
  • Caso #1: (adLocation=<value which is not 'all'>) muestra resultados agregados para casa adLocation presentados SOLO para la ubicación o ubicaciones (adLocation) especificadas. La información para las adLocation solo está disponible si la adLocation en una de las 3 más utilizadas por la aplicación del ofertante. No se devuelven datos de las demás adLocation.
  • Caso #2: (adLocation='all') muestra resultados divididos hasta en 3 adLocation para una aplicación de ofertante, con el resto de los datos agregados bajo adLocation = 'other'
  • Caso #3: (adLocation= vacía o no pasada)agrega todos los datos bajo adLocation = 'overall'. No se divide por adLocation.
ver caso #3

Campos de respuesta
Parámetro Descripción Devuelto para ...
adLocation La ubicación con nombre de Chartboost del anuncio publicado en la aplicación. Los anunciantes verán default en el campo de respuesta. Todos
adType interstitial, rewarded_video, video_interstitial Todos
app Nombre de la aplicación Todos
campaignType red, promoción_cruzada, acuerdo_directo Todos
clicksDelivered Clics Ofertantes
clicksReceived Clics Anunciantes
countryCode Código de dos letras o "desconocido" Todos
cpcvEarned Ratio de dinero ganado por vistas de video completadas a número de vistas de video completadas Ofertantes
cpcvSpent Ratio de dinero gastado por vistas de video completadas a número de vistas de video completadas Anunciantes
ctrDelivered Ratio de cliqueo Ofertantes
ctrReceived Ratio de cliqueo Anunciantes
dt Fecha (AAAA-MM-DD) Todos
ecpmEarned Ganancias por 1000 impresiones Ofertantes
ecpmSpent Costo por 1000 impresiones Anunciantes
impressionsDelivered Impresiones Ofertantes
impressionsReceived Impresiones Anunciantes
installRateDelivered Ratio de instalaciones Ofertantes
installRateReceived Ratio de instalaciones Anunciantes
installsDelivered Instalaciones Ofertantes
installsReceived Instalaciones Anunciantes
moneyEarned Dinero ganado Ofertantes
moneySpent Dinero gastado Anunciantes
plataforma iOS, Google Play o Amazon Todos
videoCompletedDelivered Vistas de video completadas Ofertantes
videoCompletedReceived Vistas de video completadas Anunciantes

▲ Volver arriba

 


Quizás también te interese...