Merge pull request #226 from httpsphl/feat/catalog-paid-media-roles

feat(catalog): six paid media roles

Author: httpsphl

app/src/features/catalog/agency.test.tsx

@@ -33,7 +33,7 @@ describe("the Bot agency", () => {
 
     fireEvent.click(within(invite).getByRole("button", { name: "See all bots" }));
     const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
-    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(73);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(79);
   });
 
   test("a crew with only its chief invites the owner to pick bots, and a click adds one", async () => {
@@ -82,10 +82,10 @@ describe("the Bot agency", () => {
     await openCrewWithChief();
     fireEvent.click(screen.getByRole("button", { name: "Bot agency" }));
     const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
-    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(73);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(79);
 
     fireEvent.click(within(dialog).getByRole("button", { name: "Marketing & sales" }));
-    expect(within(dialog).getAllByRole("listitem")).toHaveLength(18);
+    expect(within(dialog).getAllByRole("listitem")).toHaveLength(24);
     fireEvent.click(within(dialog).getByRole("button", { name: "Product & management" }));
     expect(within(dialog).getAllByRole("listitem")).toHaveLength(14);
 
@@ -129,7 +129,7 @@ describe("the Bot agency", () => {
     expect(addCalls(fake)[0]).toMatchObject({ templateId: "code-reviewer" });
 
     fireEvent.click(within(dialog).getByRole("button", { name: "Back to all bots" }));
-    expect(within(dialog).getAllByRole("listitem")).toHaveLength(73);
+    expect(within(dialog).getAllByRole("listitem")).toHaveLength(79);
   });
 
   test("the same role twice gets another name", async () => {

app/src/i18n/en/catalog.ts

@@ -4,6 +4,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
+import { paidMedia } from "./catalogPaidMedia";
 import { product } from "./catalogProduct";
 
 // The Bot agency (spec 26): ready-made bots the owner adds to a crew. The
@@ -60,5 +61,6 @@ export const catalog = {
     ...contentAndLearning,
     ...design,
     ...finance,
+    ...paidMedia,
   },
 };

app/src/i18n/en/catalogPaidMedia.ts

@@ -0,0 +1,67 @@
+// Paid media roles, listed under Marketing & sales (spec 26.3): what the owner
+// reads about each. None creates, changes or pays for an ad.
+
+export const paidMedia = {
+  "ppc-strategist": {
+    name: "Search Ads Strategist",
+    role: "Plans search ad campaigns: the keywords, the structure, the ads and a small budget to test, with a plan you carry out",
+    summary:
+      "Plans your search ads, from keywords to the ads themselves, with a small budget to test first",
+    about:
+      "Starts from what a customer is worth to you, builds the keyword groups by what people intend, writes the ads from your real offer and sets a small test with clear rules for when to stop and when to raise. It never creates or pays for an ad: you do, with its plan.",
+    when: "When you want to start search ads, or the ones you have are not paying off.",
+    pairs: "Copywriter, to sharpen the ads, and Search Query Analyst, to read the search terms.",
+  },
+  "paid-social-strategist": {
+    name: "Paid Social Strategist",
+    role: "Plans paid campaigns on social platforms: the audience, the formats, the creative needs and a test budget, without sensitive targeting",
+    summary:
+      "Plans your paid social campaigns: who to reach, what to show and how to test it with a small budget",
+    about:
+      "Picks one objective, defines who to reach by interests, place and the customer lists you choose, and plans the formats and the variants to test. It never targets by sensitive traits like health or religion and never preys on insecurities. You create and pay for the campaign yourself.",
+    when: "When you want to reach new people on social platforms without wasting your budget.",
+    pairs:
+      "Ad Creative Strategist, for what to say and show, and Video Scriptwriter, for short videos.",
+  },
+  "ad-creative-strategist": {
+    name: "Ad Creative Strategist",
+    role: "Plans what ads should say and show: angles, hooks and variants to test, and learns from what performs",
+    summary:
+      "Plans what your ads should say and show, with a few angles to test and what each one teaches you",
+    about:
+      "Takes the words your customers use and writes three or four different angles, each with the hook, the text and a brief for the picture or video. It changes one thing per test, so a result says why it won. It only uses claims you can prove: no invented reviews or false scarcity.",
+    when: "When your ads all look the same, or you do not know what to test next.",
+    pairs: "Designer, for the pictures, Copywriter, to polish, and Paid Social Strategist.",
+  },
+  "ad-auditor": {
+    name: "Ad Account Auditor",
+    role: "Reviews how your ad campaigns are set up and run, finds wasted spend and missed chances, and lists fixes in order",
+    summary:
+      "Reviews your ad campaigns, finds wasted spend and missed chances, and lists the fixes in order",
+    about:
+      "Reads the reports you give it and finds the usual leaks: spend with no results, people reached twice, tired ads, searches that do not fit and results counted wrong. Each finding comes with the numbers, the money at stake and the fix, in order. It has no access to your account and changes nothing.",
+    when: "When your ad spend is growing but you are not sure it is working.",
+    pairs:
+      "Tracking Specialist, to check the counts, and Search Ads Strategist, to apply the fixes.",
+  },
+  "tracking-specialist": {
+    name: "Tracking Specialist",
+    role: "Checks that your ads and site measure results correctly: events, tags, links and what counts as a result",
+    summary:
+      "Checks that your ads and site count results correctly, so you can trust the numbers you decide on",
+    about:
+      "Lists every place a result is counted and compares them: ad platform, site, store and spreadsheet. It explains each gap in plain words, such as double counting or links that lose their tags, and proposes one clean naming for events and links. It says how far the numbers can be trusted and collects no more about visitors than you need.",
+    when: "Before you spend on ads, or when the numbers from different places do not agree.",
+    pairs: "Frontend Developer, who adds the tags, and Ad Account Auditor.",
+  },
+  "search-query-analyst": {
+    name: "Search Query Analyst",
+    role: "Reads the real searches behind your ads or site, groups them by intent and finds what to add, exclude or write for",
+    summary:
+      "Reads the real searches behind your ads and site, and tells you what to add, exclude or write for",
+    about:
+      "Takes the real words people typed and groups them by what they want: to buy, to compare, to learn. It gives you three lists: what to exclude because it wastes money, what to add because it works and what to write about because people ask. It says how sure it is, since a term with three clicks proves nothing.",
+    when: "When you run search ads or want to know what people look for before they find you.",
+    pairs: "Search Ads Strategist, who uses the lists, and SEO Specialist, for the content ideas.",
+  },
+};

app/src/i18n/es/catalog.ts

@@ -5,6 +5,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
+import { paidMedia } from "./catalogPaidMedia";
 import { product } from "./catalogProduct";
 
 export const catalog: Messages["catalog"] = {
@@ -57,5 +58,6 @@ export const catalog: Messages["catalog"] = {
     ...contentAndLearning,
     ...design,
     ...finance,
+    ...paidMedia,
   },
 };

app/src/i18n/es/catalogPaidMedia.ts

@@ -0,0 +1,69 @@
+import type { paidMedia as en } from "../en/catalogPaidMedia";
+
+export const paidMedia: typeof en = {
+  "ppc-strategist": {
+    name: "Estratega de anuncios de búsqueda",
+    role: "Planifica campañas de anuncios en buscadores: las palabras, la estructura, los anuncios y un presupuesto pequeño para probar, en un plan que tú ejecutas",
+    summary:
+      "Planifica tus anuncios de búsqueda, de las palabras a los anuncios, con un presupuesto pequeño para probar primero",
+    about:
+      "Parte de lo que vale un cliente para ti, arma los grupos de palabras por lo que la gente quiere, escribe los anuncios con tu oferta real y define una prueba pequeña con reglas claras de cuándo parar y cuándo subir. Nunca crea ni paga un anuncio: lo haces tú, con su plan.",
+    when: "Cuando quieres empezar con anuncios de búsqueda, o los que tienes no dan resultado.",
+    pairs:
+      "Redactor publicitario, para afinar los anuncios, y Analista de búsquedas, para leer los términos buscados.",
+  },
+  "paid-social-strategist": {
+    name: "Estratega de anuncios en redes sociales",
+    role: "Planifica campañas de pago en redes sociales: el público, los formatos, lo que hay que crear y un presupuesto de prueba, sin segmentación sensible",
+    summary:
+      "Planifica tus campañas de pago en redes: a quién llegar, qué mostrar y cómo probarlo con poco dinero",
+    about:
+      "Elige un solo objetivo, define a quién llegar por intereses, lugar y las listas de clientes que decidas usar, y planifica los formatos y las variantes a probar. Nunca segmenta por rasgos sensibles como la salud o la religión ni se aprovecha de inseguridades. La campaña la creas y la pagas tú.",
+    when: "Cuando quieres llegar a gente nueva en las redes sin desperdiciar el presupuesto.",
+    pairs:
+      "Estratega de creatividades de anuncios, para qué decir y mostrar, y Guionista de video, para videos cortos.",
+  },
+  "ad-creative-strategist": {
+    name: "Estratega de creatividades de anuncios",
+    role: "Planifica qué deben decir y mostrar los anuncios: ángulos, ganchos y variantes para probar, y aprende de lo que funciona",
+    summary:
+      "Planifica qué deben decir y mostrar tus anuncios, con algunos ángulos para probar y lo que enseña cada uno",
+    about:
+      "Toma las palabras que usan tus clientes y escribe tres o cuatro ángulos distintos, cada uno con el gancho, el texto y una guía para la imagen o el video. Cambia una sola cosa por prueba, para que el resultado diga por qué ganó. Solo usa afirmaciones que puedes demostrar: nada de reseñas inventadas ni falsa escasez.",
+    when: "Cuando tus anuncios se parecen todos, o no sabes qué probar a continuación.",
+    pairs:
+      "Diseñador, para las imágenes, Redactor publicitario, para pulir, y Estratega de anuncios en redes sociales.",
+  },
+  "ad-auditor": {
+    name: "Auditor de cuentas de anuncios",
+    role: "Revisa cómo están montadas y cómo funcionan tus campañas de anuncios, encuentra dinero desperdiciado y oportunidades perdidas y lista los arreglos en orden",
+    summary:
+      "Revisa tus campañas de anuncios, encuentra dinero desperdiciado y oportunidades perdidas y lista los arreglos en orden",
+    about:
+      "Lee los informes que le des y encuentra las fugas de siempre: gasto sin resultados, gente alcanzada dos veces, anuncios cansados, búsquedas que no encajan y resultados mal contados. Cada hallazgo trae los números, el dinero en juego y el arreglo, en orden. No tiene acceso a tu cuenta y no cambia nada en ella.",
+    when: "Cuando el gasto en anuncios crece, pero no estás seguro de que funcione.",
+    pairs:
+      "Especialista en medición, para comprobar los conteos, y Estratega de anuncios de búsqueda, para aplicar los arreglos.",
+  },
+  "tracking-specialist": {
+    name: "Especialista en medición",
+    role: "Comprueba que tus anuncios y tu sitio midan bien los resultados: eventos, etiquetas, enlaces y qué cuenta como resultado",
+    summary:
+      "Comprueba que tus anuncios y tu sitio cuenten bien los resultados, para que confíes en los números",
+    about:
+      "Lista cada lugar donde se cuenta un resultado y los compara: plataforma de anuncios, sitio, tienda y hoja de cálculo. Explica cada diferencia en palabras sencillas, como el conteo doble o los enlaces que pierden su etiqueta, y propone un nombre limpio para eventos y enlaces. Dice hasta dónde se puede confiar en los números y no recoge de los visitantes más de lo que necesitas.",
+    when: "Antes de gastar en anuncios, o cuando los números de distintos sitios no coinciden.",
+    pairs: "Desarrollador front-end, que pone las etiquetas, y Auditor de cuentas de anuncios.",
+  },
+  "search-query-analyst": {
+    name: "Analista de búsquedas",
+    role: "Lee las búsquedas reales detrás de tus anuncios o tu sitio, las agrupa por intención y encuentra qué añadir, excluir o escribir",
+    summary:
+      "Lee las búsquedas reales detrás de tus anuncios y tu sitio y dice qué añadir, excluir o escribir",
+    about:
+      "Toma las palabras que la gente realmente escribió y las agrupa por lo que quiere: comprar, comparar, aprender. Entrega tres listas: qué excluir porque gasta dinero sin sentido, qué añadir porque funciona y sobre qué escribir porque la gente pregunta. Dice qué tan seguro está, ya que un término con tres clics no prueba nada.",
+    when: "Cuando haces anuncios de búsqueda o quieres saber qué busca la gente antes de encontrarte.",
+    pairs:
+      "Estratega de anuncios de búsqueda, que usa las listas, y Especialista en SEO, para las ideas de contenido.",
+  },
+};

app/src/i18n/pt-BR/catalog.ts

@@ -5,6 +5,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
+import { paidMedia } from "./catalogPaidMedia";
 import { product } from "./catalogProduct";
 
 export const catalog: Messages["catalog"] = {
@@ -57,5 +58,6 @@ export const catalog: Messages["catalog"] = {
     ...contentAndLearning,
     ...design,
     ...finance,
+    ...paidMedia,
   },
 };

app/src/i18n/pt-BR/catalogPaidMedia.ts

@@ -0,0 +1,69 @@
+import type { paidMedia as en } from "../en/catalogPaidMedia";
+
+export const paidMedia: typeof en = {
+  "ppc-strategist": {
+    name: "Estrategista de anúncios de busca",
+    role: "Planeja campanhas de anúncios na busca: as palavras, a estrutura, os anúncios e um orçamento pequeno para testar, num plano que você executa",
+    summary:
+      "Planeja seus anúncios de busca, das palavras aos anúncios, com um orçamento pequeno para testar primeiro",
+    about:
+      "Parte do quanto um cliente vale para você, monta os grupos de palavras pelo que as pessoas querem, escreve os anúncios com a sua oferta real e define um teste pequeno com regras claras de quando parar e quando aumentar. Nunca cria nem paga um anúncio: quem faz é você, com o plano dele.",
+    when: "Quando você quer começar anúncios na busca, ou os que você tem não estão dando retorno.",
+    pairs:
+      "Redator publicitário, para afiar os anúncios, e Analista de buscas, para ler os termos pesquisados.",
+  },
+  "paid-social-strategist": {
+    name: "Estrategista de anúncios em redes sociais",
+    role: "Planeja campanhas pagas nas redes sociais: o público, os formatos, o que criar e um orçamento de teste, sem segmentação sensível",
+    summary:
+      "Planeja suas campanhas pagas nas redes: quem alcançar, o que mostrar e como testar com pouco dinheiro",
+    about:
+      "Escolhe um só objetivo, define quem alcançar por interesses, lugar e as listas de clientes que você decidir usar, e planeja os formatos e as variações a testar. Nunca segmenta por traços sensíveis como saúde ou religião e nunca explora inseguranças. A campanha, você mesmo cria e paga.",
+    when: "Quando você quer alcançar gente nova nas redes sem desperdiçar o orçamento.",
+    pairs:
+      "Estrategista de criativos de anúncios, para o que dizer e mostrar, e Roteirista de vídeo, para vídeos curtos.",
+  },
+  "ad-creative-strategist": {
+    name: "Estrategista de criativos de anúncios",
+    role: "Planeja o que os anúncios devem dizer e mostrar: ângulos, ganchos e variações para testar, e aprende com o que funciona",
+    summary:
+      "Planeja o que seus anúncios devem dizer e mostrar, com alguns ângulos para testar e o que cada um ensina",
+    about:
+      "Pega as palavras que seus clientes usam e escreve três ou quatro ângulos diferentes, cada um com o gancho, o texto e um briefing para a imagem ou o vídeo. Muda uma coisa por teste, para o resultado dizer por que ganhou. Só usa afirmações que você pode provar: nada de avaliação inventada nem falsa escassez.",
+    when: "Quando seus anúncios parecem todos iguais, ou você não sabe o que testar a seguir.",
+    pairs:
+      "Designer, para as imagens, Redator publicitário, para polir, e Estrategista de anúncios em redes sociais.",
+  },
+  "ad-auditor": {
+    name: "Auditor de contas de anúncios",
+    role: "Revisa como suas campanhas de anúncios estão montadas e rodando, acha dinheiro desperdiçado e chances perdidas e lista os ajustes em ordem",
+    summary:
+      "Revisa suas campanhas de anúncios, acha dinheiro desperdiçado e chances perdidas e lista os ajustes em ordem",
+    about:
+      "Lê os relatórios que você der e acha os vazamentos de sempre: gasto sem resultado, gente alcançada duas vezes, anúncios cansados, buscas que não combinam e resultados contados errado. Cada achado vem com os números, o dinheiro em jogo e o ajuste, em ordem. Não tem acesso à sua conta e não muda nada nela.",
+    when: "Quando o gasto com anúncios cresce, mas você não tem certeza de que está funcionando.",
+    pairs:
+      "Especialista em medição, para conferir as contagens, e Estrategista de anúncios de busca, para aplicar os ajustes.",
+  },
+  "tracking-specialist": {
+    name: "Especialista em medição",
+    role: "Confere se seus anúncios e seu site medem os resultados direito: eventos, tags, links e o que conta como resultado",
+    summary:
+      "Confere se seus anúncios e seu site contam os resultados direito, para você confiar nos números",
+    about:
+      "Lista cada lugar em que um resultado é contado e compara: plataforma de anúncios, site, loja e planilha. Explica cada diferença em palavras simples, como contagem em dobro ou links que perdem a marcação, e propõe um nome limpo para eventos e links. Diz até onde os números merecem confiança e não coleta dos visitantes mais do que você precisa.",
+    when: "Antes de gastar com anúncios, ou quando os números de lugares diferentes não batem.",
+    pairs: "Desenvolvedor front-end, que coloca as tags, e Auditor de contas de anúncios.",
+  },
+  "search-query-analyst": {
+    name: "Analista de buscas",
+    role: "Lê as buscas reais por trás dos seus anúncios ou do seu site, agrupa por intenção e acha o que incluir, excluir ou escrever",
+    summary:
+      "Lê as buscas reais por trás dos seus anúncios e do seu site e diz o que incluir, excluir ou escrever",
+    about:
+      "Pega as palavras que as pessoas realmente digitaram e agrupa pelo que querem: comprar, comparar, aprender. Entrega três listas: o que excluir porque gasta dinheiro à toa, o que incluir porque funciona e sobre o que escrever porque as pessoas perguntam. Diz o quanto tem certeza, já que um termo com três cliques não prova nada.",
+    when: "Quando você faz anúncios de busca ou quer saber o que as pessoas procuram antes de achar você.",
+    pairs:
+      "Estrategista de anúncios de busca, que usa as listas, e Especialista em SEO, para as ideias de conteúdo.",
+  },
+};