@egbe-ai/opencode 0.0.0-stage → 0.1.8
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/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- package/update.js +361 -0
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-google-ads
|
|
3
|
+
description: Inspect and operate Google Search campaigns, keywords, ads, targeting, budgets and conversion measurement through Egbe OS.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use for Google Search advertising and existing Google campaigns."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Google Ads"
|
|
8
|
+
egbe-description: "Run ads through Egbe. Reach customers through Google Search, manage campaigns and budgets, and measure signups and purchases."
|
|
9
|
+
egbe-category: "Marketing & growth"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Google Ads
|
|
57
|
+
|
|
58
|
+
Inspect and modify the selected Google Search objects through Egbe OS. Use the
|
|
59
|
+
requested configuration and exact owned IDs; a status read, edit or pause does
|
|
60
|
+
not require a campaign-planning package.
|
|
61
|
+
|
|
62
|
+
## Connection and account
|
|
63
|
+
|
|
64
|
+
Use `OS_URL` and `OS_API_KEY`; requests authenticate with
|
|
65
|
+
`Authorization: Bearer $OS_API_KEY`. Campaign management needs `ads` scope.
|
|
66
|
+
The [server conversions reference](references/server-conversions.md) describes
|
|
67
|
+
the narrower runtime `analytics` access. Never put the OS key in browser code
|
|
68
|
+
or project evidence; direct Google credentials are not needed.
|
|
69
|
+
|
|
70
|
+
Before new campaign setup, read the selected account. For work on existing
|
|
71
|
+
campaigns, list them and use their saved refs; new-account access is independent:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/ads/google/account" -s
|
|
75
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/ads/google/campaigns" -s
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
`GET /ads/google/account` checks access for new work and returns account
|
|
79
|
+
diagnostics in `data.raw` (customer id, currency, timezone, status). An explicit
|
|
80
|
+
Registry assignment takes priority. Without one, the shared Egbe account is
|
|
81
|
+
available only to approved owner emails. OS selects this server-side; customer
|
|
82
|
+
overrides are rejected and the caller cannot grant access by supplying an email.
|
|
83
|
+
|
|
84
|
+
- Success: continue the requested setup and planning with the returned account.
|
|
85
|
+
- `403` containing `google_ads_not_available`: tell the founder clearly, “New
|
|
86
|
+
Google advertising through Egbe is unavailable for this project.” They can use
|
|
87
|
+
their own Google Ads account through their own authorized tools/credentials,
|
|
88
|
+
or agree a manual account connection/assignment with Egbe. Having an MCC or
|
|
89
|
+
completing the Dashboard OAuth pilot alone does not assign an OS account.
|
|
90
|
+
Do not request a founder MCC as a prerequisite or promise automatic connection.
|
|
91
|
+
- Registry/provider `5xx`: report a temporary account-check failure, retry the
|
|
92
|
+
read later and escalate persistent failure to Egbe. This is not an access denial.
|
|
93
|
+
|
|
94
|
+
The restriction applies to selecting an account for new work, including keyword
|
|
95
|
+
ideas. It does not revoke existing campaign access. A denied account check must
|
|
96
|
+
not block an authorized read, edit, pause or saved-operation retry on an existing
|
|
97
|
+
campaign. Campaigns are in `data.campaigns`. Preserve the exact returned `ref`, shaped
|
|
98
|
+
`customer_id:campaign_id`; existing campaigns can belong to earlier assigned
|
|
99
|
+
accounts. Names are not ownership proof. For the selected campaign,
|
|
100
|
+
`GET /ads/google/campaigns/{ref}/account-settings` reads currency, timezone and
|
|
101
|
+
auto-tagging. Product agents cannot change shared-account auto-tagging; report
|
|
102
|
+
a needed change to Egbe, without requesting an admin key.
|
|
103
|
+
|
|
104
|
+
Other auth, ownership, configuration, quota and wallet errors block the affected
|
|
105
|
+
Egbe operation. Never use Egbe credentials, account overrides or raw provider
|
|
106
|
+
calls to bypass a restriction. A founder may separately authorize work through
|
|
107
|
+
their own tools and credentials; those are outside these OS endpoints. Keep
|
|
108
|
+
secrets out of chat, browser code and project evidence.
|
|
109
|
+
|
|
110
|
+
## Choose the operation
|
|
111
|
+
|
|
112
|
+
| Task | Read |
|
|
113
|
+
| --- | --- |
|
|
114
|
+
| Query keyword ideas and interpret their fields | [Keyword ideas](references/keyword-ideas.md) |
|
|
115
|
+
| Create a paused campaign; change targeting, budget or bids | [Campaigns](references/campaigns.md) |
|
|
116
|
+
| Create or edit groups, keywords, negatives and responsive search ads | [Search assets](references/search-assets.md) |
|
|
117
|
+
| Launch, pause, inspect serving state or repair child status | [Delivery](references/delivery.md) |
|
|
118
|
+
| Read performance, search terms, diagnostics and product attribution | [Reporting](references/reporting.md) |
|
|
119
|
+
| Configure browser/server conversion actions, goals or bidding; read action reports | [Conversions](references/conversions.md) |
|
|
120
|
+
| Deliver backend-confirmed outcomes and inspect receipts | [Server conversions](references/server-conversions.md) |
|
|
121
|
+
| Preserve authorized inputs, confirmed state or an unfinished operation | [Campaign records](references/artifacts.md) |
|
|
122
|
+
|
|
123
|
+
Read only the relevant references. Endpoint paths below are relative to OS;
|
|
124
|
+
`{ref}` always means the returned campaign ref, not just the campaign id.
|
|
125
|
+
Google does not support the generic Meta `/plan`, `/apply`, `/state` or
|
|
126
|
+
`/status` routes. Use Google's `/readback`, not raw `/query` or `/mutate`.
|
|
127
|
+
|
|
128
|
+
## Execution
|
|
129
|
+
|
|
130
|
+
Before a write, follow [Campaign records](references/artifacts.md): find existing
|
|
131
|
+
records by the exact campaign ref, or by the planned work before a ref exists.
|
|
132
|
+
Read recorded decisions and `pending_operation`; reconcile an unfinished
|
|
133
|
+
operation using its saved request/key and current provider state before starting
|
|
134
|
+
another. Do not replace unresolved input with a new operation.
|
|
135
|
+
|
|
136
|
+
Identify the exact targets, read current state and apply only the intended change.
|
|
137
|
+
Do not create real provider objects to test request syntax; use documented
|
|
138
|
+
schemas, local validation or an explicit provider validation facility.
|
|
139
|
+
Preserve unrelated settings and intentionally paused objects. Save recoverable
|
|
140
|
+
inputs before the call. Use the operation's retry rules: temporary caches, durable
|
|
141
|
+
receipts and desired-state assignments are not interchangeable.
|
|
142
|
+
|
|
143
|
+
OS already retries reads briefly when the ads service is restarting or
|
|
144
|
+
unreachable. A failure that remains has `data.upstream_status`, `data.retryable`
|
|
145
|
+
and `data.attempts`; `data.error: "upstream_unavailable"` means Egbe or Google
|
|
146
|
+
was temporarily unavailable, not that a campaign changed. Keep the last confirmed
|
|
147
|
+
state, re-read later and report persistent failure through support. A write that
|
|
148
|
+
ends in 502/503/504 has an unknown outcome: read the object back before repeating
|
|
149
|
+
it. Pause reports its own confirmation; see [Delivery](references/delivery.md).
|
|
150
|
+
|
|
151
|
+
Approval covers the exact write it describes. After a failed or rejected write,
|
|
152
|
+
reconcile an unknown outcome first, then retry without asking only with the same
|
|
153
|
+
approved inputs and as the operation's retry rules allow. If the fix changes the
|
|
154
|
+
target, payload, amount, keywords, ad text, status or another substantive input,
|
|
155
|
+
show the founder the failure and the proposed changed write and wait for fresh
|
|
156
|
+
explicit approval before sending it; a fix to request syntax alone is not a
|
|
157
|
+
substantive change.
|
|
158
|
+
|
|
159
|
+
Read back changed objects before reporting completion and preserve the useful
|
|
160
|
+
facts for continuation. Simple reads need no new artifacts; missing historical
|
|
161
|
+
research must not prevent an explicitly requested pause. Scheduling belongs to
|
|
162
|
+
the caller's runtime mechanism, not to this skill; do not claim monitoring or
|
|
163
|
+
a future stop is installed unless that mechanism confirms it.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# Campaign records and recovery
|
|
2
|
+
|
|
3
|
+
Keep the requested configuration, authorization context and evidence needed to
|
|
4
|
+
continue safely. Ordinary reads need no new files; a requested pause must not
|
|
5
|
+
wait for a reconstructed launch history.
|
|
6
|
+
|
|
7
|
+
## Locations and responsibilities
|
|
8
|
+
|
|
9
|
+
```text
|
|
10
|
+
egbe-docs/marketing/campaigns/google/<campaign-slug>/
|
|
11
|
+
campaign.json
|
|
12
|
+
results.md
|
|
13
|
+
evidence/
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Create these on demand, not as an empty bundle. Reference existing input records
|
|
17
|
+
rather than copying them or requiring a new planning document.
|
|
18
|
+
|
|
19
|
+
Through the Egbe connector without a project folder, keep these records at the
|
|
20
|
+
same paths in Egbe's artifact store, as `egbe-os-quickstart` →
|
|
21
|
+
`references/artifact-sync.md` ("Through the Egbe connector") describes. Save a
|
|
22
|
+
write's request record there before sending the write.
|
|
23
|
+
|
|
24
|
+
- campaign.json: object bindings, last significant confirmed provider state and
|
|
25
|
+
at most one unfinished agent-side campaign operation.
|
|
26
|
+
- results.md: observed build/launch result and later measurements, dates,
|
|
27
|
+
source/freshness, limitations and actual stop reason when known. No empty
|
|
28
|
+
report in advance.
|
|
29
|
+
- evidence/: useful request/readback snapshots or metric exports.
|
|
30
|
+
Small evidence may live in the main files; no journal of every GET.
|
|
31
|
+
|
|
32
|
+
Use one stable channel-qualified campaign slug for the folder and utm_campaign.
|
|
33
|
+
Do not invent experiment IDs or repurpose the slug as one. Campaign name/ref and
|
|
34
|
+
provider IDs are different identifiers; preserve the exact returned ref.
|
|
35
|
+
|
|
36
|
+
Existing project records remain evidence. Resolve an existing campaign by its
|
|
37
|
+
exact provider ref/ID, not a guessed name; ambiguous matches need clarification.
|
|
38
|
+
Do not rewrite or delete historical files merely to satisfy this layout.
|
|
39
|
+
|
|
40
|
+
## Minimal campaign.json
|
|
41
|
+
|
|
42
|
+
Example after an observed paused build; values are illustrative:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"channel": "google",
|
|
47
|
+
"campaign_slug": "google-search-001",
|
|
48
|
+
"product_slug": "product-slug",
|
|
49
|
+
"plan_path": "egbe-docs/marketing/campaigns/google/google-search-001/plan.md",
|
|
50
|
+
"account": {"customer_id": "1234567890", "currency": "USD", "time_zone": "Europe/London"},
|
|
51
|
+
"campaign_ref": "1234567890:456",
|
|
52
|
+
"objects": {
|
|
53
|
+
"ad_groups": [{"id": "789", "keyword_ids": ["111"], "ad_ids": ["222"]}]
|
|
54
|
+
},
|
|
55
|
+
"confirmed": {
|
|
56
|
+
"observed_at": "2026-10-27T12:00:00Z",
|
|
57
|
+
"source": "GET /ads/google/campaigns/1234567890:456/readback?expect=PAUSED",
|
|
58
|
+
"readback": {"campaign": {"id": "456", "customer_id": "1234567890", "status": "PAUSED"}}
|
|
59
|
+
},
|
|
60
|
+
"pending_operation": null
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
The required identity for a campaign record is channel and campaign_slug. Before
|
|
65
|
+
creation, campaign_ref and confirmed are null and objects may be empty. Populate
|
|
66
|
+
account from actual OS diagnostics; unknown currency/timezone stays unknown.
|
|
67
|
+
Once available, preserve the exact campaign_ref and ensure its customer/campaign
|
|
68
|
+
components agree with the recorded account and provider readback. A local record
|
|
69
|
+
does not establish server ownership.
|
|
70
|
+
|
|
71
|
+
Keep IDs needed for the task with their parent group, not an unscoped inventory.
|
|
72
|
+
Use negative_keyword_ids for relevant negative criteria, and conversion_refs or
|
|
73
|
+
restore_keys when conversion work creates values needed for continuation.
|
|
74
|
+
product_slug and plan_path are optional when not applicable or not known.
|
|
75
|
+
If supplied by the project, preserve immutable durable business_id, product_id,
|
|
76
|
+
launch_id, experiment_id and variant_id in an optional identity object. Do not
|
|
77
|
+
derive them from names or store caller orchestration identifiers here.
|
|
78
|
+
|
|
79
|
+
confirmed contains observed_at, the exact read source, and either the relevant
|
|
80
|
+
readback object or a project-relative readback_path. Preserve actual statuses,
|
|
81
|
+
delivery/drift, destinations, settings or amounts needed to verify that operation;
|
|
82
|
+
do not manufacture a universal projection or copy the entire desired plan.
|
|
83
|
+
The example is a campaign-only excerpt, not sufficient evidence of every
|
|
84
|
+
child's state. Use full or targeted evidence as needed for the actual change.
|
|
85
|
+
Never write planned state as confirmed or substitute a deadline for the actual
|
|
86
|
+
successful pause/readback time. Missing facts are unknown, not assumed defaults.
|
|
87
|
+
|
|
88
|
+
## Authorization context
|
|
89
|
+
|
|
90
|
+
Keep enough content to identify the authorized operation and exact materials,
|
|
91
|
+
source/time and boundaries alongside existing campaign notes. A source link to
|
|
92
|
+
an inaccessible chat alone is insufficient for a later agent to resume a write.
|
|
93
|
+
|
|
94
|
+
A snapshot/hash can bind exact inputs; it does not prove human approval.
|
|
95
|
+
Do not hash an entire mutable Markdown document as the only binding:
|
|
96
|
+
adding commentary does not change an approved ad. Changed substantive inputs
|
|
97
|
+
must remain distinguishable from earlier decisions.
|
|
98
|
+
|
|
99
|
+
## Recover one unfinished campaign operation
|
|
100
|
+
|
|
101
|
+
Agent-side changes to one campaign are sequential in this workflow. Before a
|
|
102
|
+
risky write, durably save pending_operation with:
|
|
103
|
+
|
|
104
|
+
- method and exact OS path/target;
|
|
105
|
+
- payload, or payload_path pointing to an immutable project-relative snapshot;
|
|
106
|
+
- idempotency_key only where the endpoint supports it;
|
|
107
|
+
- prepared_at with timezone;
|
|
108
|
+
- decision_ref to the relevant plan/notes and enough context to identify the
|
|
109
|
+
requested action, not only an inaccessible chat URL.
|
|
110
|
+
|
|
111
|
+
A hash without the actual request is insufficient for recovery. Preparing this
|
|
112
|
+
record is not proof the request was sent or executed. Do not overwrite it with
|
|
113
|
+
a new operation while the previous result remains uncertain.
|
|
114
|
+
|
|
115
|
+
After a response or recovery read, save confirmed IDs and provider readback
|
|
116
|
+
before clearing pending_operation. Preserve a needed operation key/restore key
|
|
117
|
+
after completion. If the result is unknown, keep the exact request/key and
|
|
118
|
+
diagnostic, inspect current provider state and follow that endpoint's own rules.
|
|
119
|
+
Some creates require Egbe reconciliation rather than a retry. Temporary caches
|
|
120
|
+
do not make a multi-step build atomic; do not replay uncertain batches blindly
|
|
121
|
+
or change keys to bypass them.
|
|
122
|
+
|
|
123
|
+
These records are campaign-management context in the product repository; follow
|
|
124
|
+
its ordinary synchronization workflow without requiring a commit after every
|
|
125
|
+
operation. Never include keys, tokens, cookies, private user data or credentials.
|
|
126
|
+
Do not copy raw responses wholesale without checking their content.
|
|
127
|
+
|
|
128
|
+
Per-user GCLIDs, product events, delivery intents and retry receipts belong to
|
|
129
|
+
the deployed product's existing durable runtime storage, not this repository
|
|
130
|
+
or campaign.json. See [Server conversions](server-conversions.md).
|
|
131
|
+
|
|
132
|
+
This layout is not automatically ingested into GTM Knowledge. Do not claim
|
|
133
|
+
central collection of these records.
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Campaign creation and settings
|
|
2
|
+
|
|
3
|
+
All paths use `/ads/google`. For a new campaign, first check `/account` as
|
|
4
|
+
described in the skill. For existing campaigns, use their saved refs and
|
|
5
|
+
campaign-specific account settings; a denied new-account check does not block
|
|
6
|
+
them. Keep settings changes scoped to the user's actual request.
|
|
7
|
+
|
|
8
|
+
## Create a paused Search shell
|
|
9
|
+
|
|
10
|
+
```http
|
|
11
|
+
POST /ads/google/campaigns
|
|
12
|
+
Idempotency-Key: <stable key for this creation>
|
|
13
|
+
Content-Type: application/json
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
```json
|
|
17
|
+
{
|
|
18
|
+
"name": "google-search-001",
|
|
19
|
+
"daily_budget_usd": 5,
|
|
20
|
+
"objective": "SEARCH",
|
|
21
|
+
"status": "PAUSED",
|
|
22
|
+
"product_slug": "product-slug"
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The amount is illustrative, not spending authorization. Creation requires a USD
|
|
27
|
+
account, configured mutation quota and wallet admission; no FX conversion is
|
|
28
|
+
performed. Use the stable campaign slug chosen for attribution. The provider creates Search with Manual CPC,
|
|
29
|
+
Google Search enabled and search-partner/display networks disabled. It creates
|
|
30
|
+
the budget and campaign separately, not as one atomic transaction. OS's generic
|
|
31
|
+
status field can echo the request; the actual shell is PAUSED. Verify provider
|
|
32
|
+
readback rather than treating that echo as truth.
|
|
33
|
+
|
|
34
|
+
Optional `product_slug` binds reusable conversion actions to the product;
|
|
35
|
+
it is not required for launch. Preserve `data.ref`, `customer_id` and
|
|
36
|
+
`campaign_id`. Never override the assigned customer.
|
|
37
|
+
|
|
38
|
+
Creation requires a stable Idempotency-Key. Reuse it with the identical payload;
|
|
39
|
+
a changed payload conflicts. The durable operation pins the original account.
|
|
40
|
+
If `google_campaign_create_outcome_unknown` is returned, stop for Egbe
|
|
41
|
+
reconciliation. Do not create a replacement with a new key. A timeout is not
|
|
42
|
+
proof that no budget or campaign was created.
|
|
43
|
+
|
|
44
|
+
Build serving objects with [Search assets](search-assets.md); use
|
|
45
|
+
[Delivery](delivery.md) for activation, pause and actual serving readback.
|
|
46
|
+
|
|
47
|
+
## Inspect and change targeting
|
|
48
|
+
|
|
49
|
+
```http
|
|
50
|
+
GET /ads/google/campaigns/{ref}/account-settings
|
|
51
|
+
GET /ads/google/campaigns/{ref}/targeting
|
|
52
|
+
GET /ads/google/campaigns/{ref}/diagnostics
|
|
53
|
+
PATCH /ads/google/campaigns/{ref}/targeting
|
|
54
|
+
Idempotency-Key: <stable key for this change>
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"language_ids": ["1000"],
|
|
60
|
+
"location_ids": ["2840"],
|
|
61
|
+
"positive_geo_target_type": "PRESENCE",
|
|
62
|
+
"networks": {"google_search": true, "search_partners": false, "display": false}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
This example selects English/US; it is not a targeting recommendation.
|
|
67
|
+
IDs are numeric Google constants, not full resource names. Supplied lists
|
|
68
|
+
replace that category; omitted fields remain unchanged, while explicit null
|
|
69
|
+
is invalid. `excluded_location_ids: []` clears exclusions. Positive location
|
|
70
|
+
and language lists cannot be empty, include/exclude sets cannot overlap and
|
|
71
|
+
IDs must be unique. Limits: 20 languages, 100 included and 100 excluded locations.
|
|
72
|
+
|
|
73
|
+
A supplied networks object sets all three switches and disables the separate
|
|
74
|
+
partner-search network; `google_search` must be true for Search. Other
|
|
75
|
+
criteria, status, bids and budget stay unchanged. PRESENCE excludes interest
|
|
76
|
+
targeting, but includes people in or regularly in the location; it is not a
|
|
77
|
+
precise physical-location guarantee.
|
|
78
|
+
|
|
79
|
+
Inspect `data.verified` and returned configuration. Retry an interrupted
|
|
80
|
+
operation with the same key and payload. On an uncertain outcome or drift,
|
|
81
|
+
inspect readback and the diagnostic; do not recreate criteria or change keys
|
|
82
|
+
to bypass it.
|
|
83
|
+
|
|
84
|
+
## Change only the daily budget
|
|
85
|
+
|
|
86
|
+
```http
|
|
87
|
+
POST /ads/google/campaigns/{ref}/search-assets
|
|
88
|
+
Idempotency-Key: <distinct key for this campaign and intentional change>
|
|
89
|
+
Content-Type: application/json
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
```json
|
|
93
|
+
{"daily_budget_usd": 4.5}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Omit `geoTargets` and `adGroups`: supplying them can create assets. This
|
|
97
|
+
updates only the existing budget amount; it does not launch, alter statuses,
|
|
98
|
+
bids or targeting, or create a budget. The amount must be authorized, including
|
|
99
|
+
a reduction. The current budget must belong to this campaign and be used by
|
|
100
|
+
exactly one campaign. `explicitly_shared=true` alone is not proof of multiple
|
|
101
|
+
current users. Concurrent provider-side reassignments cannot be made atomic
|
|
102
|
+
by this API.
|
|
103
|
+
|
|
104
|
+
Current writes require USD, an explicit mutation quota, configured amount limits
|
|
105
|
+
and wallet admission. The wallet reserves twice the requested daily budget
|
|
106
|
+
using the existing budget asset key; even a reduction can fail admission.
|
|
107
|
+
This is not a top-up or permission to spend more.
|
|
108
|
+
|
|
109
|
+
The successful-response cache is temporary (default 15 minutes), process-local
|
|
110
|
+
and keyed by key AND payload; changed payload is a cache miss, not a durable
|
|
111
|
+
conflict check. Concurrent calls, expiry, restart or failure after mutation can
|
|
112
|
+
escape it. Do not send parallel copies or replay an old budget instruction.
|
|
113
|
+
After uncertainty, inspect the current budget and reconcile before another write.
|
|
114
|
+
|
|
115
|
+
Inspect `data.raw.readback.campaign.daily_budget`, currency and unchanged
|
|
116
|
+
statuses, then obtain fresh `/children` or `/readback`. A cached response is
|
|
117
|
+
historical, not fresh verification; HTTP 200 alone proves neither the requested
|
|
118
|
+
amount nor current configuration.
|
|
119
|
+
|
|
120
|
+
## Change existing Manual CPC bids
|
|
121
|
+
|
|
122
|
+
```http
|
|
123
|
+
PATCH /ads/google/campaigns/{ref}/bids
|
|
124
|
+
Idempotency-Key: <stable key for this bid change>
|
|
125
|
+
Content-Type: application/json
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
```json
|
|
129
|
+
{
|
|
130
|
+
"ad_groups": [{"id": "789", "cpc_bid_micros": 2500000}],
|
|
131
|
+
"keywords": [{"ad_group_id": "789", "criterion_id": "111", "cpc_bid_micros": null}]
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Read `/diagnostics` first. A group default does not replace explicit keyword
|
|
136
|
+
overrides; inherited keywords follow a changed group. Null clears a keyword
|
|
137
|
+
override to inherit; group bids cannot be null. Omitted targets keep their
|
|
138
|
+
configured bids. Supply at least one target, no duplicates, at most 100 groups
|
|
139
|
+
and 500 keywords. Positive bids are integer account-currency micros; 2500000
|
|
140
|
+
means $2.50 in USD, not an instruction to use that amount.
|
|
141
|
+
|
|
142
|
+
Configured gateway minimum/maximum CPC guardrails still apply to explicit bids.
|
|
143
|
+
If a bound rejects the requested amount, report that constraint; do not raise
|
|
144
|
+
the bid or substitute the historical high-range metric without a new decision.
|
|
145
|
+
|
|
146
|
+
This operation supports Manual CPC Search in USD accounts. It atomically changes
|
|
147
|
+
only the requested bids, not strategy, budget, statuses or targeting, and creates
|
|
148
|
+
nothing. Inspect `verified`, configured/effective CPC and its source. Retry the
|
|
149
|
+
same key/payload after interruption; inspect drift before a new intentional
|
|
150
|
+
change, never recreate groups or keywords. Higher bids can increase spend within
|
|
151
|
+
the existing campaign budget. Preserve the confirmed change timestamp so later
|
|
152
|
+
reports can distinguish observations before and after the change.
|
|
153
|
+
|
|
154
|
+
Readbacks label `currency_code` alongside money. Legacy `*_usd` values are
|
|
155
|
+
populated only for USD accounts; do not relabel other currencies or bypass
|
|
156
|
+
wallet/quota errors with provider/admin credentials. An inherited/unavailable
|
|
157
|
+
bid is not zero, and a configured base bid is not the average auction price.
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
# Conversion actions, goals and reports
|
|
2
|
+
|
|
3
|
+
Conversion measurement is optional for an ordinary CPC campaign. Creating an
|
|
4
|
+
action, choosing campaign goals and changing bidding are separate operations.
|
|
5
|
+
Use only the operation requested; action configuration is not event delivery,
|
|
6
|
+
attribution, reliable training data or permission to launch.
|
|
7
|
+
|
|
8
|
+
## Choose or create an owned action
|
|
9
|
+
|
|
10
|
+
```http
|
|
11
|
+
GET /ads/google/conversion-actions?offset=0&limit=20
|
|
12
|
+
GET /ads/google/conversion-actions/{conversion_ref}
|
|
13
|
+
POST /ads/google/conversion-actions
|
|
14
|
+
Idempotency-Key: <stable key for this creation>
|
|
15
|
+
Content-Type: application/json
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
{
|
|
20
|
+
"campaign_ref":"1234567890:456",
|
|
21
|
+
"name":"Account signup",
|
|
22
|
+
"delivery_method":"browser",
|
|
23
|
+
"category":"SIGNUP",
|
|
24
|
+
"counting_type":"ONE_PER_CLICK"
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
List pagination has offset >=0 and limit 1–100. Reuse an appropriate owned action;
|
|
29
|
+
do not adopt unregistered account-wide actions by name. The campaign ref selects
|
|
30
|
+
its authoritative conversion account and product. A paused shell suffices and
|
|
31
|
+
is not modified. Optional product_slug at campaign creation binds actions for
|
|
32
|
+
reuse across that product. Older campaigns without it have exact-campaign
|
|
33
|
+
binding; do not silently broaden it.
|
|
34
|
+
|
|
35
|
+
Supported categories: SIGNUP, PURCHASE, SUBMIT_LEAD_FORM, CONTACT. Browser
|
|
36
|
+
(default) creates WEBPAGE; server creates UPLOAD_CLICKS. Counting is ONE_PER_CLICK
|
|
37
|
+
or MANY_PER_CLICK. Optional default_value and uppercase three-letter currency
|
|
38
|
+
must be paired, with nonnegative finite value. Choose the actual outcome and
|
|
39
|
+
counting behavior, not a UI click presented as a completed purchase.
|
|
40
|
+
|
|
41
|
+
Read `data.ref`, `resource` and `tag`. Browser tag includes ready,
|
|
42
|
+
conversion_id (AW-…), conversion_label, send_to and provider snippets. Use
|
|
43
|
+
returned values, not a tag ID derived from customer/action ID. Missing/ambiguous
|
|
44
|
+
snippets are an integration blocker. The friendly name is stored by OS; the
|
|
45
|
+
provider uses a recovery name. Server actions have tag=null intentionally; use
|
|
46
|
+
[Server conversions](server-conversions.md) for delivery.
|
|
47
|
+
|
|
48
|
+
New actions are secondary (primary_for_goal=false), so they do not silently
|
|
49
|
+
enter account-wide bidding. Without explicit campaign goal selection, tracking
|
|
50
|
+
typically appears in All conversions, not primary Conversions. This is not
|
|
51
|
+
evidence of broken tracking.
|
|
52
|
+
|
|
53
|
+
## Connect a browser event
|
|
54
|
+
|
|
55
|
+
Continue the product's existing Google tag and consent setup. Initialize the
|
|
56
|
+
returned tag once and send its exact send_to only on the confirmed successful
|
|
57
|
+
outcome: account creation, verified payment, or the actual selected event.
|
|
58
|
+
Do not duplicate on refresh/re-render or send on failed attempts. Use a stable
|
|
59
|
+
non-PII transaction ID for an outcome where appropriate.
|
|
60
|
+
|
|
61
|
+
Tag ID/label are public browser configuration; OS keys, auth tokens, emails and
|
|
62
|
+
other personal data do not belong in the event payload. Check successful and
|
|
63
|
+
failed paths separately. Browser dispatch is not proof of Google attribution;
|
|
64
|
+
reporting can lag. Do not poll/retry indefinitely waiting for a test event.
|
|
65
|
+
|
|
66
|
+
A browser signup and server purchase can coexist. Do not report the same outcome
|
|
67
|
+
to two different actions and select both in goals: transaction deduplication does
|
|
68
|
+
not span actions. Do not replace an existing browser action automatically.
|
|
69
|
+
|
|
70
|
+
## Inspect readiness and select goals
|
|
71
|
+
|
|
72
|
+
```http
|
|
73
|
+
GET /ads/google/campaigns/{ref}/conversion-readiness
|
|
74
|
+
GET /ads/google/campaigns/{ref}/conversion-optimization
|
|
75
|
+
POST /ads/google/campaigns/{ref}/conversion-optimization
|
|
76
|
+
Idempotency-Key: <stable key for this goal change>
|
|
77
|
+
Content-Type: application/json
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{"mode":"select_goals","conversion_actions":["1234567890:77"]}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Readiness is in `data.raw` and includes only Registry-owned actions in the
|
|
85
|
+
campaign's product/exact-campaign binding and authoritative conversion account.
|
|
86
|
+
configured=true requires an ENABLED owned action. configuration_only=true means
|
|
87
|
+
it does not prove goal selection or event delivery. No action is not a blocker
|
|
88
|
+
for CPC advertising.
|
|
89
|
+
|
|
90
|
+
Always set mode explicitly. select_goals binds a campaign-specific custom goal
|
|
91
|
+
to the exact selected enabled actions and excludes other standard campaign goals.
|
|
92
|
+
It does not change bidding, budget, status, account defaults or global primary
|
|
93
|
+
flags. A secondary action in this custom goal can contribute to Conversions;
|
|
94
|
+
it is no longer necessarily limited to All conversions. This does not turn
|
|
95
|
+
Manual CPC into smart bidding.
|
|
96
|
+
|
|
97
|
+
## Change conversion bidding or restore
|
|
98
|
+
|
|
99
|
+
Use the same POST endpoint with an explicit intended mode:
|
|
100
|
+
|
|
101
|
+
```json
|
|
102
|
+
{"mode":"maximize_conversions","conversion_actions":["1234567890:77"]}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
This selects the owned actions via a custom goal, excludes other campaign goals
|
|
106
|
+
and switches to Maximize Conversions. It does not launch or change budget/status
|
|
107
|
+
or account defaults. Both browser and server actions can be selected. The
|
|
108
|
+
current supported starting strategies are standard Manual CPC, Maximize Clicks
|
|
109
|
+
(TARGET_SPEND) and Maximize Conversions on Search; portfolio strategies are not
|
|
110
|
+
supported. Selecting goals/configuring bidding does not prove tracking is usable.
|
|
111
|
+
|
|
112
|
+
Read the returned state and verified field, then GET conversion-optimization.
|
|
113
|
+
Retain the returned restore_key. To undo, send a new idempotent request:
|
|
114
|
+
|
|
115
|
+
```json
|
|
116
|
+
{"mode":"restore","restore_key":"<key of the completed change>"}
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Restore uses the saved previous configuration, not an assumed default.
|
|
120
|
+
Restoring select_goals restores only goals, preserving later bid changes.
|
|
121
|
+
Restoring a bidding change includes its saved bidding configuration. Concurrent
|
|
122
|
+
or newer configuration/goal-inventory changes conflict rather than being silently
|
|
123
|
+
overwritten. verified confirms configuration readback, not conversions or
|
|
124
|
+
sufficient learning.
|
|
125
|
+
|
|
126
|
+
## Report an exact action
|
|
127
|
+
|
|
128
|
+
```http
|
|
129
|
+
GET /ads/google/campaigns/{ref}/conversion-report?conversion_ref=1234567890:77&date_from=2026-01-01&date_to=2026-01-31&date_basis=interaction
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Dates are inclusive in the returned account timezone, at most 366 days and cannot
|
|
133
|
+
end in the future. interaction attributes to the ad interaction date; conversion
|
|
134
|
+
uses the outcome date. The report is for the exact owned action, not all actions.
|
|
135
|
+
Both conversions and all_conversions follow Google's goal/attribution rules;
|
|
136
|
+
counts can be fractional, and neither is all product registrations.
|
|
137
|
+
|
|
138
|
+
data_status=available can contain actual reported zeros. no_rows means no rows,
|
|
139
|
+
with null metrics; unavailable means expected metrics are missing. Failed queries
|
|
140
|
+
stay errors. retrieved_at is completion time, not a freshness watermark; lag and
|
|
141
|
+
attribution revisions are possible. Do not infer broken tracking from a recent
|
|
142
|
+
empty report or wait indefinitely for a test event.
|
|
143
|
+
|
|
144
|
+
## Retry and retention
|
|
145
|
+
|
|
146
|
+
Creation and optimization require Idempotency-Key. Reuse the identical key/body
|
|
147
|
+
after a timeout; changing payload under a key returns 409. Completed operations
|
|
148
|
+
with later drift are not silently reapplied. Inspect current state and use a
|
|
149
|
+
new key only for an intentional new change.
|
|
150
|
+
|
|
151
|
+
For provider_create_outcome_unconfirmed, retry the same key for readback; if
|
|
152
|
+
still unknown, request Egbe reconciliation, not a replacement with a new key.
|
|
153
|
+
Actions/custom goals are retained with archived campaigns.
|