> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights

> Obtenha métricas diárias em tempo real do Google Ads para suas campanhas, grupos de anúncios ou anúncios, com cliques, custo, conversões e valor de conversão.

Obtenha o desempenho do Google Ads em tempo real, uma linha por dia, para as campanhas, grupos de anúncios ou anúncios que você criou pela Ayrshare.

<ul>
  <li>Os números são lidos do Google no momento da chamada, não de uma cópia noturna.</li>
  <li>Todos os valores monetários estão na moeda da conta de anúncios, retornada em `currency` em cada linha.</li>
  <li>O Google omite os dias sem atividade, então um intervalo pode retornar menos linhas do que o número de dias.</li>
  <li>O Google ajusta o custo e as conversões de um dia durante alguns dias após o fim dele, então os dias recentes podem mudar entre leituras.</li>
  <li>Para uma campanha Performance Max, use `level=campaign` com o ID da campanha. Uma campanha Performance Max não tem anúncios próprios, então `level=ad` não retorna linhas.</li>
</ul>

## Parâmetros de cabeçalho

**Authorization** `string` *required*

[API Key](https://www.ayrshare.com/docs/apis/overview.md#authorization) of the Primary Profile.

Format: `Authorization: Bearer API_KEY`
**Profile-Key** `string`

[Profile Key](https://www.ayrshare.com/docs/apis/overview.md#profile-key-format) of a User Profile.

Format: `Profile-Key: PROFILE_KEY`

## Parâmetros de consulta

**level** `string` *required*

Sobre o que cada linha informa: `campaign` (o `campaignId` da criação), `adSet` (o `adGroupId` da criação) ou `ad` (o `adId` da criação).

**ids** `string` *required*

IDs de campanha, de grupo de anúncios ou de anúncio separados por vírgula, até 50. Todos devem estar em uma mesma conta de anúncios.

**accountId** `string`

O ID de cliente do Google Ads com 10 dígitos, com ou sem hífens (`123-456-7890`).

Os relatórios de anúncios e de grupos de anúncios leem a conta de anúncios que você informa aqui. Sem ele, um relatório de anúncios pesquisa todas as contas de anúncios que o seu vínculo do Google Ads alcança, até 25, e um relatório de grupos de anúncios só funciona quando o seu vínculo alcança uma única conta de anúncios. Informe a conta quando o seu vínculo alcançar mais de 25 contas de anúncios, ou mais de uma em um relatório de grupos de anúncios. Caso contrário, a solicitação retorna `code: 101`.

**metrics** `string`

Métricas a serem retornadas, separadas por vírgula. Omita para obter todas. Veja [Métricas](#metrics).

**startDate** `string` (default: 30 dias atrás)

Primeiro dia, no formato `YYYY-MM-DD`. O Google mantém os números diários por 37 meses; um `startDate` mais antigo retorna `code: 101`.

**endDate** `string` (default: hoje)

Último dia, no formato `YYYY-MM-DD`.

## Métricas

| Métrica | Tipo | Significado |
| - | - | - |
| `spend` | number | Valor gasto |
| `impressions` | number | Vezes que o anúncio foi exibido |
| `clicks` | number | Cliques |
| `cpm` | number ou `null` | Custo por 1.000 impressões. `null` em um dia sem impressões |
| `cpc` | number ou `null` | Custo por clique. `null` em um dia sem cliques |
| `ctr` | number ou `null` | Taxa de cliques, em porcentagem. `null` em um dia sem impressões |
| `actions` | number | As conversões do Google, que podem ser fracionárias |
| `conversionValue` | number | O valor dessas conversões |

`actions` e `conversionValue` permanecem em `0` até que o acompanhamento de conversões seja configurado na sua conta do Google Ads. `reach` não está disponível, porque o Google não informa alcance único para a Pesquisa, e `breakdowns` não estão disponíveis no Google. Solicitar qualquer um deles retorna `code: 101`.

## Paginação

Todas as linhas são retornadas em uma única resposta, então `nextCursor` é sempre `null`.

## Erros

| Código | Quando |
| - | - |
| `101` | Um parâmetro está ausente ou incorreto, uma métrica ou detalhamento não é suportado, `startDate` é de mais de 37 meses atrás, mais de 50 IDs são enviados, os IDs estão em mais de uma conta de anúncios ou `accountId` é necessário e está ausente |
| `400` | Uma campanha, grupo de anúncios ou anúncio não é seu, ou `accountId` não é a conta de anúncios que a Ayrshare tem registrada para os IDs enviados |
| `370` | O Google não conseguiu retornar os insights. Tente novamente |

```bash cURL theme={"system"}
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07"
```

```javascript JavaScript theme={"system"}
const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);
```

```python Python theme={"system"}
import requests

headers = {
    "Authorization": "Bearer API_KEY",
}

r = requests.get("https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07", headers=headers)

print(r.json())
```

```php PHP theme={"system"}
<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer API_KEY"
    ]
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error: " . $err;
} else {
    echo $response;
}
?>
```

```csharp C# theme={"system"}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");

        var response = await client.GetAsync("https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07");
        var content = await response.Content.ReadAsStringAsync();

        Console.WriteLine(content);
    }
}
```

```go Go theme={"system"}
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07", nil)
    req.Header.Add("Authorization", "Bearer API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```java Java theme={"system"}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetAdInsights {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07"))
            .header("Authorization", "Bearer API_KEY")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
```

```ruby Ruby theme={"system"}
require 'net/http'
require 'uri'

uri = URI.parse('https://api.ayrshare.com/api/ads/google/insights?level=campaign&ids=21534567890&startDate=2026-10-01&endDate=2026-10-07')

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body
```

```json 200: Success theme={"system"}
{
  "status": "success",
  "platform": "google",
  "level": "campaign",
  "startDate": "2026-10-01",
  "endDate": "2026-10-07",
  "insights": [
    {
      "date": "2026-10-01",
      "level": "campaign",
      "id": "21534567890",
      "currency": "USD",
      "spend": 12.48,
      "impressions": 1830,
      "clicks": 41,
      "cpm": 6.82,
      "cpc": 0.3,
      "ctr": 2.2404,
      "actions": 3.5,
      "conversionValue": 140
    }
  ],
  "count": 1,
  "nextCursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.