Conversions

GET

https://api.data.v4.marketing/v1/google/ads/conversions

Retrieve Google Ads conversion data with detailed performance metrics.

This endpoint provides conversion-level insights including conversion action details, categories, and performance indicators segmented by conversion type.

Dimensions Available:

Conversion action name/ID/category

Conversion adjustment flag

Conversions, conversions value, all conversions, all conversions value

Ad group ID/name/status/type

Campaign ID/name/group, bidding strategy type, ad ID

Date

Limitations:

Maximum 5000 records per page

Supports date filtering via createdStart and createdEnd (YYYY-MM-DD format)

Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

organizationId (required)

userId (optional)

integrationName (optional)

createdStart (optional)

createdEnd (optional)

Requisição

Authorization

Parâmetros de Consulta

Respostas

🟢200Sucesso

application/json

Successful response

Bodyapplication/json

🟠400400

🔴500500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.data.v4.marketing/v1/google/ads/conversions?organizationId=organization_123&userId=undefined&integrationName=undefined&createdStart=2024-01-01&createdEnd=2024-12-31&page=undefined&limit=undefined&orderBy=undefined&orderDirection=undefined' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>'

Response Example

200 - Exemplo 1

{
    "data": [
        {
            "date": "2019-08-24",
            "conversion_action_name": "string",
            "conversion_action_id": "string",
            "conversion_action_category": "string",
            "conversion_adjustment": true,
            "all_conversions": 0,
            "all_conversions_value": 0,
            "conversions": 0,
            "conversions_value": 0,
            "ad_group_type": "string",
            "ad_group_status": "string",
            "ad_group_name": "string",
            "ad_group_id": "string",
            "ad_id": "string",
            "ad_group_campaign": "string",
            "campaign_bidding_strategy_type": "string",
            "campaign_id": "string",
            "campaign_name": "string",
            "campaign_group": "string",
            "organization_id": "string",
            "user_id": "string",
            "document_id": "string",
            "integration_name": "string",
            "inserted_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "meta": {
        "page": 0,
        "limit": 0,
        "hasNextPage": true,
        "hasPreviousPage": true
    }
}

Modificado em 2026-05-27 00:13:03

Página anterior

Geographic

Próxima página

Conversion Segmented Ad Group Ads