iron-edge 2.12.0 → 2.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/bin/iron-edge.js +4 -3
- package/installer/office.js +69 -5
- package/installer/update.js +8 -0
- package/package.json +1 -1
- package/skills/anuncios/SKILL.md +29 -15
- package/skills/anuncios/funil.md +87 -0
- package/skills/loja/SKILL.md +15 -1
package/README.md
CHANGED
|
@@ -249,7 +249,11 @@ O que esperar:
|
|
|
249
249
|
5. **Ficha da loja** (skill `loja`, desde a 2.8.0): no site, "Começar com a loja X" (ou diga "monta a ficha"). O Iron lê a Shopify da loja, aponta o que está errado, pergunta só o que falta e grava `Projetos/<loja>/PROJETO.md` e `brand.json` no seu cofre; pro site vai só um resumo de até 600 caracteres (sem sócio, fornecedor, conta de anúncio nem pedido). Daí em diante todo pedido daquela loja chega com a ficha. Desde a 2.9.0, no site as perguntas vêm uma por vez, com botões.
|
|
250
250
|
**Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`). Desde a 2.11.0 conduz também o caminho de quem ainda não tem loja: produto e nicho (com 3 concorrentes que anunciam agora) e nome com domínio e @ livres (medidos); a ficha do projeto nasce no cofre.
|
|
251
251
|
|
|
252
|
-
**
|
|
252
|
+
**Funil e precificação** (desde a 2.14.0): o retrato dos anúncios traz o funil (parou nos 3 s, ficou assistindo, clicou no link, clique virou visita, visita virou carrinho, carrinho virou checkout, checkout virou compra, compras por visita, vezes por pessoa) e o resultado de cada campanha no nome certo ("engajamentos" não cai em "compras"). A skill `anuncios` lê a régua em `skills/anuncios/funil.md` e responde onde o funil vaza e, com a precificação preenchida na aba Anúncios, o CPA real contra o máximo (sobra, paga a conta, prejuízo). Na skill `loja`, "custos da loja" grava o custo dos produtos na Shopify (você confirma antes; só o custo passa).
|
|
253
|
+
|
|
254
|
+
**Atualização sozinha** (desde a 2.13.0): antes de abrir, o `ironoffice` compara a versão instalada (`~/.iron/install-manifest.json`) com a do pacote e, se estiver atrás, roda o mesmo `npx iron-edge update` (sem mexer no atalho do shell): troca só o arquivo do pacote que você não editou, avisa antes (`Atualizando o Iron 2.12.0 -> 2.13.0 (alguns segundos, nao feche)...`) e imprime 1 linha no fim (`Iron atualizado 2.12.0 -> 2.13.0: N arquivo(s) trocado(s), M ficaram como estavam (voce mexeu neles)`). Sem internet ou com erro, abre com a versão que está e avisa. `npx iron-edge office --sem-update` pula.
|
|
255
|
+
|
|
256
|
+
**Anúncios** (skill `anuncios`, desde a 2.12.0): na aba Anúncios do site, o botão **Atualizar agora** (ou no chat "como estão meus anúncios") faz o Iron medir os últimos 7 dias da sua conta da Meta e mostrar gasto, resultados, custo por resultado e o que corrigir hoje (desde a 2.13.0 sem sair da aba; campanha no ar com todos os grupos pausados aparece como "parada"): peça nova que não aparece há mais de 48 h, data vencida ainda no ar, dinheiro indo pra peça vencida e peça recusada. O Iron só lê; pausar uma peça ele pergunta antes. A Meta tem que estar ligada no seu Iron (`/mcp` → `meta-ads` → Authenticate).
|
|
253
257
|
6. **Deixe essa aba do terminal aberta.** É ela que faz o Iron responder no site.
|
|
254
258
|
7. **Pra fechar:** Ctrl+C duas vezes ou `/exit`, e o escritório anoitece em 1 a 2 segundos. No **Warp**, fechar a aba pelo X demora cerca de 1 minuto: o Warp guarda a aba fechada pra poder reabrir, e nesse tempo o canal ainda está vivo. Feche com Ctrl+C antes do X, ou desligue a reabertura de abas fechadas nas configurações do Warp.
|
|
255
259
|
|
package/bin/iron-edge.js
CHANGED
|
@@ -14,8 +14,9 @@
|
|
|
14
14
|
* arquivos cujo hash bate com o manifesto — os que
|
|
15
15
|
* ninguem alterou — e preserva o resto
|
|
16
16
|
*
|
|
17
|
-
* office [--safe] [--sem-feed|--com-feed] liga o Iron Office: instala o plugin de
|
|
18
|
-
*
|
|
17
|
+
* office [--safe] [--sem-feed|--com-feed] [--sem-update] liga o Iron Office: instala o plugin de
|
|
18
|
+
* canal, atualiza as skills e agentes do Iron (o mesmo `update`;
|
|
19
|
+
* --sem-update pula) e abre o Claude Code conversando com o chat
|
|
19
20
|
*
|
|
20
21
|
* doctor [--json] mede a maquina (Node, git, Claude Code, Iron Edge, chave,
|
|
21
22
|
* plugin, cofre, atalho) e, com a chave aceita, manda o resultado
|
|
@@ -174,6 +175,6 @@ if (cmd === 'install') {
|
|
|
174
175
|
process.exit(r.status ?? 1);
|
|
175
176
|
|
|
176
177
|
} else {
|
|
177
|
-
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--json]');
|
|
178
|
+
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--sem-update] [--json]');
|
|
178
179
|
process.exit(cmd && cmd !== '--help' && cmd !== '-h' ? 1 : 0);
|
|
179
180
|
}
|
package/installer/office.js
CHANGED
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
* faz o Iron responder no site.
|
|
9
9
|
*
|
|
10
10
|
* Flags: --safe tira o `--permission-mode bypassPermissions` (o Claude pede licenca a cada
|
|
11
|
-
* ferramenta). --sem-
|
|
11
|
+
* ferramenta). --sem-update nao atualiza as skills e agentes do Iron antes de abrir (onda 28 rev1).
|
|
12
|
+
* --sem-feed / --com-feed gravam `office_feed: off|on` no ~/.iron/config.yaml (onda 21).
|
|
12
13
|
* Qualquer outro argumento vai direto pro `claude`.
|
|
13
14
|
*
|
|
14
15
|
* Consentimento (onda 21): na primeira abertura (ou quando o texto muda de versao) mostra o que o canal
|
|
@@ -39,7 +40,7 @@ const { perguntaSN } = require('./pergunta');
|
|
|
39
40
|
const { setFeed } = require('./feed');
|
|
40
41
|
|
|
41
42
|
// Muda a versao quando o texto do consentimento mudar de sentido: todo mundo ve de novo.
|
|
42
|
-
const CONSENT_VERSION = '2026-10-
|
|
43
|
+
const CONSENT_VERSION = '2026-10-30'; // rev1 da 28: as skills tambem se atualizam sozinhas
|
|
43
44
|
const CONSENT_TEXT = [
|
|
44
45
|
'Antes de ligar o canal do Iron Office:',
|
|
45
46
|
' - o que voce escrever no site vira pedido nesta sessao do Claude Code,',
|
|
@@ -48,7 +49,8 @@ const CONSENT_TEXT = [
|
|
|
48
49
|
' dos arquivos criados ou editados, o comeco de cada comando, buscas,',
|
|
49
50
|
' a pasta e os nomes dos conectores; o chat e as entregas ficam no site;',
|
|
50
51
|
' - apagamos padroes conhecidos de senha, chave e token (nem sempre todos);',
|
|
51
|
-
' - a cada abertura o plugin se atualiza
|
|
52
|
+
' - a cada abertura o plugin se atualiza, o conector da Meta e instalado',
|
|
53
|
+
' e as skills do Iron tambem (o que voce editou fica; pular: --sem-update);',
|
|
52
54
|
' - politica: ' + OFFICE_URL + '/termos',
|
|
53
55
|
];
|
|
54
56
|
|
|
@@ -102,7 +104,67 @@ function aplicarFlagsFeed(argv, home) {
|
|
|
102
104
|
return '';
|
|
103
105
|
}
|
|
104
106
|
|
|
105
|
-
const NOSSAS_FLAGS = new Set(['--safe', '--sem-feed', '--com-feed']);
|
|
107
|
+
const NOSSAS_FLAGS = new Set(['--safe', '--sem-feed', '--com-feed', '--sem-update']);
|
|
108
|
+
|
|
109
|
+
// Onda 28 rev1: o pacote instalado em ~/.claude (skills, agentes, steps) so' mudava com `npx iron-edge update`, e
|
|
110
|
+
// nenhum aviso dizia que havia versao nova. Agora o `ironoffice` compara a versao do manifesto com a deste pacote e,
|
|
111
|
+
// se estiver atras, roda o MESMO update.js em processo filho (troca so' o que bate com o hash do manifesto; o que o
|
|
112
|
+
// aluno editou fica). Melhor-esforco, igual ao plugin: falhou, segue com a versao instalada. --sem-update pula.
|
|
113
|
+
const UPDATE_TIMEOUT_MS = 180000;
|
|
114
|
+
|
|
115
|
+
function versaoNum(v) {
|
|
116
|
+
const m = String(v || '').replace(/^iron-edge-/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
|
|
117
|
+
return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// -1 a < b · 0 iguais · 1 a > b (versao ilegivel conta como a mais antiga)
|
|
121
|
+
function compararVersao(a, b) {
|
|
122
|
+
const x = versaoNum(a), y = versaoNum(b);
|
|
123
|
+
if (!x || !y) return !x && !y ? 0 : (!x ? -1 : 1);
|
|
124
|
+
for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i] ? -1 : 1;
|
|
125
|
+
return 0;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function versaoDoPacote() {
|
|
129
|
+
try { return require(path.join(__dirname, '..', 'package.json')).version || ''; } catch (_) { return ''; }
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// Devolve a linha que o office imprime (sempre uma; nunca lanca). o.spawn e o.updateScript existem pro teste.
|
|
133
|
+
function atualizarPacote(home, o) {
|
|
134
|
+
const opts = o || {};
|
|
135
|
+
const h = home || os.homedir();
|
|
136
|
+
const pacote = opts.pkgVersion || versaoDoPacote();
|
|
137
|
+
const man = path.join(h, '.iron', 'install-manifest.json');
|
|
138
|
+
let instalada;
|
|
139
|
+
try { instalada = JSON.parse(fs.readFileSync(man, 'utf8')).version || ''; }
|
|
140
|
+
catch (e) {
|
|
141
|
+
if (e && e.code === 'ENOENT') return ' [aviso] nao achei o registro da instalacao do Iron: as skills nao se atualizam sozinhas (rode npx iron-edge update)';
|
|
142
|
+
return ' [aviso] o registro da instalacao do Iron esta ilegivel: seguindo com o que esta instalado (rode npx iron-edge update)';
|
|
143
|
+
}
|
|
144
|
+
const antes = String(instalada).replace(/^iron-edge-/, '') || '?';
|
|
145
|
+
if (!pacote || compararVersao(instalada, pacote) >= 0) return ' [ok] Iron ja esta na ' + antes;
|
|
146
|
+
// a saida do filho e' capturada: sem esta linha o aluno ficava ate 3 min olhando o terminal parado (gate r1)
|
|
147
|
+
if (opts.antes) opts.antes(' Atualizando o Iron ' + antes + ' -> ' + pacote + ' (alguns segundos, nao feche)...');
|
|
148
|
+
const spawn = opts.spawn || spawnSync;
|
|
149
|
+
// --sem-atalho: o update automatico nunca cria o alias no ~/.zshrc (o install pergunta antes; aqui nao ha
|
|
150
|
+
// pergunta). gate r1 do aluno-zero: sem ela, quem recusou o atalho ganhava o alias sem saber
|
|
151
|
+
const r = spawn(process.execPath, [opts.updateScript || path.join(__dirname, 'update.js'), '--sem-atalho'], {
|
|
152
|
+
encoding: 'utf8',
|
|
153
|
+
timeout: UPDATE_TIMEOUT_MS,
|
|
154
|
+
maxBuffer: 32 * 1024 * 1024, // a saida estourando 1 MiB matava o filho no meio da troca (gate r1, ENOBUFS)
|
|
155
|
+
env: { ...process.env, HOME: h, USERPROFILE: h, IRON_EDGE_VERSION: pacote, IRON_EDGE_RESUMO: '1' },
|
|
156
|
+
});
|
|
157
|
+
const out = (r && (r.stdout || '') + (r.stderr || '')) || '';
|
|
158
|
+
const m = out.match(/IRON_UPDATE_RESUMO (\{.*\})/);
|
|
159
|
+
if (!r || r.error || r.status !== 0 || !m) {
|
|
160
|
+
const motivo = r && r.error ? (r.error.code || r.error.message) : (out.trim().split('\n').pop() || 'sem detalhe');
|
|
161
|
+
return ' [aviso] nao deu pra atualizar o Iron agora (' + String(motivo).slice(0, 120) + '): seguindo com a ' + antes + '. Pra tentar de novo: npx iron-edge update';
|
|
162
|
+
}
|
|
163
|
+
let res = { trocados: 0, preservados: 0 };
|
|
164
|
+
try { res = JSON.parse(m[1]); } catch (_) { /* conta zero */ }
|
|
165
|
+
return ' [ok] Iron atualizado ' + antes + ' -> ' + pacote + ': ' + res.trocados + ' arquivo(s) trocado(s)'
|
|
166
|
+
+ (res.preservados ? ', ' + res.preservados + ' ficaram como estavam (voce mexeu neles)' : '');
|
|
167
|
+
}
|
|
106
168
|
|
|
107
169
|
function keyPath(home) {
|
|
108
170
|
return path.join(home || os.homedir(), '.claude', 'iron-office-api-key');
|
|
@@ -318,6 +380,8 @@ async function main(argv) {
|
|
|
318
380
|
step(claude, 'atualizacao do plugin', ['plugin', 'update', PLUGIN], [/already|up.to.date|latest/i]);
|
|
319
381
|
metaAds(claude);
|
|
320
382
|
avisoPluginNovo(claude);
|
|
383
|
+
if (argv.includes('--sem-update')) console.log(' [ok] atualizacao do Iron pulada (--sem-update)');
|
|
384
|
+
else console.log(atualizarPacote(undefined, { antes: (l) => console.log(l) }));
|
|
321
385
|
|
|
322
386
|
const safe = argv.includes('--safe');
|
|
323
387
|
console.log('');
|
|
@@ -350,7 +414,7 @@ async function main(argv) {
|
|
|
350
414
|
return r.status ?? 1;
|
|
351
415
|
}
|
|
352
416
|
|
|
353
|
-
module.exports = { resolveCwd, campoYaml, CONSENT_VERSION, CONSENT_TEXT, consentPath, consentimentoOk, pedirConsentimento, aplicarFlagsFeed, metaAds, META_ADS_MCP, avisoPluginNovo, pluginVersion, buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
|
|
417
|
+
module.exports = { atualizarPacote, compararVersao, resolveCwd, campoYaml, CONSENT_VERSION, CONSENT_TEXT, consentPath, consentimentoOk, pedirConsentimento, aplicarFlagsFeed, metaAds, META_ADS_MCP, avisoPluginNovo, pluginVersion, buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
|
|
354
418
|
|
|
355
419
|
if (require.main === module) {
|
|
356
420
|
main(process.argv.slice(2)).then(code => process.exit(code), err => {
|
package/installer/update.js
CHANGED
|
@@ -388,9 +388,16 @@ const versaoDesatualizada = Boolean(versaoDoPacote) && versaoRegistrada !== vers
|
|
|
388
388
|
if (!plano.trocar.length && !plano.adicionar.length && !plano.restaurar.length && !plano.remover.length && !plano.gerar.length && !plano.preservar.length && !versaoDesatualizada && !metadataReparado) {
|
|
389
389
|
log(''); log('Nada a fazer: sua instalacao ja esta na versao deste pacote.');
|
|
390
390
|
log(atalho(false));
|
|
391
|
+
resumo(0);
|
|
391
392
|
process.exit(0);
|
|
392
393
|
}
|
|
393
394
|
|
|
395
|
+
// Onda 28 rev1: o `ironoffice` roda este update em processo filho e imprime 1 linha so'. Com IRON_EDGE_RESUMO=1
|
|
396
|
+
// a ultima linha da saida diz quantos arquivos trocaram e quantos ficaram porque a pessoa editou.
|
|
397
|
+
function resumo(trocados) {
|
|
398
|
+
if (process.env.IRON_EDGE_RESUMO === '1') log('IRON_UPDATE_RESUMO ' + JSON.stringify({ trocados, preservados: plano.preservar.length }));
|
|
399
|
+
}
|
|
400
|
+
|
|
394
401
|
// ---------------------------------------------------------------- FASE 1: escrever ao lado
|
|
395
402
|
log('');
|
|
396
403
|
log('--- FASE 1: escrevendo ao lado (nada em uso muda ainda) ---');
|
|
@@ -523,6 +530,7 @@ log('================================');
|
|
|
523
530
|
log(' Atualizado com sucesso');
|
|
524
531
|
log('================================');
|
|
525
532
|
log(atalho(false));
|
|
533
|
+
resumo(feitos.length);
|
|
526
534
|
log('Confira quando quiser: npx iron-edge verify');
|
|
527
535
|
log('Reabra o Claude Code para carregar o que mudou.');
|
|
528
536
|
log('');
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "iron-edge",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.14.0",
|
|
4
4
|
"description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 20 skills, com quality gate, memoria, instalador que nunca sobrescreve o comando office (chat do Iron Office no dashboard; confere a chave com o site antes de abrir o Claude) e o doctor (mede a maquina e acende o Setup do site).",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude",
|
package/skills/anuncios/SKILL.md
CHANGED
|
@@ -47,15 +47,19 @@ Nas ferramentas, `ad_account_id` é só o número (sem `act_`).
|
|
|
47
47
|
|
|
48
48
|
Antes de passar um campo novo em `fields`, confira com `ads_get_field_context` (a ferramenta recusa campo que não existe naquele nível). Os desta skill, conferidos em 30/10/2026.
|
|
49
49
|
|
|
50
|
-
**Como os números chegam (medido):** `amount_spent` vem como `{"value": "152.40", "unit": "BRL"}`: texto, já na moeda da conta (não é centavo). `results` vem como `{"indicator": "...", "value": "6"}` e, sem resultado, `"value": "Not available"`. `cost_per_result` igual
|
|
50
|
+
**Como os números chegam (medido em 30/10/2026):** `amount_spent` vem como `{"value": "152.40", "unit": "BRL"}`: texto, já na moeda da conta (não é centavo). `results` vem como `{"indicator": "...", "values": [{"attribution_windows": ["default"], "value": "6"}]}` (formato novo; o antigo era `{"indicator", "value"}`: aceite os dois, o número é o `value` do primeiro item de `values`, ou o `value` direto) e, sem resultado, `"value": "Not available"`. `cost_per_result` igual. Regra pros números de **gasto, vezes que apareceu, cliques e resultado**: converta pra número; `"Not available"`, vazio ou campo ausente = **0**. O `indicator` diz o tipo de resultado (ex.: `reach` = alcance, `...messaging_conversation_started...` = conversa iniciada, `...purchase...` = compra).
|
|
51
51
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
52
|
+
**Os números do funil são outra regra:** vêm como texto (`"454"`) ou `null`, e `omni_purchase_values` como `{"value", "unit"}`. Aqui **`null` = a Meta não mandou** e vai pro retrato como `null`, **nunca 0** (a aba diz "a Meta não mandou" em vez de mostrar um zero que ninguém mediu). Medido numa conta de loja: `omni_add_to_cart` veio `null` em tudo (o pixel não manda carrinho), `add_payment_info` não existe no catálogo (`payment` vai sempre `null`), e o 3 segundos (`3_second_video_plays`) só existe na conta, na campanha e no grupo, **não na peça**.
|
|
53
|
+
|
|
54
|
+
a) **Por peça, 7 dias:** `ads_get_ad_entities` com `level: "ad"`, `time_range` dos 7 dias, `fields: ["name","campaign_name","adset_name","adset_id","effective_status","amount_spent","impressions","clicks","results","updated_time","created_time","creative_id","cost_per_video_view","video_thruplay_watched_actions","link_click","landing_page_view","omni_purchase"]`. Funil da peça: `thruplay` = `video_thruplay_watched_actions`, `link_clicks` = `link_click`, `lpv` = `landing_page_view`, `purchases` = `omni_purchase`; `video_3s` = arredonde(gasto ÷ `cost_per_video_view`) (o `cost_per_video_view` é o custo de cada play de 3 s; a Meta não dá o 3 s por peça, então esta é a conta, com erro medido de ~2 % pelo arredondamento do custo), e `null` quando `cost_per_video_view` vier `null` (peça sem vídeo). Siga `pagination.next_cursor` até o fim (repetindo todos os outros parâmetros). **Campo ausente = 0**: peça sem gasto volta sem `amount_spent` e sem `impressions`, não com zero. O **gasto de cada grupo nos 7 dias** é a soma das peças dele (junte por `adset_id`, nunca pelo nome).
|
|
55
|
+
b) **Por campanha, 7 dias:** a mesma chamada com `level: "campaign"` e `fields: ["id","name","effective_status","objective","amount_spent","impressions","clicks","results","cost_per_result","reach","frequency","3_second_video_plays","video_thruplay_watched_actions","link_click","landing_page_view","omni_view_content","omni_add_to_cart","omni_initiated_checkout","omni_purchase","omni_purchase_values"]`, até a última página. **Os totais do retrato (`spend`, `impressions`, `clicks`, `results`) são a soma de TODAS as campanhas lidas**, não só das 10 que vão pro retrato.
|
|
56
|
+
**Funil da conta:** uma chamada com `level: "ad_account"`, o mesmo `time_range` e os mesmos campos do funil (`reach` … `omni_purchase_values`). Alcance e frequência **não se somam** entre campanhas (a mesma pessoa vê várias); por isso o funil da conta vem desse nível, não da soma.
|
|
57
|
+
**Tradução dos campos** (conta e campanha): `reach` = `reach`; `frequency` = `frequency`; `video_3s` = `3_second_video_plays`; `thruplay` = `video_thruplay_watched_actions`; `link_clicks` = `link_click`; `lpv` = `landing_page_view`; `view_content` = `omni_view_content`; `atc` = `omni_add_to_cart`; `ic` = `omni_initiated_checkout`; `payment` = `null`; `purchases` = `omni_purchase`; `revenue` = o `value` de `omni_purchase_values`.
|
|
58
|
+
c) **Por peça, 3 dias** (só pro alerta C): `level: "ad"`, `time_range` `'{"since":"<hoje − 2>","until":"<hoje>"}'`, `fields: ["name","campaign_name","adset_id","effective_status","amount_spent"]`, até a última página. O gasto do grupo nos 3 dias = soma das peças dele por `adset_id`. **Grupos, 7 dias:** `level: "adset"` com `fields: ["name","campaign_id","effective_status","optimization_goal"]`, até a última página. Serve pro rótulo do resultado e pra contar, **por campanha** (junte pelo `campaign_id` do grupo = o `id` da campanha, nunca pelo nome), quantos grupos ela tem (`adsets_total`) e quantos estão no ar (`adsets_active`: `effective_status` `ACTIVE`, `WITH_ISSUES`, `IN_PROCESS`, `PENDING_REVIEW` ou `PREAPPROVED`). Campanha `ACTIVE` com todos os grupos pausados não gasta: a aba mostra "parada: nenhum grupo no ar" com esses dois números. O **`result_label` de cada campanha** sai do `optimization_goal` dos grupos dela (a mesma tradução do rótulo da conta, abaixo): uma campanha de engajamento não pode aparecer na coluna de compras.
|
|
55
59
|
d) **Erros:** `ads_get_errors` com `entity_ids: ["<número da conta>"]` (traz os erros das peças dela).
|
|
56
|
-
e) **Texto das peças:** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title"]`.
|
|
60
|
+
e) **Texto e link das peças:** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title","link_url"]`. Se o `link_url` tiver `/products/<handle>`, o `<handle>` vai na peça como `product_handle` (letras minúsculas, números e hífen; até 60). Medido: criativo de vídeo costuma vir **sem** `link_url`; sem link, a peça fica sem `product_handle` e o site compara com o produto principal do projeto. Não chute o handle pelo nome da peça.
|
|
57
61
|
|
|
58
|
-
**Resultado** = o que a campanha busca (compra, conversa, cadastro): leia o `indicator` do `results`, o `objective` da campanha e o `optimization_goal` do grupo e escreva o rótulo em palavra de aluno ("compras", "conversas no WhatsApp", "cadastros"). Campanhas com tipos de resultado diferentes: some `results` mesmo assim e use "resultados" no rótulo, dizendo na resposta quais tipos entraram. Em dúvida, "resultados".
|
|
62
|
+
**Resultado** = o que a campanha busca (compra, conversa, cadastro): leia o `indicator` do `results`, o `objective` da campanha e o `optimization_goal` do grupo e escreva o rótulo em palavra de aluno ("compras no site", "conversas no WhatsApp", "cadastros", "engajamentos"; até 24 letras). Ele vale **por campanha** (`result_label` dela) e pra conta. Campanhas com tipos de resultado diferentes: some `results` mesmo assim e use "resultados" no rótulo, dizendo na resposta quais tipos entraram. Em dúvida, "resultados".
|
|
59
63
|
|
|
60
64
|
## 4. Os alertas
|
|
61
65
|
|
|
@@ -77,17 +81,23 @@ Cada alerta leva a peça, a campanha, o número que o sustenta (`detail`, até 1
|
|
|
77
81
|
`ads_status` com o `project_id` (o `id:` da linha `[loja: …]`) e o `snapshot`:
|
|
78
82
|
|
|
79
83
|
```json
|
|
80
|
-
{ "v":
|
|
84
|
+
{ "v": 2, "at": "<agora, ISO com fuso>", "account_id": "<número da conta>", "account_name": "<nome da conta, até 60>",
|
|
81
85
|
"currency": "<moeda da conta, 3 letras>", "window_days": 7,
|
|
82
|
-
"spend": 0, "impressions": 0, "clicks": 0, "results": 0, "result_label": "compras", "cpa": null,
|
|
83
|
-
"
|
|
84
|
-
"
|
|
86
|
+
"spend": 0, "impressions": 0, "clicks": 0, "results": 0, "result_label": "compras no site", "cpa": null,
|
|
87
|
+
"reach": null, "frequency": null, "video_3s": null, "thruplay": null, "link_clicks": null, "lpv": null,
|
|
88
|
+
"view_content": null, "atc": null, "ic": null, "payment": null, "purchases": null, "revenue": null,
|
|
89
|
+
"campaigns": [{ "name": "…", "status": "ACTIVE", "spend": 0, "impressions": 0, "results": 0, "result_label": "compras no site",
|
|
90
|
+
"adsets_active": 0, "adsets_total": 0, "reach": null, "frequency": null, "video_3s": null, "thruplay": null,
|
|
91
|
+
"link_clicks": null, "lpv": null, "view_content": null, "atc": null, "ic": null, "payment": null, "purchases": null, "revenue": null }],
|
|
92
|
+
"top_ads": [{ "name": "…", "campaign": "…", "spend": 0, "impressions": 0, "results": 0,
|
|
93
|
+
"video_3s": null, "thruplay": null, "link_clicks": null, "lpv": null, "purchases": null, "product_handle": "<opcional>" }],
|
|
85
94
|
"alerts": [{ "kind": "data_vencida", "ad": "…", "campaign": "…", "since": "<ISO, opcional>", "detail": "…", "action": "…" }],
|
|
86
95
|
"checked": { "ads": 0, "copy": 0, "art": false },
|
|
87
96
|
"ramp": [{ "ad": "…", "until": "<ISO>" }] }
|
|
88
97
|
```
|
|
89
98
|
|
|
90
|
-
-
|
|
99
|
+
- Os números do funil (no topo, em cada campanha e nas peças) são **planos** (número direto, nunca objeto dentro de objeto) e vão `null` quando a Meta não mandou: **campo que a Meta não mandou vai como `null`, nunca 0**.
|
|
100
|
+
- `campaigns`: até 10, as que gastaram mais primeiro. `status` = o `effective_status` como veio (`ACTIVE`, `PAUSED`, `ARCHIVED`, `CAMPAIGN_PAUSED`…): o site mostra `ACTIVE` como "no ar" (ou "parada: nenhum grupo no ar" / "no ar · N de M grupos", pela contagem abaixo) e o resto como "pausada". `adsets_active` e `adsets_total` = a contagem de grupos do passo (c) (campanha sem grupo lido: mande os dois em 0). `top_ads`: as 5 peças que mais gastaram. `alerts` e `ramp`: até 10 cada. `cpa` = gasto ÷ resultados (`null` sem resultado); o site compara o CPA máximo com **gasto ÷ compras** (`purchases`), nunca com esse `cpa`, porque resultados de objetivos diferentes (engajamento, conversa) não são venda. Cada campanha leva também as `impressions` dela (o site divide o "parou nos 3 s" só pelas campanhas com vídeo). `checked.ads` = peças medidas; `checked.copy` = peças com texto lido.
|
|
91
101
|
- Até 8 kB: nomes longos, encurte. Nome com telefone, e-mail ou `@perfil` chega no site como `[removido]` (o filtro protege o aluno); é esperado.
|
|
92
102
|
- A ferramenta recusou (`O site recusou o retrato: …`)? Corrija o que ela disse e mande de novo uma vez. Recusou de novo: responda os números no chat e diga que o retrato não foi gravado.
|
|
93
103
|
|
|
@@ -95,11 +105,15 @@ Na ficha: a linha Anúncios com a conta (se faltava) e 1 linha no Histórico: `A
|
|
|
95
105
|
|
|
96
106
|
## 6. Responder
|
|
97
107
|
|
|
98
|
-
|
|
108
|
+
Leia o `funil.md` (nesta pasta) antes de interpretar o funil.
|
|
109
|
+
|
|
110
|
+
Até 6 linhas:
|
|
99
111
|
1. "Últimos 7 dias: <gasto> e <N> <rótulo> (custo por resultado <valor>)."
|
|
100
|
-
2. "<N> alertas" ou "
|
|
101
|
-
3. "
|
|
102
|
-
4. "
|
|
112
|
+
2. "<N> alertas" ou "Nenhum alerta de peça hoje." (alerta é de peça: o funil e o CPA vêm nas linhas de baixo)
|
|
113
|
+
3. **Funil, 1 frase** com a régua do `funil.md`: o 1º degrau vermelho e o culpado, com o que fazer ("Vaza em 'parou nos 3 s': o criativo não segura nos primeiros segundos; teste outro começo de vídeo"), ou "o funil está dentro da régua", ou "ainda cedo pra julgar o funil" sem volume. Número que a Meta não mandou (ex.: carrinho) você diz que não veio, nunca que é zero. Nunca recomende pausar por causa do funil (pausar continua só com `ask`, pelos alertas).
|
|
114
|
+
4. **CPA:** se o `ads_status` devolveu `pricing`, repita a frase dele (CPA máximo × real e a leitura: sobra, paga a conta, prejuízo). Sem precificação: "Preencha a precificação na aba Anúncios pra eu comparar o seu CPA com o máximo."
|
|
115
|
+
5. "Conferi o texto de <N> peças; a arte não."
|
|
116
|
+
6. "O retrato está na aba Anúncios."
|
|
103
117
|
|
|
104
118
|
Com alerta, termine com o AGORA VOCÊ: o clique certo (no Gerenciador de Anúncios, a peça X → desligar) ou a oferta de pausar:
|
|
105
119
|
- `ask` "Quer que eu pause a peça <nome>?" (opções Sim / Não). Só no **Sim**: `ads_update_entity` com `entity_type: "ad"`, `entity_id` da peça, `fields: '{"status":"PAUSED"}'`. Não chame `ads_activate_entity` depois. Confira lendo de volta (`ads_get_ad_entities` `level: "ad"` com `object_ids` = a peça): só diga "pausada" se o `effective_status` voltou pausado. Depois do sim, tire o retrato de novo (passos 3 a 5) pra aba ficar certa.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Funil do anúncio: a régua (apoio da skill `anuncios`)
|
|
2
|
+
|
|
3
|
+
Leia antes de interpretar o funil do retrato. É a mesma régua que a aba Anúncios usa (o site calcula; aqui você explica).
|
|
4
|
+
Números de mercado de 2025/26, de fontes públicas (lista no fim). Exemplos numéricos marcados "exemplo" são inventados.
|
|
5
|
+
|
|
6
|
+
## Os 9 degraus, em palavras
|
|
7
|
+
|
|
8
|
+
| Degrau (na tela) | Conta | Ruim | Bom | Se estiver ruim, olhe |
|
|
9
|
+
|---|---|---|---|---|
|
|
10
|
+
| parou nos 3 s (hook) | 3 segundos ÷ vezes que apareceu | < 20 % | > 30 % | o criativo: os 3 primeiros segundos |
|
|
11
|
+
| ficou assistindo (hold) | ThruPlay ÷ 3 segundos | < 30 % | > 50 % | o criativo: o meio do vídeo |
|
|
12
|
+
| clicou no link (CTR de link) | cliques no link ÷ vezes que apareceu | < 1 % | > 2 % | o criativo: oferta e chamada |
|
|
13
|
+
| clique virou visita (LPV) | visitas da página ÷ cliques no link | < 70 % | > 85 % | página lenta, link quebrado, pixel |
|
|
14
|
+
| visita virou carrinho | carrinho ÷ visitas | < 4 % | > 8 % | a página e a oferta |
|
|
15
|
+
| carrinho virou checkout | checkout ÷ carrinho | < 25 % | > 40 % | carrinho e frete (surpresa no total) |
|
|
16
|
+
| checkout virou compra | compras ÷ checkout | < 35 % | > 50 % | checkout e confiança |
|
|
17
|
+
| compras por visita | compras ÷ visitas | < 0,8 % | > 1,5 % | a página e a oferta |
|
|
18
|
+
| vezes por pessoa (frequência) | média de vezes que cada pessoa viu | > 4 | < 2,5 | público cansado: troque o criativo |
|
|
19
|
+
|
|
20
|
+
Entre 'ruim' e 'bom' é atenção. Frequência é ao contrário: quanto maior, pior (no público frio).
|
|
21
|
+
|
|
22
|
+
## As 3 regras de leitura
|
|
23
|
+
|
|
24
|
+
1. **Só julga um degrau quando o de cima está bem.** Se "parou nos 3 s" está ruim, não adianta mexer na página: arrume o de cima primeiro. A aba deixa os degraus de baixo apagados ("arrume o de cima primeiro").
|
|
25
|
+
2. **Sem volume é "ainda cedo".** Com menos de 1.000 vezes que apareceu, os 3 primeiros degraus não se julgam; com menos de 5 compras, do carrinho pra baixo também não.
|
|
26
|
+
3. **A melhor régua é a da própria conta** (a mediana dos últimos 30 a 60 dias). Enquanto o Iron Office não guarda o histórico, vale a régua de mercado acima, dita como "régua do mercado".
|
|
27
|
+
|
|
28
|
+
## Os 5 culpados
|
|
29
|
+
|
|
30
|
+
- **criativo**: parou nos 3 s, ficou assistindo, clicou no link.
|
|
31
|
+
- **página e oferta**: clique virou visita, visita virou carrinho, compras por visita.
|
|
32
|
+
- **carrinho e frete**: carrinho virou checkout. O motivo nº 1 de abandono é custo extra que aparece só no fim (Baymard: 40 %).
|
|
33
|
+
- **checkout e confiança**: checkout virou compra. Cadastro obrigatório, checkout longo, poucos meios de pagamento, entrega lenta.
|
|
34
|
+
- **frequência (público cansado)**: vezes por pessoa alta, com o clique caindo. Troque o criativo antes de mexer no público.
|
|
35
|
+
|
|
36
|
+
Frase pro aluno: o 1º degrau vermelho e o culpado. Ex.: "Vaza em 'parou nos 3 s': o criativo não segura nos primeiros segundos."
|
|
37
|
+
Nunca recomende pausar por causa do funil: funil diz onde melhorar; pausar é decisão do aluno, pelos alertas, com `ask`.
|
|
38
|
+
|
|
39
|
+
## Quando o número não veio
|
|
40
|
+
|
|
41
|
+
`null` no retrato = a Meta não mandou (pixel que não envia carrinho, peça sem vídeo). Diga "a Meta não mandou o carrinho"; nunca trate como zero.
|
|
42
|
+
Carrinho `null` derruba 2 degraus (visita → carrinho e carrinho → checkout); "checkout virou compra" e "compras por visita" continuam valendo.
|
|
43
|
+
|
|
44
|
+
## As 10 coisas que o iniciante erra
|
|
45
|
+
|
|
46
|
+
1. **CTR "todos" não é CTR de link.** O "todos" conta curtida e clique no nome da página. Pra loja, vale o de link.
|
|
47
|
+
2. **Clique no link não é visita.** A visita só conta quando a página carrega e o pixel dispara. Cliques altos e visita zero: suspeite do pixel, depois da velocidade.
|
|
48
|
+
3. **O clique no link tem janela de 1 dia**; as compras, a janela do grupo (padrão 7 dias depois do clique + 1 dia depois de ver).
|
|
49
|
+
4. **A Meta e a Shopify nunca batem.** A Meta conta pela janela dela; a Shopify, pelo último clique. A Meta sempre mostra mais.
|
|
50
|
+
5. **Aprendizado ≈ 50 resultados em 7 dias por grupo.** Abaixo disso o custo oscila; mexer em público, lance ou objetivo recomeça.
|
|
51
|
+
6. **Frequência não tem limite oficial.** A régua acima é de mercado; leia junto com o CTR caindo.
|
|
52
|
+
7. **"Resultado" depende do objetivo do grupo.** Em tráfego é clique; em vendas é compra. Não compare custo por resultado de campanhas de objetivos diferentes.
|
|
53
|
+
8. **Hook e hold mudam de fórmula conforme a ferramenta.** Aqui: hook = 3 s ÷ vezes que apareceu; hold = ThruPlay ÷ 3 s.
|
|
54
|
+
9. **ThruPlay não é "assistiu tudo"**: é 15 s ou o fim, o que vier primeiro.
|
|
55
|
+
10. **Mediana não é média.** Média de blog costuma vir puxada por poucas lojas grandes (Littledata: mediana 1,4 %, média 1,9 % na mesma amostra).
|
|
56
|
+
|
|
57
|
+
## Precificação: quanto você pode pagar por venda
|
|
58
|
+
|
|
59
|
+
- **CPA máximo (empata)** = preço − custo do produto − frete − taxas. Acima dele, cada venda dá prejuízo.
|
|
60
|
+
- **CPA alvo** = CPA máximo − o lucro que você quer por venda.
|
|
61
|
+
- **ROAS de equilíbrio** = 1 ÷ margem de contribuição (em %). Exemplo: margem 35 % → 2,86.
|
|
62
|
+
- **ROAS alvo** = 1 ÷ (margem − lucro desejado). Exemplo: margem 54 %, lucro 20 % → 2,94.
|
|
63
|
+
|
|
64
|
+
**Contra entrega (COD):** o pedido não é a venda. Só entra dinheiro do que é entregue, e o frete de ida se paga em todo pedido despachado.
|
|
65
|
+
Por pedido gerado: CPA máximo = confirmação × entrega × (preço × (1 − taxas) − custo) − confirmação × frete − confirmação × (1 − entrega) × frete de devolução.
|
|
66
|
+
É a conta da calculadora de precificação (precificacaocod.club) e a da aba Anúncios.
|
|
67
|
+
Exemplo: preço 399, custo 150, frete 30, sem devolução, confirmação 75 %, entrega 70 %, taxas 2 % → CPA máximo ≈ 104.
|
|
68
|
+
|
|
69
|
+
Taxa de entrega de mercado (Colômbia, blogs ligados às plataformas, sem estudo independente): sem processo 50–60 %, média 60–68 %, operação séria 68–75 %.
|
|
70
|
+
A aba usa 65 % como "média de mercado" quando o aluno ainda não tem a dele. Subir a entrega de 65 % pra 75 % dá cerca de 15 % mais receita com o mesmo gasto (Andrey Business; o lucro sobe mais que isso, porque o frete de ida já estava pago).
|
|
71
|
+
|
|
72
|
+
Leitura do CPA real (7 dias, na moeda da conta):
|
|
73
|
+
- abaixo do alvo: **sobra**;
|
|
74
|
+
- entre o alvo e o máximo: **paga a conta, não paga você**;
|
|
75
|
+
- acima do máximo: **prejuízo**.
|
|
76
|
+
Loja e conta em moedas diferentes: só compara com o câmbio que o aluno digitou. Nunca invente câmbio.
|
|
77
|
+
|
|
78
|
+
## Fontes (públicas)
|
|
79
|
+
|
|
80
|
+
- Criativo (hook, hold, CTR, fadiga): https://runneth.com/library/research/creative-benchmarks-2026/ · https://motionapp.com/library/glossary/hold-rate · https://jetfuel.agency/creative-performance-metrics-for-dtc-video-ads-hold-rate-thumbstop-and-thruplay-benchmarks-2026/ · https://segwise.ai/blog/how-to-measure-creative-fatigue
|
|
81
|
+
- CTR e custo de e-commerce: https://www.triplewhale.com/blog/facebook-ads-benchmarks · https://www.wordstream.com/blog/facebook-ads-benchmarks-2025
|
|
82
|
+
- Site (visita, carrinho, checkout, compra): https://www.littledata.io/average/ecommerce-conversion-rate-(all-devices) · https://www.littledata.io/average/add-to-cart-rate-(all-devices) · https://www.littledata.io/average/checkout-completion-rate-(all-devices) · https://www.prax.ai/blog/benchmark-taxa-de-conversao
|
|
83
|
+
- Abandono e motivos: https://baymard.com/lists/cart-abandonment-rate
|
|
84
|
+
- Diagnóstico por degrau: https://adlibrary.com/posts/meta-ads-diagnostic-matrix · https://theadspend.com/blog/landing-page-views
|
|
85
|
+
- Cliques, atribuição e aprendizado: https://www.jonloomer.com/facebook-clicks/ · https://www.jonloomer.com/meta-ads-attribution-setting-a-complete-guide/ · https://portent.com/blog/paid-social/everything-you-need-to-know-about-facebooks-learning-phase.htm
|
|
86
|
+
- Precificação: https://www.triplewhale.com/blog/breakeven-roas · https://ecommerceguide.com/tools/break-even-roas-calculator/ · https://www.copyfy.io/en/tools/cpa-calculator
|
|
87
|
+
- Contra entrega: https://www.andreybusiness.com/blog/dropshipping-contraentrega-colombia-2026 · https://dropi.co/ar/dropshipping-cod/
|
package/skills/loja/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: loja
|
|
3
|
-
description: Ficha da loja no cofre. Use quando o aluno disser "começar com a loja", "começar com a loja <nome>", "ficha da loja", "monta a ficha", "atualiza a ficha da loja", ou quando uma mensagem do Iron Office chegar com "ficha: ainda sem ficha" e o pedido for sobre a loja (aí ofereça em 1 linha e só rode com o sim). Lê a Shopify da loja (se houver), aponta o que está errado, pergunta só o que falta, grava Projetos/<pasta>/PROJETO.md e brand.json no cofre sem apagar o que já existe, e manda um resumo curto pro site.
|
|
3
|
+
description: Ficha da loja no cofre. Use quando o aluno disser "começar com a loja", "começar com a loja <nome>", "ficha da loja", "monta a ficha", "atualiza a ficha da loja", "custos da loja" (o custo dos produtos na Shopify, seção "Custos da loja"), ou quando uma mensagem do Iron Office chegar com "ficha: ainda sem ficha" e o pedido for sobre a loja (aí ofereça em 1 linha e só rode com o sim). Lê a Shopify da loja (se houver), aponta o que está errado, pergunta só o que falta, grava Projetos/<pasta>/PROJETO.md e brand.json no cofre sem apagar o que já existe, e manda um resumo curto pro site.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# loja — a ficha da loja no cofre
|
|
@@ -146,6 +146,20 @@ AGORA VOCÊ
|
|
|
146
146
|
|
|
147
147
|
No máximo 5 passos, só ação dele.
|
|
148
148
|
|
|
149
|
+
## Custos da loja (pedido "custos da loja")
|
|
150
|
+
|
|
151
|
+
Serve pro CPA máximo da aba Anúncios: sem o custo do produto na Shopify, o Iron Office não sabe quanto o aluno pode pagar por venda. Roteiro próprio (não precisa dos passos 0 a 9):
|
|
152
|
+
|
|
153
|
+
**Custo** = quanto o aluno paga ao fornecedor por uma unidade do produto, na moeda da loja, sem frete e sem anúncio (frete e taxas entram na precificação da aba Anúncios).
|
|
154
|
+
|
|
155
|
+
1. **Ler.** `shop_query` com o `project_id` da loja: `{ shop { currencyCode } products(first: 50, query: "status:active") { nodes { title handle variants(first: 100) { nodes { title inventoryItem { id unitCost { amount } } } } } } }` (medido: 150 pontos de custo da Shopify numa loja de 4 produtos e 58 variantes, longe do teto de 1.000). Loja com mais de 50 produtos ativos: peça também `pageInfo { hasNextPage endCursor }` e siga com `after: "<endCursor>"` até o fim, senão o passo 5 diria "todos com custo" olhando só os 50 primeiros. Se a Shopify recusar por custo da consulta (`MAX_COST_EXCEEDED` ou "query cost"), repita com `first: 20` e pagine. Monte a lista: produto, custo atual (o da 1ª variante que tiver, ou "sem custo"), quantas variantes, e se as variantes já têm custos diferentes entre si.
|
|
156
|
+
2. **Pedir.** Uma mensagem pela `ask` com `free`: "Me diga o custo de cada produto em <moeda> (pode colar a lista: produto e valor)." Aceita lista colada, um por linha. Números: ponto seguido de 3 algarismos é milhar (`66.000` = sessenta e seis mil; `1.250.000` = um milhão e 250 mil); vírgula é centavo (`12,50`). `25,000` é ambíguo: pergunte. Produto que o aluno não citou fica como está. Produto cujas variantes já têm custos diferentes: pergunte se é um custo só pra todas ou um por variante antes de igualar.
|
|
157
|
+
3. **Confirmar.** Antes, anote na ficha (`Projetos/<pasta>/PROJETO.md`, seção Histórico) a tabela "produto · custo antigo → novo", pra dar pra voltar. Mostre a tabela do que vai gravar (produto · custo novo · quantas variantes) numa `ask` "Gravo esses custos na Shopify?" (Sim / Não). Só no **Sim**. Nada é gravado sem o sim (o site não tem trava pra isso: a regra é sua), e valor que você não entendeu vai pra pergunta, não pra tabela.
|
|
158
|
+
4. **Gravar.** Pra **cada variante** do produto confirmado, `shop_query` com o `project_id`: `mutation($id: ID!, $input: InventoryItemInput!) { inventoryItemUpdate(id: $id, input: $input) { inventoryItem { id unitCost { amount } } userErrors { field message } } }` com `{ "id": "<inventoryItem.id>", "input": { "cost": <número> } }`. O Iron Office só deixa passar o custo (`input` só com `cost`); rastreio, país de origem e o resto ficam na Shopify.
|
|
159
|
+
5. **Ler de volta.** Repita a consulta do passo 1 e confira variante por variante. Responda "N produtos com custo; faltam: <lista>" (ou "todos com custo"), e que a aba Anúncios já mostra o CPA máximo de cada um.
|
|
160
|
+
|
|
161
|
+
Se o `shop_query` recusar com "pelo Iron Office só dá pra mudar o custo do item", você mandou outro campo: tire e mande de novo só com `cost`. Se a Shopify responder `access denied` (ou falar em `write_inventory`), o app da loja não tem a permissão de estoque: diga ao aluno pra abrir o app no Dev Dashboard da Shopify, marcar `write_inventory` nas permissões, liberar a versão e reinstalar na loja, e não grave nada até lá.
|
|
162
|
+
|
|
149
163
|
## Exemplo (Loja Exemplo)
|
|
150
164
|
|
|
151
165
|
Pedido: `[loja: Loja Exemplo · Loja Shopify · id: … · ficha: ainda sem ficha]` "começar com a loja Loja Exemplo".
|