Google Ads
Conversões por anúncio do grupo de anúncios
GET
Retorna dados de anúncios de grupos de anúncios do Google Ads segmentados por conversão, com métricas de conversão detalhadas.
Este endpoint fornece insights de conversão em nível de anúncio, segmentados por categoria de ação de conversão.
Dimensões disponíveis:
- Nome do recurso/ID do grupo de anúncios
- Nome do recurso do anúncio do grupo de anúncios, nome do recurso/ID do anúncio
- Métricas: conversões, valor das conversões
- Segmentos: categoria da ação de conversão, data
Limitações:
- Máximo de 5000 registros por página
- Suporta filtro por data via
createdStartecreatedEnd(formato YYYY-MM-DD) - Suporta ordenação via
orderByeorderDirection(ASC/DESC)
Filtros:
organizationId(obrigatório)userId(opcional)integrationName(opcional)createdStart(opcional)createdEnd(opcional)
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringIdentificador da organização (obrigatório)
userId?stringIdentificador do usuário (opcional)
integrationName?stringIdentificador do nome da integração (opcional)
createdStart?stringData inicial para filtragem (opcional, formato YYYY-MM-DD)
Formato
datecreatedEnd?stringData final para filtragem (opcional, formato YYYY-MM-DD)
Formato
datepage?integerNúmero da página para paginação (opcional)
Padrão
1limit?integerNúmero de itens por página (opcional, máx. 5000)
Intervalo
value <= 5000Padrão
500orderBy?stringCampo de ordenação (opcional)
orderDirection?stringDireção da ordenação (opcional)
Valor em
"ASC""DESC"Resposta de sucesso
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/google/ads/conversion-segmented-ad-group-ads?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "ad_group_resource_name": "string", "ad_group_id": "string", "metrics_conversions_value": 0, "metrics_conversions": 0, "ad_group_ad_resource_name": "string", "ad_group_ad_ad_resource_name": "string", "ad_group_ad_ad_id": "string", "segments_conversion_action_category": "string", "segments_date": "2019-08-24", "organization_id": "string", "user_id": "string", "document_id": "string", "integration_name": "string", "inserted_at": "2019-08-24T14:15:22Z" } ], "meta": { "page": 0, "limit": 0, "hasNextPage": true, "hasPreviousPage": true }}