diff --git a/_data/navigation.yml b/_data/navigation.yml index ab499ddb3..dc4991eb5 100644 --- a/_data/navigation.yml +++ b/_data/navigation.yml @@ -247,7 +247,7 @@ items: title: Google Ad Manager - url: /components/extractors/marketing-sales/google-analytics/ - title: Google Analytics (UA, GA4) + title: Google Analytics 4 (GA4) - url: /components/extractors/marketing-sales/google-cm360/ title: Google Campaign Manager 360 diff --git a/src/content/docs/components/extractors/marketing-sales/babelforce/index.md b/src/content/docs/components/extractors/marketing-sales/babelforce/index.md index 59de2ac91..5f41c849c 100644 --- a/src/content/docs/components/extractors/marketing-sales/babelforce/index.md +++ b/src/content/docs/components/extractors/marketing-sales/babelforce/index.md @@ -2,7 +2,7 @@ title: Babelforce slug: 'components/extractors/marketing-sales/babelforce' redirect_from: - - /extractors/makreting-sales/babelforce/ + - /extractors/marketing-sales/babelforce/ --- @@ -14,7 +14,7 @@ This data source connector uses the Babelforce [REST API](https://www.babelforce To configure this connector, you need to provide an API **Access ID**, and an **API token**. Select the **configuration template** and save the configuration. -There is only one Google Calendar template available so far -- *Basic*. This option downloads all call data from your Babelforce profile +There is only one Babelforce template available so far -- *Basic*. This option downloads all call data from your Babelforce profile. You can also [switch to the JSON editor](/components/extractors/other/generic/#template-mode). ![Screenshot - API token](/components/extractors/marketing-sales/babelforce/babelforce-1.png) diff --git a/src/content/docs/components/extractors/marketing-sales/criteo/index.md b/src/content/docs/components/extractors/marketing-sales/criteo/index.md index c20feebc9..f19838813 100644 --- a/src/content/docs/components/extractors/marketing-sales/criteo/index.md +++ b/src/content/docs/components/extractors/marketing-sales/criteo/index.md @@ -2,7 +2,7 @@ title: Criteo slug: 'components/extractors/marketing-sales/criteo' redirect_from: - - /extractors/makreting-sales/criteo/ + - /extractors/marketing-sales/criteo/ --- diff --git a/src/content/docs/components/extractors/marketing-sales/google-ad-manager/index.md b/src/content/docs/components/extractors/marketing-sales/google-ad-manager/index.md index 165ab64ba..c3beab831 100644 --- a/src/content/docs/components/extractors/marketing-sales/google-ad-manager/index.md +++ b/src/content/docs/components/extractors/marketing-sales/google-ad-manager/index.md @@ -22,12 +22,12 @@ Once the authorization is set up, click **Save** to save the authorization param new report. ## Report Configuration -It is recommended to first create a report on the Google Ad Manager report page to test wether all dimension and metric combinations +It is recommended to first create a report on the Google Ad Manager report page to test whether all dimension and metric combinations are available for the given report type, as well as the date ranges matching the dimensions (e.g., WEEK dimension must have one or more week sun-sat. If a date range of mon-fri is given, it will result in an error). After you create a valid report on the Google Ad Manager report page, go to the -[API docs](https://developers.google.com/ad-manager/api/reference/v202105/ReportService.ReportQuery#dimensions) +[API docs](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions) to find the proper names of the dimensions and metrics for the API. E.g., CTR in the Ad exchange report type is AD_EXCHANGE_CTR in the API. diff --git a/src/content/docs/components/extractors/marketing-sales/google-ads/index.md b/src/content/docs/components/extractors/marketing-sales/google-ads/index.md index 0b0c8db0f..a309070ca 100644 --- a/src/content/docs/components/extractors/marketing-sales/google-ads/index.md +++ b/src/content/docs/components/extractors/marketing-sales/google-ads/index.md @@ -22,7 +22,7 @@ To run the connector, specify your [customer ID](https://support.google.com/goog To download a report, specify a [GAQL query](https://developers.google.com/google-ads/api/docs/query/overview), through which you can customize the output of a [predefined report type](https://developers.google.com/google-ads/api/docs/reporting/overview). -You can use the [Query Builder](https://developers.google.com/google-ads/api/fields/v11/overview_query_builder) to simplify the development of the query. +You can use the [Query Builder](https://developers.google.com/google-ads/api/fields/v17/overview_query_builder) to simplify the development of the query. Optionally, you can specify the start (*since*) and end (*until*) dates of downloaded stats. The *Since*/*Until* parameter is parsed via the [strtotime function](https://www.php.net/manual/en/function.strtotime.php) and @@ -73,7 +73,7 @@ This table is created by the GAQL query you specified and contains the result of | campaignId | campaignName | metricsClicks | metricsImpressions | |------------|--------------|---------------|--------------------| -| 12345678 | jumped | Ad Group #1 | Ad Group #2 | -| 90123456 | fox | Ad Group #1 | Ad Group #2 | -| 78901234 | quick | Ad Group #1 | Ad Group #2 | -| 56789012 | brown | Ad Group #1 | Ad Group #2 | +| 12345678 | jumped | 142 | 1893 | +| 90123456 | fox | 87 | 1241 | +| 78901234 | quick | 231 | 3102 | +| 56789012 | brown | 56 | 782 | diff --git a/src/content/docs/components/extractors/marketing-sales/google-cm360/index.md b/src/content/docs/components/extractors/marketing-sales/google-cm360/index.md index 97b6e6883..cc2749b91 100644 --- a/src/content/docs/components/extractors/marketing-sales/google-cm360/index.md +++ b/src/content/docs/components/extractors/marketing-sales/google-cm360/index.md @@ -27,11 +27,10 @@ The connector supports three modes: - It's ideal if you need to set up a complex report in the [CM360 Report Builder](https://www.google.com/analytics/dfa/) and use it across multiple accounts. - The selected report is left untouched, and its copy is created in all selected accounts. The resulting reports are linked to the configuration. Naming convention: `keboola_generated_{PROJECT_ID}_{CONFIG_ID}_{ROWID}` 2. **Running and Downloading Existing Report Definitions**: Suitable for multiple identical reports across required ad accounts, previously defined using the [CM360 Report Builder](https://support.google.com/campaignmanager/answer/2823849?sjid=16894252783161215189-EU&visit_id=638403222303021904-3691116343&rd=1). -3. **Direct UI Report Definition:** Set up accccccinerhkkecnclurugbvhilhegrldigernhneile -4. simple report definition directly in the configuration UI, automatically creating an offline report in the [CM360 Report Builder](https://www.google.com/analytics/dfa/) that will be linked to the configuration. Naming convention: `keboola_generated_{PROJECT_ID}_{CONFIG_ID}_{ROWID}` +3. **Direct UI Report Definition:** Set up a simple report definition directly in the configuration UI, automatically creating an offline report in the [CM360 Report Builder](https://www.google.com/analytics/dfa/) that will be linked to the configuration. Naming convention: `keboola_generated_{PROJECT_ID}_{CONFIG_ID}_{ROWID}` ### Creating and Running Reports from Existing Report Definitions -This option is helpful if you need to definset up a complex report in the [CM360 Report Builder](https://www.google.com/analytics/dfa/) and use it across multiple accounts. +This option is helpful if you need to set up a complex report in the [CM360 Report Builder](https://www.google.com/analytics/dfa/) and use it across multiple accounts. The selected report is left untouched, and its copy is created in all selected accounts. The resulting reports are linked to the configuration. The naming convention of the created report is: `keboola_generated_{PROJECT_ID}_{CONFIG_ID}_{ROWID}` diff --git a/src/content/docs/components/extractors/marketing-sales/index.md b/src/content/docs/components/extractors/marketing-sales/index.md index 70e25085f..71327b7a2 100644 --- a/src/content/docs/components/extractors/marketing-sales/index.md +++ b/src/content/docs/components/extractors/marketing-sales/index.md @@ -17,14 +17,17 @@ Keboola provides the following marketing and sales connectors: - [Customer IO](/components/extractors/marketing-sales/customerio/) - [Facebook Ads](/components/extractors/marketing-sales/facebook-ads/) - [GoodData Reports](/components/extractors/marketing-sales/gooddata-reports/) -- [Google-ads](/components/extractors/marketing-sales/google-ads/) +- [Google Ads](/components/extractors/marketing-sales/google-ads/) - [Google Ad Manager](/components/extractors/marketing-sales/google-ad-manager/) - [Google Analytics](/components/extractors/marketing-sales/google-analytics/) +- [Google Campaign Manager 360](/components/extractors/marketing-sales/google-cm360/) +- [Google Display & Video 360](/components/extractors/marketing-sales/google-dv360/) - [Google My Business](/components/extractors/marketing-sales/google-my-business/) - [LinkedIn Pages](/components/extractors/marketing-sales/linkedin-pages/) - [Mailchimp](/components/extractors/marketing-sales/mailchimp/) - [Market Vision](/components/extractors/marketing-sales/market-vision/) - [Microsoft Advertising (Bing Ads)](/components/extractors/marketing-sales/bing-ads/) +- [Pinterest Ads](/components/extractors/marketing-sales/pinterest-ads/) - [Pipedrive](/components/extractors/marketing-sales/pipedrive/) - [Salesforce](/components/extractors/marketing-sales/salesforce/). - [Shoptet](/components/extractors/marketing-sales/shoptet/) diff --git a/src/content/docs/components/extractors/marketing-sales/pinterest-ads/index.md b/src/content/docs/components/extractors/marketing-sales/pinterest-ads/index.md index 7df75cf20..7f1834590 100644 --- a/src/content/docs/components/extractors/marketing-sales/pinterest-ads/index.md +++ b/src/content/docs/components/extractors/marketing-sales/pinterest-ads/index.md @@ -22,7 +22,7 @@ To get Pinterest Ad Analytics reports, have *Note: Remember, it may take some time for your ads to start running and for data to accumulate in your analytics reports.* ## Configuration -First, [create a new configuration](https://help.keboola.com/components/#creating-component-configuration) of the Pinterest Ads connector. +First, [create a new configuration](/components/#creating-component-configuration) of the Pinterest Ads connector. Then, click the **Authorize Account** button and log in with your Pinterest business account. Now, you can define reports to download: diff --git a/src/content/docs/components/extractors/marketing-sales/salesforce/index.md b/src/content/docs/components/extractors/marketing-sales/salesforce/index.md index 052b7322c..7497e7a6a 100644 --- a/src/content/docs/components/extractors/marketing-sales/salesforce/index.md +++ b/src/content/docs/components/extractors/marketing-sales/salesforce/index.md @@ -80,7 +80,7 @@ You can also configure: - **API Version** -- Select the Salesforce API version to use for data extraction. - **Proxy Settings** -- Configure an HTTPS proxy server if required by your network setup. -After configuring the authorization, you can set up individual queries or objects in the [row based configuration](https://help.keboola.com/components/#configuration-rows). +After configuring the authorization, you can set up individual queries or objects in the [row based configuration](/components/#configuration-rows). ![Screenshot - Row configuration](/components/extractors/marketing-sales/salesforce/row_config.png) diff --git a/src/content/docs/components/extractors/marketing-sales/shoptet/index.md b/src/content/docs/components/extractors/marketing-sales/shoptet/index.md index 68ae6e367..b3bd8cd9c 100644 --- a/src/content/docs/components/extractors/marketing-sales/shoptet/index.md +++ b/src/content/docs/components/extractors/marketing-sales/shoptet/index.md @@ -10,7 +10,7 @@ redirect_from: This data source connector allows you to download data from Shoptet permalinks. In order to be able to use this connector, you have to create a permanent link to your report in Shoptet administration. -For example, to create a permanent link for Orders, go to Orders > Export in you Shoptet adminitration page and at the bottom of the page, you can see the option to create the permanent link. This link is a direct download link to the csv file that you will use in component's configuration. To see how the report looks like, you can visit this link using your browser and it will automatically get downloaded to your computer. +For example, to create a permanent link for Orders, go to Orders > Export in your Shoptet administration page and at the bottom of the page, you can see the option to create the permanent link. This link is a direct download link to the csv file that you will use in component's configuration. To see how the report looks like, you can visit this link using your browser and it will automatically get downloaded to your computer. The link will look something like this: `https://keboola.com/export/orders.csv?patternId=-9&partnerId=12&hash=3323211c346061e3d9abfadf1738a2a6661af830979b46111149664973d696a8` diff --git a/src/content/docs/components/extractors/marketing-sales/tiktok-ads/index.md b/src/content/docs/components/extractors/marketing-sales/tiktok-ads/index.md index a8e23ea07..92e6561b9 100644 --- a/src/content/docs/components/extractors/marketing-sales/tiktok-ads/index.md +++ b/src/content/docs/components/extractors/marketing-sales/tiktok-ads/index.md @@ -7,13 +7,13 @@ slug: 'components/extractors/marketing-sales/tiktok-ads' This data source connector uses the [TikTok Marketing Reports API](https://ads.tiktok.com/marketing_api/docs?id=1740302665828417) to extract reports on performance of ads. Depending on the data you need to extract, -there are [four report types](https://ads.tiktok.com/marketing_api/docs?id=1738864835805186): basic reports, audience reports, playable ads reports, and DSA reports. +there are [four report types](https://ads.tiktok.com/marketing_api/docs?id=1738864835805186): basic reports, audience reports, playable material reports, and catalog reports. ## Configuration [Create a new configuration](/components/#creating-component-configuration) of the **TikTok Ads** connector. Then click **Authorize Account** to [authorize the configuration](/components/#authorization) with access to the Ad Account you want to extract. -Once the component is authorized, click **Add Row** in order to create a new report to download. Each report you will download will be a [configuration row](https://help.keboola.com/components/#configuration-rows). +Once the component is authorized, click **Add Row** in order to create a new report to download. Each report you will download will be a [configuration row](/components/#configuration-rows). Name the row with a descriptive name of the report and click **Create**. diff --git a/src/content/docs/components/extractors/marketing-sales/zoho/index.md b/src/content/docs/components/extractors/marketing-sales/zoho/index.md index bae86b17f..81ad61ee1 100644 --- a/src/content/docs/components/extractors/marketing-sales/zoho/index.md +++ b/src/content/docs/components/extractors/marketing-sales/zoho/index.md @@ -19,14 +19,14 @@ If you need additional endpoints, please submit your request to [ideas.keboola.c ## Configuration [Create a new configuration](/components/#creating-component-configuration) of the **Zoho** data source connector. -Click **Authorize Account** to [authorize the configuration](/components/#authorization) with access to the Ad Account you want to extract. Then, select +Click **Authorize Account** to [authorize the configuration](/components/#authorization) with access to the Zoho CRM data you want to extract. Then, select a [data center](https://help.zoho.com/portal/en/kb/commerce/user-guide/getting-started-with-zoho-commerce/articles/data-centers) of your Zoho instance during the authorization process. Once done, you must enter the **account's user email address (`user_email`)** you used to generate the Self Client. ### Creating a New Report To create a new report to download, click **Add Row**. -Each report you download will be a [configuration row](https://help.keboola.com/components/#configuration-rows). +Each report you download will be a [configuration row](/components/#configuration-rows). After that, set up the **Module records download configuration (`module_records_download_config`)**. This step is required. Then, set up the job configuration: