> For the complete documentation index, see [llms.txt](https://docs.edgetag.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgetag.io/channels/google-ads/api.md).

# API

Below you will find the keys to generate secret payloads for adding or updating a channel via the [Script API](/api/api/script.md).

Refer to the [configuration page](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/configuration) for detailed information on the purpose and usage of each input.

### GOOGLE\_ADS\_CLICKS\_ACCESS\_TOKEN

In this secret, you would store the access token that you got back from the Google Ads OAuth process.\
\
**Example value**\
ya29.BQAS3H6NwQ0bwQapy4wFSNQAK2I5jT4Avb12yYJY1hln44yiNMI3gSWUkZIhGmAvd85bgkTpjW8o8Tp0nbwY1bir50tyDigot2wwaRsWeUkMHqA32Y9pn3hw7RzD6VVzeKwTqKXYQoIqQbbi1sa925MsH6i4U1ppjeewHilWVDEcSwBFGFp4uRr5K2GrPQ56PGlHY1If5NaCgYKAawSARISFQHGX2MiX1o1Y46\_Lu2niRn8QpOwwQ0207\
\
**Type**\
PASSWORD\
\
**Optional**\
false

### GOOGLE\_ADS\_CLICKS\_CUSTOMER

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/onboarding#a-d-account-id).\
\
**Example value**\
7254285515\
\
**Type**\
IDENTIFIER\
\
**Optional**\
false

### GOOGLE\_ADS\_CLICKS\_SUB\_ACCOUNT\_CUSTOMER

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/onboarding#sub-account-id).

**Example value**\
3613643999\
\
**Type**\
TEXT\
\
**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_CONVERSION\_MAPPINGS

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/onboarding#conversions-mapping).

**Example value**\
23834571714400322\
\
**Type**\
TEXT\
\
**Optional**\
false

### GOOGLE\_ADS\_CLICKS\_TAG\_ID

This is not entered by customer, but instead we extract it from account once oauth is successfully done. Please find it under any conversion in google ads dashboard

<figure><img src="/files/EWTaDvqO9XiJNRdWcNjH" alt=""><figcaption></figcaption></figure>

**Example value**\
AW-10900849534

**Type**\
TEXT

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_MERCHANT\_ID

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/configuration#merchant-id).

**Example value**\
781014693

**Type**\
TEXT

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_IDENTIFIER\_FORMAT

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/configuration#identifier-format).

**Example value**\
Shopify\_US\_{productId}\_{variantId}

**Type**\
TEXT

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_ENHANCED\_CONVERSIONS\_SETTING

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/onboarding#gads-enhanced-conversions-setting).

**Possible Values**\
gtag or api

**Type**\
TEXT

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_CONSENT\_SKIP

See the [config description](https://app.gitbook.com/o/c0Wts1N48p0Ba5S58p8v/s/ZJWZKbUk0hRISkCIj2p4/~/changes/95/channels/google-ads/configuration#skip-consent).

**Possible Values**\
0 or 1

**Type**\
CHECKBOX

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_ALLOW\_CONVERSION\_WITHOUT\_CLICK\_ID

See the [config description](/channels/google-ads/configuration.md#allow-server-conversion-without-click-id).

**Possible Values**\
0 or 1

**Type**\
CHECKBOX

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_DYNAMIC\_REMARKETING\_ENABLED

See the [config description](/channels/google-ads/configuration.md#dynamic-remarketing).

**Possible Values**\
0 or 1

**Type**\
CHECKBOX

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_DYNAMIC\_REMARKETING\_MAPPING

See the [config description](/channels/google-ads/configuration.md#dynamic-remarketing).

**Example Value**\
`[{"edgetagEvent": "AddToCart", "googleAdsEvent": "add_to_cart"}, {"edgetagEvent": "ViewContent", "googleAdsEvent": "view_item"}, {"edgetagEvent": "Purchase", "googleAdsEvent": "purchase"}]`

**Type**\
TEXT

**Optional**\
true

### GOOGLE\_ADS\_CLICKS\_BUSINESS\_VERTICAL

See the [config description](/channels/google-ads/configuration.md#dynamic-remarketing).

**Example Value**\
retail

**Type**\
TEXT

**Optional**\
true


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.edgetag.io/channels/google-ads/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.