← Cloudflare Zaraz / zaraz / advanced

Custom Managed Components

Zaraz podporuje načítání vlastních nástrojů třetích stran pomocí Managed Components ↗. Může jít o Managed Components, které jste vyvinuli sami, nebo o komponenty vyvinuté někým jiným. Vlastní Managed Components se v Zaraz používají tak, že se převedou na Cloudflare Worker běžící ve vašem účtu.

Pokud s Managed Components teprve začínáte, doporučujeme začít s vytvoření vlastní komponenty Managed Component ↗ nebo se podívejte na naše ukázková Managed Component ↗.

Než začnete, připravte si soubor JavaScript určený k nasazení, který jako výchozí export obsahuje funkci Managed Component pro váš Managed Component.

V tomto návodu použijeme jednoduchý příklad vlastního Managed Component, který počítá návštěvy uživatelů a tato data zaznamenává do konzole:

// File: index.js
export default async function (manager) {
	// Add a pageview event
	manager.addEventListener("pageview", event, () => {
		const { client } = event;

		// Get the variable "counter" from the client's cookies and increase by 1
		let counter = parseInt(client.get("counter")) || 0;
		counter += 1;

		// Log the increased number
		client.execute(`console.log('Views: ${counter}')`);

		// Store the increased number for the next visit
		client.set("counter", counter);
	});
}

1. Otevřete terminál v kořenovém adresáři svého Managed Component.
2. Odtud spusťte npx managed-component-to-cloudflare-worker ./index.js my-new-counter-mc, což nasadí Managed Component do specializovaného Cloudflare Workeru. Změňte cestu na vlastní index.js. Komponentu můžete také přejmenovat.
3. Váš Managed Component by nyní měl být viditelné ve vašem účtu ↗ jako Cloudflare Worker s předponou custom-mc-.

1. V dashboardu Cloudflare přejděte na Nastavení tagu stránce.

   Přejděte na Nastavení tagu ↗

2. Vyberte Konfigurace nástrojů > Nástroje třetích stran ↗.

3. Vyberte Add new tool a vyberte Custom Managed Component ze stránky knihovny nástrojů. Vyberte Pokračovat a potvrďte svůj výběr.

4. V Vyberte Custom MC, vyberte Custom Managed Component, který jste nasadili do svého účtu, například custom-mc-my-new-counter-mc. Vyberte Pokračovat.

5. V Oprávnění, vyberte oprávnění, která chcete Custom Managed Component udělit. Pokud používáte nedůvěryhodný Managed Component, věnujte zvýšenou pozornost tomu, jaká oprávnění udělujete. Vyberte Pokračovat.

6. V Nastavení, nakonfigurujte nastavení nového nástroje. Údaje, které je třeba zadat, závisí na kódu daného Managed Component. Můžete přidávat nastavení a výchozí pole a také použít proměnné, které jste dříve nastavili.

7. Vyberte Save.

Nástroj je nyní nakonfigurovaný, zatím k němu ale nejsou přiřazené žádné akce. Přidání nových akcí řekne Zarazu, kdy má kontaktovat váš Managed Component a jaké informace mu má odeslat. Při přidávání akcí si ověřte, jaký Action Type používáte. Typy pageview a event se používají nejčastěji, ale můžete přidat libovolný typ akce odpovídající posluchačům událostí, které váš Managed Component používá. Přečtěte si, jak vytvořit další akce.

Pokud váš Managed Component naslouchá ecommerce události přepněte Sledování e-commerce na stránce Managed Component Settings.

Custom Managed Components aktuálně ještě nepodporují použití následujících metod:

• manager.registerEmbed
• manager.registerWidget
• manager.proxy
• manager.serve