Saltar al contenido principal
GET
Obtén el rendimiento de Google Ads en tiempo real, una fila por día, para las campañas, los grupos de anuncios o los anuncios que creaste a través de Ayrshare.
  • Las cifras se leen de Google en el momento de la llamada, no de una copia nocturna.
  • Todos los importes están en la moneda de la cuenta publicitaria, que se devuelve en currency en cada fila.
  • Google omite los días sin actividad, por lo que un rango puede devolver menos filas que días.
  • Google ajusta el coste y las conversiones de un día durante unos días después de que termina, por lo que los días recientes pueden cambiar entre lecturas.
  • Para una campaña Performance Max, usa level=campaign con el ID de la campaña. Una campaña Performance Max no tiene anuncios propios, por lo que level=ad no devuelve filas.

Parámetros del encabezado

Parámetros de consulta

string
requerido
Sobre qué informa cada fila: campaign (el campaignId de Create), adSet (el adGroupId de Create) o ad (el adId de Create).
string
requerido
IDs de campaña, de grupo de anuncios o de anuncio separados por comas, hasta 50. Todos deben estar en una misma cuenta publicitaria.
string
El ID de cliente de Google Ads de 10 dígitos, con o sin guiones (123-456-7890).Los informes de anuncios y de grupos de anuncios leen la cuenta publicitaria que indicas aquí. Sin ella, un informe de anuncios busca en todas las cuentas publicitarias a las que llega tu vínculo de Google Ads, hasta 25, y un informe de grupos de anuncios solo funciona cuando tu vínculo llega a una sola cuenta publicitaria. Indica la cuenta cuando tu vínculo llega a más de 25 cuentas publicitarias, o a más de una en un informe de grupos de anuncios. De lo contrario, la solicitud responde code: 101.
string
Métricas que se devolverán, separadas por comas. Omítelo para obtenerlas todas. Consulta Métricas.
string
predeterminado:"hace 30 días"
Primer día, en formato YYYY-MM-DD. Google conserva las cifras diarias durante 37 meses; un startDate anterior responde code: 101.
string
predeterminado:"hoy"
Último día, en formato YYYY-MM-DD.

Métricas

actions y conversionValue se quedan en 0 hasta que el seguimiento de conversiones esté configurado en tu cuenta de Google Ads. reach no está disponible, porque Google no informa el alcance único en la Búsqueda, y breakdowns no está disponible en Google. Solicitar cualquiera de los dos responde code: 101.

Paginación

Todas las filas se devuelven en una sola respuesta, por lo que nextCursor siempre es null.

Errores