From 4d3b4878c63e3a7a55ab9e4694c3e651c4a3027c Mon Sep 17 00:00:00 2001 From: marcosmarxm Date: Mon, 4 Jul 2022 10:50:25 -0300 Subject: [PATCH 1/2] use docsaurus feature for warn/note and udpdate doc --- docs/integrations/sources/google-ads.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/docs/integrations/sources/google-ads.md b/docs/integrations/sources/google-ads.md index 305eb6d570c2..eb6744b9b3a4 100644 --- a/docs/integrations/sources/google-ads.md +++ b/docs/integrations/sources/google-ads.md @@ -83,7 +83,7 @@ The Google Ads source connector supports the following[ sync modes](https://docs ## Supported Streams -This source is capable of syncing the following tables and their data: +This source is capable of syncing the following tables described below and has the feature of sync custom queries using GAGL. ### Main Tables @@ -109,19 +109,29 @@ Note that `ad_groups`, `ad_group_ads`, and `campaigns` contain a `labels` field, - [shopping_performance_report](https://developers.google.com/google-ads/api/docs/migration/mapping#shopping_performance) - [user_location_report](https://developers.google.com/google-ads/api/fields/v9/user_location_view) -**Note**: Due to constraints from the Google Ads API, the `click_view` stream retrieves data one day at a time and can only retrieve data newer than 90 days ago + :::note + Due to constraints from the Google Ads API, the `click_view` stream retrieves data one day at a time and can only retrieve data newer than 90 days ago + ::: -**Note**: Due to constraints from the Google Ads API, [metrics](https://developers.google.com/google-ads/api/fields/v9/metrics) cannot be requested for a manager account. Therefore, report streams are only available when pulling data from a non-manager account. + :::note + Due to constraints from the Google Ads API, [metrics](https://developers.google.com/google-ads/api/fields/v9/metrics) cannot be requested for a manager account. Therefore, report streams are only available when pulling data from a non-manager account. + ::: -**Note**: For incremental streams data is synced up to the previous day using your Google Ads account time zone. The reason is that Google Ads can filter data only by [date](https://developers.google.com/google-ads/api/fields/v9/ad_group_ad#segments.date) without time. Also, some reports cannot load data in real time due to Google Ads [limitations](https://support.google.com/google-ads/answer/2544985?hl=en). + :::note + For incremental streams data is synced up to the previous day using your Google Ads account time zone. The reason is that Google Ads can filter data only by [date](https://developers.google.com/google-ads/api/fields/v9/ad_group_ad#segments.date) without time. Also, some reports cannot load data in real time due to Google Ads [limitations](https://support.google.com/google-ads/answer/2544985?hl=en). + ::: -## Understanding Google Ads Query Language +## Custom Query: understanding Google Ads Query Language The Google Ads Query Language can query the Google Ads API. Check out [Google Ads Query Language](https://developers.google.com/google-ads/api/docs/query/overview) and the [query builder](https://developers.google.com/google-ads/api/docs/query/overview). You can add these as custom queries when configuring the Google Ads source. -**Note**: Each custom query in the input configuration must work for all the customer account IDs. Otherwise, the customer ID will be skipped for every query that fails the validation test. For example, if your query contains `metrics` fields in the `select` clause, it will not be executed against manager accounts. + :::note + Each custom query in the input configuration must work for all the customer account IDs. Otherwise, the customer ID will be skipped for every query that fails the validation test. For example, if your query contains `metrics` fields in the `select` clause, it will not be executed against manager accounts. + ::: -**Note**: Please take into account Google's note on [Selectability between segments and metrics](https://developers.google.com/google-ads/api/docs/reporting/segmentation#selectability_between_segments_and_metrics) when editing custom queries or default stream schemas (which will also be turned into GAQL queries by the connector). Fields like `segments.keyword.info.text`, `segments.keyword.info.match_type`, `segments.keyword.ad_group_criterion` in the `SELECT` clause tell the query to only get the rows of data that have keywords, and remove any row that is not associated with a keyword. This is often not obvious and undesired behaviour and can lead to missing data records. If you do need this field in the stream, please choose adding a new stream instead of editing existing ones. + :::warning + Please take into account Google's note on [Selectability between segments and metrics](https://developers.google.com/google-ads/api/docs/reporting/segmentation#selectability_between_segments_and_metrics) when editing custom queries or default stream schemas (which will also be turned into GAQL queries by the connector). Fields like `segments.keyword.info.text`, `segments.keyword.info.match_type`, `segments.keyword.ad_group_criterion` in the `SELECT` clause tell the query to only get the rows of data that have keywords, and remove any row that is not associated with a keyword. This is often not obvious and undesired behaviour and can lead to missing data records. If you do need this field in the stream, please choose adding a new stream instead of editing existing ones. + ::: ## Performance considerations From ff885d06f44b5cc4e76b947e4f5cf98b8a881e84 Mon Sep 17 00:00:00 2001 From: marcosmarxm Date: Mon, 4 Jul 2022 14:58:58 -0300 Subject: [PATCH 2/2] update description in supported streams --- docs/integrations/sources/google-ads.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/integrations/sources/google-ads.md b/docs/integrations/sources/google-ads.md index eb6744b9b3a4..19df326836e0 100644 --- a/docs/integrations/sources/google-ads.md +++ b/docs/integrations/sources/google-ads.md @@ -83,8 +83,7 @@ The Google Ads source connector supports the following[ sync modes](https://docs ## Supported Streams -This source is capable of syncing the following tables described below and has the feature of sync custom queries using GAGL. - +This source is capable of syncing the tables described below and can sync custom queries using GAGL. ### Main Tables - [accounts](https://developers.google.com/google-ads/api/fields/v9/customer)