Google Ads Integration

With adstage, you can review web and app conversion performance generated from Google Ads. With the Google Ads cost integration, you can also view the ad spend and performance data of your running campaigns in the adstage dashboard.

The Google Ads integration screen can be found in the adstage dashboard under Ad Channel Integration > Google Ads, and it consists of four tabs: Web Campaign Integration, App Campaign Integration, Cost Integration, and SKAN Integration.

Integrating Web Campaigns

Using the Final URL Suffix feature of Google Ads, you can review the web conversion performance generated from Google Ads. Once set on an account, the Final URL Suffix applies to all campaigns.

Prerequisites

The Final URL Suffix adds campaign information to the landing page URL. The adstage Web SDK must be installed on the landing web page so it can read this information and connect it to conversions. Conversion events such as purchases must be sent from your website through the Web SDK. You can find the installation instructions at Installing the adstage Web SDK.

Setting the Final URL Suffix in Google Ads

In the adstage dashboard under Ad Channel Integration > Google Ads, select the Web Campaign Integration tab and then open the Final URL Suffix tab. Copy the Final URL Suffix displayed here.

Modifying the copied content may cause your Google Ads ad to be rejected during review or your data to not be collected properly, so please use it as is.

Go to Google Ads and navigate to Admin > Account settings > Tracking.

In the Tracking section, paste the content you copied from the adstage dashboard into the Final URL Suffix field and click Save. Once saved, tracking information will be automatically added to the landing page URL of subsequent ad clicks.

Final URL Suffix

When the Final URL Suffix is set at the Google Ads account level, it is automatically applied to all campaigns in that account. There is no need to configure it for each campaign individually.

Setting the Tracking Template in Google Ads

When you set a Tracking Template, ad clicks are also recorded on adg.im, adstage's click tracker. adg.im is a Google-certified Transparent Click Tracker.

Web campaigns are measured with the Final URL Suffix alone

The Tracking Template does not replace the Final URL Suffix. With Google Ads parallel tracking, users go straight to the landing page while the tracking template is called in the background, so campaign information reaches the landing page only through the Final URL Suffix. Without the Final URL Suffix, campaign, ad group, and keyword information is not connected to conversions.

In addition, if you set both the Tracking Template and the Final URL Suffix, a single ad click is recorded once by adg.im and once by the Web SDK, so clicks may be counted twice. For web campaigns, we recommend setting only the Final URL Suffix.

In the adstage dashboard under Ad Channel Integration > Google Ads, select the Web Campaign Integration tab and then open the Tracking Template tab. Copy the tracking template displayed here.

Go to Google Ads, navigate to Admin > Account settings > Tracking, and paste it into the Tracking template field.

Click Test below the field, confirm that the result shows that the landing page was found, and then click Save.

Parallel tracking toggle

The Parallel tracking toggle in the Tracking section applies only to hotel campaigns. Search, Shopping, Display, and Video campaigns always use parallel tracking, so you do not need to change the toggle.

Integrating App Campaigns

In the App Campaign Integration tab, you connect adstage to Google Ads as a third-party app analytics provider so that Android and iOS app events collected by adstage are sent to Google Ads as conversions. Web events are not sent.

Registering the Google Ads Link ID

To send app events, you must first register a Link ID for each platform.

1. In Google Ads, go to Tools > Data manager > Third-party app analytics, select Other provider, and enter 1749504903 as the Provider ID. This ID is also shown in the adstage App Campaign Integration tab, where you can click it to copy.

2. Create a Link ID for Android and for iOS. The two platforms use different Link IDs.

3. Enter each Link ID in the Android Link ID and iOS Link ID fields of the adstage App Campaign Integration tab and save. If you register the Link ID for only one platform, only that platform's events are sent.

Events That Are Sent

• install and first_open: Always sent, whether or not the user came from a Google Ads ad.
• Other events: Sent only for users who came from a Google Ads ad — that is, when the event carries a gclid, gbraid, or wbraid, or the device is attributed to Google Ads.

Until you save the event settings, events are converted to Google Ads events as shown below. Events not in the list are sent as custom.

Configuring In-App Events

After you register a Link ID, a list of events collected by adstage appears at the bottom of the tab. For each event, turn sending on or off, choose the Google Ads event type to map it to, and click Save Settings. You can also use Enable All and Disable All.

Integrating Cost

With the cost integration, you can view Google Ads ad spend and performance metrics in adstage.

Integrating with a Google Account

To integrate adstage with Google Ads, Google account authentication is required. Authentication is performed securely using OAuth 2.0.

Starting the Google Account Integration in adstage

1. In the adstage dashboard, select Google Ads (google.ads) under Ad Channel Integration.

2. In the Cost Integration tab, turn on the Google Ads Cost Integration switch and click Add Integration Account. The button cannot be clicked while the switch is off.

3. When the Google login window opens, sign in with a Google account that has access to your Google Ads account.

4. Grant adstage permission to access your Google Ads data.

Selecting a Google Ads Account

After authentication, the Select Google Ads Accounts window lists the Google Ads accounts that the signed-in Google account can access. Only accounts in use are shown.

1. Select the accounts you want to integrate. You can select several at once; use the account name and Customer ID to confirm you have the right accounts.

2. Click Confirm N Account(s) to integrate the selected accounts. The first data collection starts immediately.

Accounts you can integrate

Only advertiser accounts that the signed-in Google account can access directly are listed. Signing in with a manager account (MCC) does not list its client accounts, and integrating the manager account itself does not collect campaign data. Add the Google account you will use as a user of each advertiser account directly, and then integrate it.

Be careful

• Accounts already integrated with this organization are skipped. If all selected accounts are already registered, "This account is already registered" is shown; if only some are, "Some accounts are already registered and were skipped" is shown.
• If the signed-in Google account cannot access any account, or a Google Ads API error occurs, "No Google Ads accounts available for this user" is shown.
• If you deny permission during Google login, the integration does not proceed.

Managing Integrated Accounts

Integrated Google Ads accounts can be viewed in the Cost Integration tab of the adstage dashboard.

Viewing the Account List

The integrated account list shows the following information:

• Ad Account: Google Ads account name and Customer ID
• Status: Integration status (Preparing, Success, Failed)
• Last Data Update: When cost data was last saved
• Google Ads Account: The email of the Google account used for the integration
• Management: Delete the account

Deleting an Account

To remove an integration, click the delete icon in the Management column. In the Delete Account confirmation, click Delete.

Be careful

Deleting an account stops data collection for that account. Previously collected data is kept in adstage, but no new data is collected.

Checking the Integration Status

You can check the cost integration status in the Status column of the account list.

Status Messages

• Preparing: The first data collection is in progress right after the account is integrated. It usually finishes within a few minutes.
• Success: The connection to the Google Ads API is working.
• Failed: Data could not be retrieved from Google Ads (expired authentication, missing permission, and so on). Hover over the status to see the error. Collection is retried at every update, and the status returns to Success automatically once the cause is resolved.

Missing data warning

Data may not be coming in even when the status is Success, for example when no ads are running. If no cost data has been saved for more than 3 days, a ⚠️ warning appears next to the status. Hovering over it shows Action Required and a message saying how many days cost data has not been collected. If you see this warning, check the integration. The warning disappears automatically once data collection resumes.

Data Update Schedule

Google Ads cost data is updated as follows:

• Update range: The last 30 days (D-30 to D-1, excluding the day of the update)
• Update frequency: Every 4 hours (KST 1:00, 5:00, 9:00, 13:00, 17:00, 21:00)

Conversions are often recorded some time after the ad click, so each update fetches the last 30 days again and refreshes conversions and conversion value to the latest figures.

Data collection timing

Data for the day of the update (D-0) is not collected because it is not final yet.

For example, if adstage updates the cost data on March 17, the data from February 15 to March 16 is refreshed.

Collected Data

Data collected through the cost integration is the figures reported by Google Ads, stored daily at the campaign, ad group, keyword, ad, and search term level. In reports, metric names carry (Channel) to indicate figures reported by the ad channel (e.g. Conversion Value (Channel)).

Integrating SKAN

When you turn on the switch in the SKAN Integration tab, adstage calculates SKAdNetwork (SKAN) conversion values on the server from iOS app events, and the adstage iOS SDK passes them to Apple. SKAN is Apple's framework for iOS app install attribution. This setting does not make adstage send data to Google Ads.

1. In the adstage dashboard, go to Settings > SKAN (SKAN conversion value settings), set your conversion value mapping rules, and click Save All (Save All). If no settings are saved, conversion values are not calculated even when SKAN integration is on.

2. Under Ad Channel Integration > Google Ads, select the SKAN Integration tab. The Google Ads accounts integrated in the Cost Integration tab are listed. If no account is integrated, first integrate one as described in Integrating Cost.

3. Turn on the SKAN switch for the account. The Success status appears next to the switch immediately.

Note

• SKAN integration applies to the whole organization. If SKAN is on for even one account across Google Ads, Meta, Apple Search Ads, or TikTok, conversion value calculation applies to all of the organization's iOS apps.
• It works only in apps with the adstage iOS SDK installed.
• It is independent of the cost integration status. SKAN conversion value calculation continues even if the cost integration has failed.

Precautions

Please be mindful of the following.

Web Campaign Integration

• When the Final URL Suffix is set at the account level, it is automatically applied to all campaigns.
• The adstage Web SDK must be installed on the landing web page, and conversion events must be sent from your website through the Web SDK.
• Modifying the copied Final URL Suffix may cause ad review rejection or interruption of data collection.
• If you set both the Tracking Template and the Final URL Suffix, clicks may be counted twice. For web campaigns, we recommend setting only the Final URL Suffix.
• redirect_url={lpurl} in the Tracking Template is the transparency parameter registered with Google. Modifying or removing it may cause the tracking test to fail or ads to be disapproved.

App Campaign Integration

• Android and iOS each require their own Link ID.
• GCLID-based attribution applies to events that occur within 180 days of the ad click.
• Events from iOS devices that denied App Tracking Transparency (ATT) are sent with gbraid.
• App event sending is turned on and off with the Link IDs in the App Campaign Integration tab. It is independent of the switch in the Cost Integration tab.

Cost Integration

• Discrepancies in figures may occur between Google Ads and adstage. This is due to differences in aggregation timing, time zones, and filtering criteria.
• If you revoke adstage's access in your Google account, data collection stops.
• If the Google Ads API quota is exceeded, data collection may be temporarily delayed.

Troubleshooting

If a problem occurs during the integration process, please check the following:

Web Campaign Integration Issues

1. Check the Final URL Suffix setting: Verify that the Final URL Suffix is entered correctly in the Google Ads account settings (Admin > Account settings > Tracking).
2. Check the Web SDK installation: Verify that the adstage Web SDK is correctly installed on the landing page.
3. Check conversion events: Verify that conversion events such as purchases are being sent through the Web SDK.
4. Check the landing page: Verify that the final landing page URL is correct.
5. Check the tracking template test: If you use a Tracking Template, verify that the Test result in the Google Ads Tracking section shows that the landing page was found.

Cost Integration Issues

1. Check Google account permissions: Verify that the signed-in Google account can directly access the Google Ads account you want to integrate.
2. Check the account selection: Verify that you selected the correct Google Ads account (check the Customer ID).
3. Check the status: If the status is Failed, hover over it to see the error. For expired authentication or permission problems, delete the account and integrate it again.
4. Check the API quota: Verify that you have not exceeded the Google Ads API quota.

When Data Is Not Collected

1. Check that the integration is enabled: Verify that the Google Ads Cost Integration switch is on.
2. Check for the warning: Verify whether a ⚠️ warning appears next to the account status.
3. Check the update schedule: The first collection starts right after integration, and the last 30 days (excluding the current day) are refreshed every 4 hours after that.
4. Re-verify permissions: Verify that the adstage app permissions for your Google account are valid.

Google Authentication Errors

1. Check popup blocking: Verify that popups are not blocked in your browser.
2. Check cookie settings: Verify that third-party cookies are allowed.
3. Try a different browser: Try a different browser such as Chrome or Safari.

If you need additional support, please contact the adstage customer support team.

Google Ads Integration Guide

For more detailed Google Ads setup instructions, you can refer to the Google Ads Help Center.

Related Resources

• Set up tracking with ValueTrack parameters
• Using the Final URL Suffix
• Guidelines for third-party click tracking services
• List of certified Google click trackers
• About automatically enabled app conversion actions