Skip to content

Commit f9e4976

Browse files
[Zaraz] Update to dash button navigation instructions (#24919)
* [Zaraz] Update to dash button navigation instructions * route fix * route fix * Apply suggestions from code review --------- Co-authored-by: ToriLindsay <[email protected]>
1 parent 3152ab7 commit f9e4976

25 files changed

+241
-127
lines changed

src/content/docs/zaraz/advanced/context-enricher.mdx

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
The Zaraz Context Enricher is a tool to modify or enrich [the context](/zaraz/reference/context/) that is being used across Zaraz using a Cloudflare Worker. The Context Enricher allows you access to the client and system variables.
1012

1113
## Creating a Worker
@@ -14,8 +16,10 @@ To use a Context Enricher, you first need to create a new Cloudflare Worker. You
1416

1517
To create a new Worker in the Cloudflare dashboard:
1618

17-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/).
18-
2. Go to **Workers & Pages** and select **Create application**.
19+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
20+
21+
<DashButton url="/?to=/:account/workers-and-pages" />
22+
2. Select **Create application**.
1923
3. Give a name to your Worker and select **Deploy**.
2024
4. Select **Edit code**.
2125

@@ -43,10 +47,11 @@ Keep reading for more complete examples of different use cases or refer to [Zara
4347

4448
Now that your Worker is published, you can select it in your Zaraz settings:
4549

46-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/).
47-
2. Go to **Zaraz** > **Settings**.
48-
3. Select your Context Enricher Worker.
49-
4. Save your settings.
50+
1. In the Cloudflare dashboard, go to the **Settings** page.
51+
52+
<DashButton url="/?to=/:account/tag-management/settings" />
53+
2. Select your Context Enricher Worker.
54+
3. Save your settings.
5055

5156
Your Context Enricher will now run on all Zaraz requests in that given zone.
5257

src/content/docs/zaraz/advanced/import-export.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,18 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
Exporting your Zaraz configuration can be useful if you want to create a local backup or if you need to import it to another website. Zaraz provides an easy way to export and import your configuration.
1012

1113
## Export your Zaraz configuration
1214

1315
To export your Zaraz configuration:
1416

15-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
16-
2. Go to **Zaraz** > **Settings** > **Advanced**.
17+
1. In the Cloudflare dashboard, go to the **Settings** page.
18+
19+
<DashButton url="/?to=/:account/tag-management/settings" />
20+
2. Go to **Advanced**.
1721
3. Click "Export" to download your configuration.
1822

1923
## Import your Zaraz configuration
@@ -28,6 +32,8 @@ Importing a Zaraz configuration replaces your existing configuration, meaning th
2832

2933
To import a Zaraz configuration:
3034

31-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
32-
2. Go to **Zaraz** > **Settings** > **Advanced**.
35+
1. In the Cloudflare dashboard, go to the **Settings** page.
36+
37+
<DashButton url="/?to=/:account/tag-management/settings" />
38+
2. Go to **Advanced**.
3339
3. Click **Browse** to select your configuration file, and **Import** to import it.

src/content/docs/zaraz/advanced/load-custom-managed-component.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar:
55
order: 15
66
---
77

8+
import { DashButton } from "~/components";
9+
810
Zaraz supports loading custom third-party tools using [Managed Components](https://managedcomponents.dev/). These can be Managed Components that you have developed yourself or that were developed by others. Using Custom Managed Components with Zaraz is done by converting them into a Cloudflare Worker running in your account.
911

1012
If you are new to Managed Components, we recommend you get started with [creating your own Managed Component](https://managedcomponents.dev/getting-started/quickstart) or check out [our demo Managed Component](https://github.com/managed-components/demo).
@@ -53,8 +55,10 @@ export default async function (manager) {
5355
As with regular tools, it is recommended that you [create the triggers](/zaraz/custom-actions/create-trigger/) you need first, if the Custom Managed Component you are adding needs to start actions using firing triggers different from the default `Pageview` trigger.
5456
:::
5557

56-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account and domain.
57-
2. Select **Zaraz** > **Tools Configuration** > [**Third-party tools**](https://dash.cloudflare.com/?to=/:account/:zone/zaraz/tools-config/tools/catalog).
58+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
59+
60+
<DashButton url="/?to=/:account/tag-management" />
61+
2. Select **Tools Configuration** > [**Third-party tools**](https://dash.cloudflare.com/?to=/:account/:zone/zaraz/tools-config/tools/catalog).
5862
3. Select **Add new tool** and choose **Custom Managed Component** from the tools library page. Select **Continue** to confirm your selection.
5963
4. In **Select Custom MC**, choose a Custom Managed Component that you have deployed to your account, such as `custom-mc-my-new-counter-mc`. Select **Continue**.
6064
5. In **Permissions**, select the permissions you want to grant the Custom Managed Component. If you run an untrusted Managed Component, pay close attention to what permissions you are granting. Select **Continue**.

src/content/docs/zaraz/advanced/using-jsonata.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,18 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
For advanced use cases, it is sometimes useful to be able to retrieve a value in a particular way. For instance, you might be using `zaraz.track` to send a list of products to Zaraz, but the third-party tool you want to send this data to requires the total cost of the products. Alternatively, you may want to manipulate a value, such as converting it to lowercase.
1012

1113
Cloudflare Zaraz uses JSONata to enable you to perform complex operations on your data. With JSONata, you can evaluate expressions against the [Zaraz Context](/zaraz/reference/context/), allowing you to access and manipulate a wide range of values. To learn more about the values available and how to access them, consult the [full reference](/zaraz/reference/context/). You can also refer to the [complete JSONata documentation](https://docs.jsonata.org/) for more information about JSONata's capabilities.
1214

1315
To use JSONata inside Zaraz, follow these steps:
1416

15-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
16-
2. Go to **Zaraz** > **Tools configuration** > **Tools**.
17+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
18+
19+
<DashButton url="/?to=/:account/tag-management/settings" />
20+
2. Go to **Tools configuration** > **Tools**.
1721
3. Select **Edit** next to a tool that you have already configured.
1822
4. Select an action or add a new one.
1923
5. Choose the field you want to use JSONata in, and wrap your JSONata expression with double curly brackets, like `{{ expression }}`.

src/content/docs/zaraz/consent-management/custom-css.mdx

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,11 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
You can add custom CSS to the Zaraz Consent Management Platform, to make the consent modal more in-line with your website's design.
1012

11-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
12-
2. Go to **Zaraz** > **Consent**.
13-
3. Find the **Custom CSS** section, and add your custom CSS code as you would on any other HTML editor.
13+
1. In the Cloudflare dashboard, go to the **Consent** page.
14+
15+
<DashButton url="/?to=/:account/tag-management/consent" />
16+
2. Find the **Custom CSS** section, and add your custom CSS code as you would on any other HTML editor.

src/content/docs/zaraz/consent-management/enable-consent-management.mdx

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,24 +9,28 @@ head:
99

1010
---
1111

12-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
13-
2. Go to **Zaraz** > **Consent**.
14-
3. Turn on **Enable Consent Management**.
15-
4. In **Consent modal text** fill in any legal information required in your country. Use HTML code to format your information as you would in any other HTML editor.
16-
5. Under **Purposes**, select **Add new Purpose**. Give your new purpose a name and a description. Purposes are the reasons for using third-party tools in your website.
17-
6. In **Assign purpose to tools**, match tools to purposes by selecting one of the purposes previously created from the drop-down menu. Do this for all your tools.
18-
7. Select **Save**.
12+
import { DashButton } from "~/components";
13+
14+
1. In the Cloudflare dashboard, go to the **Consent** page.
15+
16+
<DashButton url="/?to=/:account/tag-management/consent" />
17+
2. Turn on **Enable Consent Management**.
18+
3. In **Consent modal text** fill in any legal information required in your country. Use HTML code to format your information as you would in any other HTML editor.
19+
4. Under **Purposes**, select **Add new Purpose**. Give your new purpose a name and a description. Purposes are the reasons for using third-party tools in your website.
20+
5. In **Assign purpose to tools**, match tools to purposes by selecting one of the purposes previously created from the drop-down menu. Do this for all your tools.
21+
6. Select **Save**.
1922

2023
Your Consent Management platform is ready. Your website should now display a modal asking for consent for the tools you have configured.
2124

2225
## Adding different languages
2326

2427
In your Zaraz consent settings, you can add your consent modal text and purposes in various languages.
2528

26-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
27-
2. Go to **Zaraz** > **Consent**.
28-
3. Select a default language of your choice. The default setting is English.
29-
4. In **Consent modal text** and **Purposes**, you can select different languages and add translations.
29+
1. In the Cloudflare dashboard, go to the **Consent** page.
30+
31+
<DashButton url="/?to=/:account/tag-management/consent" />
32+
2. Select a default language of your choice. The default setting is English.
33+
3. In **Consent modal text** and **Purposes**, you can select different languages and add translations.
3034

3135
## Overriding the consent modal language
3236

src/content/docs/zaraz/consent-management/iab-tcf-compliance.mdx

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,17 @@ head:
99

1010
---
1111

12+
import { DashButton } from "~/components";
13+
1214
The Zaraz Consent Management Platform is compliant with the IAB Transparency & Consent Framework. Enabling this feature [could be required](https://blog.google/products/adsense/new-consent-management-platform-requirements-for-serving-ads-in-the-eea-and-uk/) in order to serve Google Ads in the EEA and the UK.
1315

1416
The CMP ID of the approval is 433 and be can seen in the [IAB Europe](https://iabeurope.eu/cmp-list/) website.
1517

1618
Using the Zaraz Consent Management Platform in IAB TCF Compliance Mode is is opt-in.
1719

18-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
19-
2. Select **Zaraz** > **Consent**.
20-
3. Check the **Use IAB TCF compliant modal** option.
21-
4. Under the **Assign purposes to tools** section, add vendor details to every tool that was not automatically assigned.
22-
5. Press **Save**.
20+
1. In the Cloudflare dashboard, go to the **Consent** page.
21+
22+
<DashButton url="/?to=/:account/tag-management/consent" />
23+
2. Check the **Use IAB TCF compliant modal** option.
24+
3. Under the **Assign purposes to tools** section, add vendor details to every tool that was not automatically assigned.
25+
4. Press **Save**.

src/content/docs/zaraz/custom-actions/additional-fields.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,18 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
Some tools supported by Zaraz let you add fields in addition to the required field. Fields can usually be added either to a specific action, or to all the action within a tool, by adding the field as a **Default Field**.
1012

1113
## Add an additional field to a specific action
1214

1315
Adding an additional field to an action will attach it to this action only, and will not affect your other actions.
1416

15-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
16-
2. Select **Zaraz** > **Tools Configuration** > **Third-party tools**.
17+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
18+
19+
<DashButton url="/?to=/:account/tag-management" />
20+
2. Select **Tools Configuration** > **Third-party tools**.
1721
3. Locate the third-party tool with the action you want to add the additional field to, and select **Edit**.
1822
4. Select the action you wish to modify.
1923
5. Select **Add Field**.
@@ -27,8 +31,10 @@ The new field will now be used in this event.
2731

2832
Adding an additional field to the tool sets it as a default field for all of the tool actions. It is the same as adding it to every action in the tool.
2933

30-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
31-
2. Select **Zaraz** > **Tools**.
34+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
35+
36+
<DashButton url="/?to=/:account/tag-management" />
37+
2. Select **Tools Configuration** > **Third-party tools**.
3238
3. Locate the third-party tool where you want to add the field, and select **Edit**.
3339
4. Select **Settings** > **Add Field**.
3440
5. Choose the desired field from the drop-down menu, and select **Add**.

src/content/docs/zaraz/custom-actions/create-action.mdx

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,16 @@ sidebar:
55
order: 2
66
---
77

8-
Once you have your triggers ready, you can use them to configure your actions. An action defines a specific task that your tool will perform.
8+
import { DashButton } from "~/components";
9+
10+
Once you have your triggers ready, you can use them to configure your actions. An action defines a specific task that your tool will perform.
911

1012
To create an action, first [add a third-party tool](/zaraz/get-started/). If you have already added a third-party tool, follow these steps to create an action.
1113

12-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
13-
2. Go to **Zaraz** > **Tools Configuration**.
14+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
15+
16+
<DashButton url="/?to=/:account/tag-management" />
17+
2. Go to **Tools Configuration**.
1418
3. Under **Third-party tools**, locate the tool you want to configure an action for, and select **Edit**.
1519
4. Under Custom actions select **Create action**.
1620
5. Give the action a descriptive name.

src/content/docs/zaraz/custom-actions/create-trigger.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,14 @@ sidebar:
55
order: 2
66
---
77

8+
import { DashButton } from "~/components";
9+
810
Triggers define the conditions under which a tool will start an action. Since a tool must have actions in order to work, and actions must have triggers, it is important to set up your website's triggers correctly. A trigger can be made out of one or more Rules. Zaraz supports [multiple types of Trigger Rules](/zaraz/reference/triggers/).
911

10-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
11-
2. Go to **Zaraz** > **Tools Configuration**.
12+
1. In the Cloudflare dashboard, go to the **Tag setup** page.
13+
14+
<DashButton url="/?to=/:account/tag-management" />
15+
2. Go to **Tools Configuration**.
1216
3. Select the **Triggers** tab.
1317
4. Select **Create trigger**.
1418
5. In **Trigger Name** enter a descriptive name for your trigger.

0 commit comments

Comments
 (0)