Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _data/navigation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Babelforce
slug: 'components/extractors/marketing-sales/babelforce'
redirect_from:
- /extractors/makreting-sales/babelforce/
- /extractors/marketing-sales/babelforce/
---


Expand All @@ -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)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Criteo
slug: 'components/extractors/marketing-sales/criteo'
redirect_from:
- /extractors/makreting-sales/criteo/
- /extractors/marketing-sales/criteo/
---


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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 |
Original file line number Diff line number Diff line change
Expand Up @@ -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}`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Loading