feat(ads): extend conversion tracking to Messenger and Instagram (#1035)

Author: viethung0o0

AGENTS.md

@@ -186,6 +186,7 @@ See **`.agents/rules/git.md`** for the full canonical rules (commit format, bran
 - Tech stack details: `docs/tech-stack.md`
 - Request flow diagrams: `docs/request-workflow.md`
 - White-label tenancy model: `docs/tenancy.md`
+- Ads conversion tracking (CTWA/CTM/CTID, rules vs Trigger actions, CAPI): `docs/ads-conversion-tracking.md`
 - Facebook comment automation: `docs/fb-comment-automation.md` (skill: `.agents/skills/fb-comment-automation/`)
 - Push notifications (Expo Push Service, device tokens): `docs/push-notifications.md`
 - Enterprise licensing (offline Ed25519 license keys): `docs/licensing.md`

apps/builder/__tests__/ads-analytics-channel-default.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, test } from "vitest"
+import {
+  adsAnalyticsChannelValues,
+  adsAnalyticsSearchParamsCache,
+} from "@/features/ads/schemas/analytics"
+
+describe("Ads Analytics channel filter — 'All channels' default", () => {
+  test("adsAnalyticsChannelValues includes every ads-eligible channel plus the 'all' sentinel", () => {
+    expect(adsAnalyticsChannelValues).toEqual(
+      expect.arrayContaining(["whatsapp", "messenger", "instagram", "all"]),
+    )
+    expect(adsAnalyticsChannelValues).toHaveLength(4)
+  })
+
+  test("channel defaults to 'all' when the URL param is omitted", async () => {
+    const parsed = await adsAnalyticsSearchParamsCache.parse({})
+
+    expect(parsed.channel).toBe("all")
+  })
+
+  test("a legacy ?channel=whatsapp deep link still pins WhatsApp (not overridden by the new default)", async () => {
+    const parsed = await adsAnalyticsSearchParamsCache.parse({
+      channel: "whatsapp",
+    })
+
+    expect(parsed.channel).toBe("whatsapp")
+  })
+
+  test("a legacy ?channel=messenger deep link still pins Messenger", async () => {
+    const parsed = await adsAnalyticsSearchParamsCache.parse({
+      channel: "messenger",
+    })
+
+    expect(parsed.channel).toBe("messenger")
+  })
+
+  test("an explicit ?channel=all round-trips to 'all'", async () => {
+    const parsed = await adsAnalyticsSearchParamsCache.parse({
+      channel: "all",
+    })
+
+    expect(parsed.channel).toBe("all")
+  })
+})

apps/builder/__tests__/ads-analytics-channel-filter-component.test.tsx

@@ -0,0 +1,112 @@
+// @vitest-environment jsdom
+
+import { act, type ReactNode } from "react"
+import { createRoot, type Root } from "react-dom/client"
+import { afterEach, beforeEach, describe, expect, test, vi } from "vitest"
+import { ChannelFilter } from "@/features/ads/components/channel-filter"
+import type { AdsAnalyticsSearchParams } from "@/features/ads/schemas/analytics"
+
+vi.mock("next/navigation", () => ({
+  usePathname: () => "/space/ws-1/dashboard/ads",
+  useRouter: () => ({ push: vi.fn() }),
+  useSearchParams: () => new URLSearchParams(),
+}))
+
+vi.mock("next-intl", () => ({
+  useTranslations: () => (key: string) => key,
+}))
+
+vi.mock("@chatbotx.io/ui/components/ui/select", () => ({
+  Select: ({ children }: { children: ReactNode }) => children,
+  SelectContent: ({ children }: { children: ReactNode }) => children,
+  SelectItem: ({ children }: { children: ReactNode }) => (
+    <div data-select-item>{children}</div>
+  ),
+  SelectTrigger: ({ children, id }: { children: ReactNode; id?: string }) => (
+    <div data-select-trigger={id}>{children}</div>
+  ),
+  SelectValue: () => null,
+}))
+
+const baseRange = {
+  from: "2026-08-01",
+  to: "2026-08-10",
+  account: "",
+  channelAccount: "",
+  adAccount: "",
+} as Omit<AdsAnalyticsSearchParams, "channel">
+
+describe("ChannelFilter — 'All channels' option and integration-select visibility", () => {
+  let container: HTMLDivElement
+  let root: Root
+
+  beforeEach(() => {
+    Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true })
+    container = document.createElement("div")
+    document.body.append(container)
+    root = createRoot(container)
+  })
+
+  afterEach(() => {
+    act(() => {
+      root.unmount()
+    })
+    container.remove()
+  })
+
+  test("renders an 'All channels' option via the special label branch, not a fake tabs.all key", async () => {
+    await act(async () => {
+      root.render(
+        <ChannelFilter
+          channelIntegrations={[]}
+          range={{ ...baseRange, channel: "all" }}
+          selectedIntegrationId={null}
+        />,
+      )
+      await Promise.resolve()
+    })
+
+    expect(container.textContent).toContain(
+      "ads.analytics.channelFilter.allChannels",
+    )
+    expect(container.textContent).not.toContain("ads.conversionEvents.tabs.all")
+  })
+
+  test("hides the integration select entirely when channel is 'all'", async () => {
+    await act(async () => {
+      root.render(
+        <ChannelFilter
+          channelIntegrations={[{ id: "msg-1", name: "My Page" }]}
+          range={{ ...baseRange, channel: "all" }}
+          selectedIntegrationId={null}
+        />,
+      )
+      await Promise.resolve()
+    })
+
+    expect(
+      container.querySelector(
+        '[data-select-trigger="ads-analytics-channel-account"]',
+      ),
+    ).toBeNull()
+  })
+
+  test("shows the integration select for a concrete channel", async () => {
+    await act(async () => {
+      root.render(
+        <ChannelFilter
+          channelIntegrations={[{ id: "msg-1", name: "My Page" }]}
+          range={{ ...baseRange, channel: "messenger" }}
+          selectedIntegrationId="msg-1"
+        />,
+      )
+      await Promise.resolve()
+    })
+
+    expect(
+      container.querySelector(
+        '[data-select-trigger="ads-analytics-channel-account"]',
+      ),
+    ).not.toBeNull()
+  })
+})