@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,30 @@
|
|
|
1
|
+
# LinkedIn destination requirements
|
|
2
|
+
|
|
3
|
+
Use for the LinkedIn paths in a destination review, independently of account,
|
|
4
|
+
campaign and conversion readiness. Reuse the common journey evidence.
|
|
5
|
+
|
|
6
|
+
For a complete visitor-path review, apply the `egbe-os-destination-readiness` skill with
|
|
7
|
+
this reference in one audit run. If missing locally, its full bundle is available
|
|
8
|
+
at `GET $OS_URL/skills/destination-readiness`.
|
|
9
|
+
|
|
10
|
+
Source: [LinkedIn Advertising Policies](https://www.linkedin.com/legal/ads-policy),
|
|
11
|
+
sections 4 and 6; checked 2026-09-29. Read current wording for a policy finding.
|
|
12
|
+
|
|
13
|
+
- **Offer and identity:** the product must match the ad; advertised prices,
|
|
14
|
+
discounts and offers must be easy to find from its link. Identify unsupported
|
|
15
|
+
affiliation or confusing brand transitions without treating an explained
|
|
16
|
+
parent/provider identity as an error.
|
|
17
|
+
- **Link behavior:** the display and destination domains must match, and members
|
|
18
|
+
must reach the same destination/landing page from the ad. Inspect unexpected
|
|
19
|
+
redirects, landing-triggered pop-ups and whether Back/navigation works. A
|
|
20
|
+
deliberate later booking/checkout link is a separate journey step.
|
|
21
|
+
- **Collection security:** LinkedIn requires HTTPS for sensitive information,
|
|
22
|
+
including login, financial and specified personal information. Inspect the
|
|
23
|
+
applicable collection step, not merely the initial page's certificate.
|
|
24
|
+
- **Privacy:** where cross-site tracking is actually observed, assess disclosure
|
|
25
|
+
and consent against section 6. Do not infer it from the absence of a cookie
|
|
26
|
+
banner or audit whether conversion instrumentation is installed correctly.
|
|
27
|
+
|
|
28
|
+
For each issue return the affected path, exact observation, policy section and
|
|
29
|
+
smallest repair with a recheck condition. An inaccessible region or browser
|
|
30
|
+
variant remains unverified; successful inspection is not LinkedIn approval.
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# LinkedIn OS API
|
|
2
|
+
|
|
3
|
+
Base `$OS_URL/ads/linkedin`, bearer `$OS_API_KEY`; provider tokens stay in OS.
|
|
4
|
+
Writes require `Idempotency-Key` (1–128 characters). Same key and changed payload
|
|
5
|
+
is 409. Responses use the OS envelope; inspect data, not only HTTP 200.
|
|
6
|
+
|
|
7
|
+
## Read and discovery
|
|
8
|
+
|
|
9
|
+
- `GET /account`, `GET /readiness`.
|
|
10
|
+
- `GET /targeting/facets`.
|
|
11
|
+
- `GET /targeting/entities?facet=locations&query=United%20States&language=en&country=US`.
|
|
12
|
+
Searchable facets require `query`; `entity_type` is optional and should only
|
|
13
|
+
be supplied when supported by provider facet metadata.
|
|
14
|
+
- `GET /targeting/entities?facet=seniorities` also works for `jobFunctions` and
|
|
15
|
+
`staffCountRanges`: returns the facet's options via `adTargetingFacet` rather
|
|
16
|
+
than typeahead. Omit `query` and `entity_type` for these listings. No mutation
|
|
17
|
+
occurs. [Provider targeting contract](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/advertising-targeting/ads-targeting).
|
|
18
|
+
- `POST /audience-estimate`: `{"targeting":{"include":{"locations":["urn:li:geo:<resolved-id>"]}}}`.
|
|
19
|
+
- `POST /budget-pricing`: same targeting plus `format` and `daily_budget_usd`;
|
|
20
|
+
provider returns minimum/maximum/suggested bid and daily-budget limits.
|
|
21
|
+
- `GET /campaign-groups`, `/campaigns`, `/creatives`, `/images`:
|
|
22
|
+
owned only, `offset=0&limit=20`, follow next_offset until null.
|
|
23
|
+
- `GET /<collection>/<id>`; `GET /creatives/<id>/content` resolves its owned
|
|
24
|
+
Sponsored Content reference. IDs are numeric strings except image URNs.
|
|
25
|
+
Inspect raw resource fields including moderation and serving reasons.
|
|
26
|
+
|
|
27
|
+
## Create a group
|
|
28
|
+
|
|
29
|
+
`POST /campaign-groups`:
|
|
30
|
+
|
|
31
|
+
```json
|
|
32
|
+
{"product_slug":"example-product","name":"LinkedIn pilot","schedule":{"start":1800000000000}}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Schedule values are Unix milliseconds. Use actual approved timestamps, not this
|
|
36
|
+
example. Groups have no shared budget; each native campaign owns its budget.
|
|
37
|
+
OS creates groups in DRAFT (non-serving); there is no caller status field.
|
|
38
|
+
LinkedIn permits initial ACTIVE or DRAFT, not PAUSED. Launch is a separate,
|
|
39
|
+
explicitly authorized operation. [Provider group lifecycle](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaign-groups).
|
|
40
|
+
|
|
41
|
+
## Create a campaign
|
|
42
|
+
|
|
43
|
+
`POST /campaigns`:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"group_id":"123",
|
|
48
|
+
"name":"LinkedIn pilot — image",
|
|
49
|
+
"format":"SINGLE_IMAGE",
|
|
50
|
+
"daily_budget_usd":30,
|
|
51
|
+
"cpc_bid_usd":3,
|
|
52
|
+
"locale":{"language":"en","country":"US"},
|
|
53
|
+
"targeting":{"include":{"locations":["urn:li:geo:103644278"]},"exclude":{}},
|
|
54
|
+
"schedule":{"start":1800000000000}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Illustrative IDs must be resolved/owned. format: SINGLE_IMAGE or TEXT_AD.
|
|
59
|
+
Created status is DRAFT, including beneath a DRAFT group; launch is separate.
|
|
60
|
+
WEBSITE_VISIT/manual CPC, no expansion/offsite delivery.
|
|
61
|
+
USD amounts are decimal dollars, not micros; non-USD accounts are rejected.
|
|
62
|
+
`PATCH /campaigns/{id}` accepts only changed name, daily_budget_usd, cpc_bid_usd,
|
|
63
|
+
targeting or schedule; omit unchanged fields, don't send null. Targeting is a full
|
|
64
|
+
replacement. No hidden account-wide changes or budget increases.
|
|
65
|
+
|
|
66
|
+
## Upload and create creative
|
|
67
|
+
|
|
68
|
+
`POST /images`: `{"product_slug":"example-product","image_base64":"<base64 PNG/JPEG>"}`.
|
|
69
|
+
Maximum 5 MB decoded; no data URI. Through the Egbe connector (`egbe_write`), or
|
|
70
|
+
when the image is already at a public HTTPS URL, send `"image_url":"https://..."`
|
|
71
|
+
instead of `image_base64` and OS downloads it. A connector message carries at
|
|
72
|
+
most 1 MiB, so store a larger local image with an upload session first:
|
|
73
|
+
`POST /uploads` `{"filename","content_type","size"}` returns `data.upload_id`;
|
|
74
|
+
send the bytes in order as `POST /uploads/{upload_id}/parts`
|
|
75
|
+
`{"content_base64":"<at most 512000 bytes>","offset":<data.received_bytes>}`;
|
|
76
|
+
`POST /uploads/{upload_id}/complete` returns a public `data.url` for `image_url`. Save the returned image URN,
|
|
77
|
+
then GET until AVAILABLE before using it. Signed upload URLs remain internal.
|
|
78
|
+
|
|
79
|
+
`POST /creatives`:
|
|
80
|
+
|
|
81
|
+
```json
|
|
82
|
+
{"campaign_id":"456","name":"Benefit variant A","image_id":"urn:li:image:<uploaded-id>","headline":"A useful product","text":"A concrete benefit.","destination_url":"https://your-product.example/path?utm_source=linkedin&utm_medium=paid_social&utm_campaign=linkedin-pilot&utm_content=benefit-a","cta":"LEARN_MORE"}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Image and campaign must belong to the same product. For Text Ad: headline≤25,
|
|
86
|
+
text≤75; for Single Image gateway bounds are headline≤200, text≤3000.
|
|
87
|
+
OS sets `intendedStatus=DRAFT` for both formats; there is no caller status field.
|
|
88
|
+
CTA: LEARN_MORE, SIGN_UP, DOWNLOAD, REGISTER, REQUEST_DEMO (Single Image only).
|
|
89
|
+
`PATCH /creatives/{id}` accepts changed `name` for both formats, and optional
|
|
90
|
+
`headline`, `text`, `image_id`, `destination_url` for Text Ads (same Text limits).
|
|
91
|
+
Omitted fields and delivery status are preserved. Single Image copy/media changes
|
|
92
|
+
return 409 and require an explicitly approved replacement, not implicit duplication.
|
|
93
|
+
|
|
94
|
+
## Delivery and reports
|
|
95
|
+
|
|
96
|
+
`POST /campaign-groups/{id}/launch|pause`,
|
|
97
|
+
`POST /campaigns/{id}/launch|pause`,
|
|
98
|
+
`POST /creatives/{id}/launch|pause`; no body, Idempotency-Key required.
|
|
99
|
+
Follow launch workflow for parent order and wallet authorization.
|
|
100
|
+
|
|
101
|
+
`GET /campaigns/{id}/results?date_from=2026-09-01&date_to=2026-09-11`:
|
|
102
|
+
inclusive UTC dates, today allowed, at most 366 days per request.
|
|
103
|
+
Returns campaign_id, dates, currency, metrics (impressions/clicks/spend decimal
|
|
104
|
+
in account currency), raw data, observed_ranges, data_status, fetched_at and
|
|
105
|
+
freshness. Not a conversion report.
|
|
106
|
+
|
|
107
|
+
## Optional conversions
|
|
108
|
+
|
|
109
|
+
- POST `/conversion-rules`: `{"campaign_id":"456","name":"Signup","method":"CONVERSIONS_API","type":"SIGN_UP"}`.
|
|
110
|
+
Method INSIGHT_TAG creates an event-specific browser rule; no URL rules.
|
|
111
|
+
Optional attribution_type: LAST_TOUCH_BY_CONVERSION (default) or
|
|
112
|
+
LAST_TOUCH_BY_CAMPAIGN; post_click_days=30 and view_through_days=7, each 1/7/30.
|
|
113
|
+
Creation does not associate or activate campaigns.
|
|
114
|
+
- GET `/conversion-rules` (owned, offset/limit); GET `/conversion-rules/{id}`.
|
|
115
|
+
- PATCH `/conversion-rules/{id}`: changed name, enabled, post_click_days,
|
|
116
|
+
view_through_days, attribution_type only. Method/product identity are immutable.
|
|
117
|
+
- GET `/conversion-rules/{id}/browser-tag`: owned browser rule + existing
|
|
118
|
+
public Insight Tag and event_id_prefix, not shared account/domain management.
|
|
119
|
+
- GET/PUT/DELETE `/campaigns/{campaign_id}/conversion-rules/{id}`: inspect,
|
|
120
|
+
attach or detach one same-product pair. No request body; writes require key.
|
|
121
|
+
- POST `/conversion-events`: `{"conversion_id":"789","event_id":"signup:opaque-id","happened_at":1800000000000,"email_sha256":"<64 lowercase hex characters>"}`.
|
|
122
|
+
Replace example time/identity with a real outcome within the past 90 days.
|
|
123
|
+
Optional linkedin_tracking_uuid, value ({currency_code, amount}), validate_only.
|
|
124
|
+
At least one genuine matching identifier is required. See the conversions
|
|
125
|
+
workflow for hooks, prefix/dedupe, retries and privacy.
|
|
126
|
+
- GET `/conversion-events/{receipt_id}`: durable delivery status, not a
|
|
127
|
+
provider attribution lookup. Management is ads-only; rule GET and event
|
|
128
|
+
send/receipt GET also accept analytics for deployed product credentials.
|
|
129
|
+
- GET `/campaigns/{campaign_id}/conversion-rules/{id}/results`: explicit
|
|
130
|
+
date_from/date_to, inclusive UTC, at most 366 days. String decimal counts
|
|
131
|
+
conversions/post_click_conversions/post_view_conversions; metrics=null when
|
|
132
|
+
no matching rows, provider errors stay errors. No bidding changes.
|
|
133
|
+
|
|
134
|
+
## Errors and recovery
|
|
135
|
+
|
|
136
|
+
- 401/403: Egbe admin OAuth/app/account/Page permission, not a reason to switch keys.
|
|
137
|
+
- 404: unknown or unowned resource; ownership checks precede mutations.
|
|
138
|
+
- 400/422: invalid schema, provider minimum, targeting or format; inspect exact error.
|
|
139
|
+
- 409: conflict, unresolved operation, parent state, image processing, readback
|
|
140
|
+
mismatch or unavailable wallet reservation. Follow its message; don't bypass.
|
|
141
|
+
- 429: quota/provider throttling; retry with backoff and same operation identity.
|
|
142
|
+
- GET transient transport/429/5xx: bounded retry, at most three attempts. Long
|
|
143
|
+
Retry-After defers to the caller; 401/403 aren't repeatedly retried.
|
|
144
|
+
- Write transport failure: outcome may be unknown; preserve key and read back.
|
|
145
|
+
No blind transport retries for mutations. Event receipts distinguish confirmed
|
|
146
|
+
retryable refusal from uncertain delivery; see the conversions workflow.
|
|
147
|
+
- Same key after a later update: superseded; does not re-activate paused resources.
|
|
148
|
+
|
|
149
|
+
First defaults: 5 campaign creations/month, 50 other management mutations/day.
|
|
150
|
+
Reads do not consume write quotas. Pause is exempt. Image uploads/group/creative
|
|
151
|
+
creation and conversion configuration count as management mutations. Disable/
|
|
152
|
+
detach are exempt; runtime event delivery does not consume campaign-write quota.
|
|
153
|
+
Effective limits come from the caller's
|
|
154
|
+
binding, not a hardcoded assumption in the agent.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Campaign continuity
|
|
2
|
+
|
|
3
|
+
Paths are relative to the product repository root:
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
egbe-docs/marketing/campaigns/linkedin/
|
|
7
|
+
channel-readiness.json
|
|
8
|
+
campaigns.json
|
|
9
|
+
<linkedin-slug>/
|
|
10
|
+
creatives.json
|
|
11
|
+
tracking.json
|
|
12
|
+
campaign-state.json
|
|
13
|
+
operations.json
|
|
14
|
+
launch-readback.json
|
|
15
|
+
change-log.md
|
|
16
|
+
assets/
|
|
17
|
+
monitoring/check-<UTC-timestamp>.md
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Create artifacts when needed, not empty files for future phases. Never store
|
|
21
|
+
member tokens, signed upload URLs, raw customer records or private credentials.
|
|
22
|
+
|
|
23
|
+
Through the Egbe connector without a project folder, keep these records at the
|
|
24
|
+
same paths in Egbe's artifact store, as `egbe-os-quickstart` →
|
|
25
|
+
`references/artifact-sync.md` ("Through the Egbe connector") describes. Save a
|
|
26
|
+
write's request record there before sending the write.
|
|
27
|
+
|
|
28
|
+
- `campaigns.json`: campaign slug/path and selected campaign; preserve caller
|
|
29
|
+
product/experiment identifiers when provided. Explicit task selection wins.
|
|
30
|
+
- `creatives.json`: approved text/image paths, format, stable local variant ID,
|
|
31
|
+
exact UTM destination, provenance and substantiation. Not a provider payload.
|
|
32
|
+
- `tracking.json`: `utm_source=linkedin`, `utm_medium=paid_social`,
|
|
33
|
+
`utm_campaign=<linkedin-slug>`, `utm_content=<variant>`; product analytics
|
|
34
|
+
verification and attribution gaps. Provider conversions default `not_configured`.
|
|
35
|
+
When requested, record rule IDs/methods, campaign associations, event hooks,
|
|
36
|
+
event_id_prefix and configuration/ingestion/attribution verification separately.
|
|
37
|
+
Save event receipt IDs/status, never their customer matching payloads.
|
|
38
|
+
- `campaign-state.json`: product slug, native account and organization URNs,
|
|
39
|
+
group ID, each campaign ID/format/budget, creative IDs/parents/image URNs,
|
|
40
|
+
observed statuses and timestamp. One experiment may contain both formats:
|
|
41
|
+
list their separate campaigns and total authorized daily budget.
|
|
42
|
+
- `launch-readback.json`: timestamped GET responses for group, campaigns,
|
|
43
|
+
creatives and images; preserve moderation/serving reasons and exact bindings.
|
|
44
|
+
- `change-log.md`: actual mutations, before/after observations and authority.
|
|
45
|
+
- Saved observations: query/returned periods, fetch time, source, currency,
|
|
46
|
+
metrics, availability and attribution gaps. Simple reads need no new files.
|
|
47
|
+
|
|
48
|
+
Before each mutation append to `operations.json`:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{"operations":[{"operation_id":"group-create","method":"POST","path":"/ads/linkedin/campaign-groups","idempotency_key":"linkedin-pilot-group-v1","payload":{"product_slug":"example-product","name":"LinkedIn pilot","schedule":{"start":1800000000000}},"status":"prepared","result_ids":[]}]}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Replace the illustrative start with the approved Unix-millisecond schedule.
|
|
55
|
+
Store the exact configuration body and key before calling. Runtime customer-event
|
|
56
|
+
retry payloads belong in private product storage, not this artifact.
|
|
57
|
+
For image bytes store the local file
|
|
58
|
+
path and digest, not base64. States: prepared, unconfirmed, succeeded, failed.
|
|
59
|
+
A lost response is unconfirmed. Persist returned IDs even if later steps fail.
|
|
60
|
+
Same operation means same payload/key; resolve it before authorizing a changed one.
|
|
61
|
+
|
|
62
|
+
Reconstruct missing local history from owned OS reads and label unknowns. Urgent
|
|
63
|
+
authorized pause must not wait for invented strategy or complete documentation.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Build without delivery and recover
|
|
2
|
+
|
|
3
|
+
Read artifacts and the API reference. Resolve recorded IDs through owned GETs.
|
|
4
|
+
If both formats are requested, create separate native campaigns under the same
|
|
5
|
+
product-owned group and keep the aggregate daily spend within authorization.
|
|
6
|
+
|
|
7
|
+
1. Read account/Page, pricing and targeting; save the intended build.
|
|
8
|
+
2. Create the group with product_slug and schedule. OS creates it DRAFT: LinkedIn
|
|
9
|
+
does not allow initial PAUSED groups. A requested "paused build" uses DRAFT
|
|
10
|
+
throughout; never activate parents merely to make child creation possible.
|
|
11
|
+
3. Create each campaign with group ID, format, targeting, locale, daily USD budget,
|
|
12
|
+
CPC and schedule. OS creates it DRAFT; LinkedIn rejects PAUSED campaigns
|
|
13
|
+
beneath a DRAFT group.
|
|
14
|
+
4. Upload each approved PNG/JPEG via `POST /ads/linkedin/images`. Poll its owned
|
|
15
|
+
GET until `status=AVAILABLE`; processing is asynchronous. Do not create a
|
|
16
|
+
new upload merely because processing is slow.
|
|
17
|
+
5. Create a creative with campaign ID, owned image URN, approved copy and exact
|
|
18
|
+
destination. Single Image creates Direct Sponsored Content with
|
|
19
|
+
`feedDistribution=NONE`; it does not publish to the organic Page feed.
|
|
20
|
+
Text Ad uses its separate native content payload. Both creatives start DRAFT.
|
|
21
|
+
6. Read back every object and parent binding; record moderation/serving reasons,
|
|
22
|
+
DRAFT states, image availability, budget and destination. Existing PAUSED
|
|
23
|
+
objects are also non-serving; preserve them when resuming work. For Single
|
|
24
|
+
Image the creative may read back a content reference instead of inline content;
|
|
25
|
+
the owned `/creatives/{id}/content` GET resolves that post for review.
|
|
26
|
+
7. Save state, readback and operation outcomes; return the specific remaining
|
|
27
|
+
blockers. A non-serving build does not prove delivery. Creative review starts
|
|
28
|
+
on activation; absent review on a DRAFT creative is expected, not a reason
|
|
29
|
+
to activate it or wait for moderation during this build.
|
|
30
|
+
|
|
31
|
+
Uncertain create returns 409 with recovery instructions. Retry the same key/body.
|
|
32
|
+
If the response still requires Egbe team reconciliation, stop creation and
|
|
33
|
+
preserve the key: the gateway will not silently create another resource.
|
|
34
|
+
After an update timeout, retry the same operation for verified readback; a newer
|
|
35
|
+
mutation supersedes earlier update keys, so an old launch cannot undo a pause.
|
|
36
|
+
|
|
37
|
+
For Text Ads, use the bounded creative PATCH to change copy/image/destination;
|
|
38
|
+
it merges changed fields into fresh readback and preserves status. For Single
|
|
39
|
+
Image content changes, prepare an explicitly authorized new
|
|
40
|
+
DRAFT creative under the existing campaign, inspect it, then perform the approved
|
|
41
|
+
switch and pause the old creative. Do not delete history or recreate the campaign.
|
|
42
|
+
Creative internal names can be changed in place for both formats. If LinkedIn
|
|
43
|
+
rejects a field for the current creative state, report that reason; do not silently
|
|
44
|
+
replace the creative or change its delivery status.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Optional conversion measurement
|
|
2
|
+
|
|
3
|
+
Use when the founder asks to measure real product outcomes in LinkedIn. A
|
|
4
|
+
traffic campaign can run without this setup. Work in the existing product's
|
|
5
|
+
auth, billing, analytics and job conventions; no scaffold or instance is needed.
|
|
6
|
+
Keep provider credentials in OS. Server code uses its product `OS_API_KEY`
|
|
7
|
+
(scope `analytics` or `ads`); configuration needs `ads`.
|
|
8
|
+
|
|
9
|
+
## Configure and associate
|
|
10
|
+
|
|
11
|
+
1. Read owned campaigns and conversion rules before creating anything. Reuse the
|
|
12
|
+
rule for the same product outcome and source. Inspect exact schemas in OpenAPI.
|
|
13
|
+
2. Create `POST /ads/linkedin/conversion-rules` with an owned `campaign_id`,
|
|
14
|
+
`name`, `type` (e.g. SIGN_UP or PURCHASE), and `method`:
|
|
15
|
+
`INSIGHT_TAG` for an event-specific browser rule or `CONVERSIONS_API` for a
|
|
16
|
+
server rule. The campaign resolves ownership; creation does **not** attach it.
|
|
17
|
+
3. Explicitly `PUT /ads/linkedin/campaigns/{campaign_id}/conversion-rules/{id}`
|
|
18
|
+
for each approved campaign; GET the same path to confirm `associated:true`.
|
|
19
|
+
This is measurement association, not campaign activation or conversion bidding.
|
|
20
|
+
DELETE detaches only this pair. PATCH the rule with `enabled:false` to disable
|
|
21
|
+
it; do not delete/recreate rules to fix reporting delays.
|
|
22
|
+
|
|
23
|
+
Mutations require a persisted Idempotency-Key. Save rule IDs, method, campaign
|
|
24
|
+
associations, readback and actual event hooks in tracking.json. Do not automatically
|
|
25
|
+
associate every campaign in the shared account.
|
|
26
|
+
|
|
27
|
+
## Browser
|
|
28
|
+
|
|
29
|
+
For the owned browser rule, GET `/conversion-rules/{id}/browser-tag` to read the
|
|
30
|
+
existing shared Insight Tag. Install its returned public `insight_tag.tag` once
|
|
31
|
+
using the project's script conventions; never expose OS credentials. If the
|
|
32
|
+
account tag is missing, report the Egbe team prerequisite; don't create or change
|
|
33
|
+
shared tags, domain permissions or audiences.
|
|
34
|
+
|
|
35
|
+
Fire `window.lintrk("track", {conversion_id: Number(ruleId), event_id: providerEventId})`
|
|
36
|
+
on the actual completed outcome, not a button click or generic success-page load.
|
|
37
|
+
Use the rule's returned `event_id_prefix` plus the same stable product event ID
|
|
38
|
+
used below. The prefix isolates products sharing one LinkedIn account.
|
|
39
|
+
|
|
40
|
+
## Server
|
|
41
|
+
|
|
42
|
+
Call `POST /ads/linkedin/conversion-events` after the authoritative product
|
|
43
|
+
operation succeeds: a committed registration, or a verified paid invoice/event.
|
|
44
|
+
Use one stable opaque `event_id` per business event (not a fresh ID per retry),
|
|
45
|
+
its original Unix-millisecond `happened_at`, and:
|
|
46
|
+
|
|
47
|
+
- `email_sha256`: lowercase hex SHA-256 of trimmed, lowercase email; and/or
|
|
48
|
+
- `linkedin_tracking_uuid`: genuine `li_fat_id` captured by the product.
|
|
49
|
+
- Optional `value: {"currency_code":"USD","amount":"19.00"}` for the real value.
|
|
50
|
+
|
|
51
|
+
Only send user identifiers the product is allowed to share. Never invent a click
|
|
52
|
+
identifier or email. Retain retry data in the product's existing server-side
|
|
53
|
+
storage/queue; don't put matching identifiers into marketing artifacts. Don't
|
|
54
|
+
block a successful signup/payment on ad delivery.
|
|
55
|
+
|
|
56
|
+
OS adds the product namespace to `event_id`; **do not add the prefix yourself in
|
|
57
|
+
the server request**. For redundant browser + server measurement, use separate
|
|
58
|
+
rules and the same prefixed event ID in the browser. LinkedIn may credit the
|
|
59
|
+
browser rule and remove the duplicate from the CAPI rule. Don't sum the two as
|
|
60
|
+
independent outcomes or treat a low CAPI count alone as failure.
|
|
61
|
+
|
|
62
|
+
## Verify without fake conversions
|
|
63
|
+
|
|
64
|
+
- `validate_only:true` validates the body, owned enabled server rule and a live
|
|
65
|
+
campaign association. It sends no event; this is **not** provider ingestion proof.
|
|
66
|
+
- Locally test the real event hook and outbound body with a stubbed OS response.
|
|
67
|
+
Do not create fictional registrations/purchases in LinkedIn to get a green check.
|
|
68
|
+
- Actual delivery returns a durable `receipt_id`; GET
|
|
69
|
+
`/conversion-events/{receipt_id}`. `accepted` means provider acceptance, not
|
|
70
|
+
matching or attribution. The product must inspect `data.status`, not HTTP alone.
|
|
71
|
+
- `retryable`: fix access for 401/403, wait until `retry_at_ms`, then resubmit the
|
|
72
|
+
identical body/key. At most five delivery attempts; no automatic OS scheduler.
|
|
73
|
+
`unconfirmed` means a response was lost/ambiguous: preserve the receipt for
|
|
74
|
+
Egbe team review, don't generate a new event/key. `rejected` or `exhausted`
|
|
75
|
+
also needs diagnosis, not a loop. Receipts never contain customer identifiers.
|
|
76
|
+
- GET `/campaigns/{campaign_id}/conversion-rules/{id}/results?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD`.
|
|
77
|
+
Counts are attributed to that campaign/rule, including post-click and post-view.
|
|
78
|
+
Empty rows mean unavailable, not zero. Full conversion reporting can take up to
|
|
79
|
+
72 hours; real traffic and outcomes are needed to prove attribution.
|
|
80
|
+
|
|
81
|
+
Report separately: configuration/association, implementation of the product
|
|
82
|
+
hook, actual provider acceptance, and attributed results. Leave the last two
|
|
83
|
+
unverified until real events exist.
|
|
84
|
+
|
|
85
|
+
[Conversion contracts](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api-schema),
|
|
86
|
+
[Insight Tag](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversion-tracking),
|
|
87
|
+
[Deduplication](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication),
|
|
88
|
+
[Reporting delay](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/conversions-faq).
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Launch and pause
|
|
2
|
+
|
|
3
|
+
Launch requires authorization for the selected campaign(s), targeting,
|
|
4
|
+
daily USD budgets and delivery schedule. Read current provider state and resolve
|
|
5
|
+
pending mutations. Recheck wallet availability and provider moderation/serving
|
|
6
|
+
holds; report blocked eligibility instead of claiming the ads are running.
|
|
7
|
+
|
|
8
|
+
Activate in this order:
|
|
9
|
+
1. Group launch from DRAFT or PAUSED, with all child campaigns DRAFT or PAUSED.
|
|
10
|
+
2. Selected campaign launch with wallet authorization.
|
|
11
|
+
3. Selected creatives launch; this also starts their moderation.
|
|
12
|
+
|
|
13
|
+
For a DRAFT group or campaign whose start has passed, OS moves the start to
|
|
14
|
+
approximately one minute after the launch request, preserving its end, budget
|
|
15
|
+
and other settings. Future starts and PAUSED resumes stay unchanged. An expired
|
|
16
|
+
end window requires a newly authorized schedule; OS never extends it. Retry a
|
|
17
|
+
refused launch with the same key; no replacement objects are needed.
|
|
18
|
+
|
|
19
|
+
Activating a group containing active campaigns is rejected: first pause those
|
|
20
|
+
campaigns, activate the group, then explicitly launch selected campaigns. This
|
|
21
|
+
prevents group activation from bypassing campaign wallet authorization.
|
|
22
|
+
Campaign activation, a live campaign budget change, or creative activation beneath
|
|
23
|
+
an already active campaign reserves two daily budgets in Egbe wallet before the
|
|
24
|
+
provider change. A hold is a reservation, not a charge or a LinkedIn spend cap.
|
|
25
|
+
Daily budgets are pacing controls, not a promise of exact daily spend.
|
|
26
|
+
|
|
27
|
+
Read back group, campaign and creatives after launch and record intended status
|
|
28
|
+
separately from actual serving. Do not wait in a loop for impressions to call
|
|
29
|
+
configuration verified. This operation does not schedule future checks.
|
|
30
|
+
|
|
31
|
+
Pause the exact campaign with `POST /campaigns/{id}/pause` and a durable key.
|
|
32
|
+
Pause remains available when the mutation quota is exhausted. Campaign pause
|
|
33
|
+
releases its current reserve after readback; delayed actual spend can still settle.
|
|
34
|
+
Group pause stops its children and releases owned campaign holds, but preserves
|
|
35
|
+
their native individual status. Pause on an already DRAFT group, campaign or
|
|
36
|
+
creative is a verified no-op and returns DRAFT; it never activates an object
|
|
37
|
+
to make PAUSED attainable.
|
|
38
|
+
Pausing one creative may leave others delivering:
|
|
39
|
+
use campaign pause for a complete stop.
|
|
40
|
+
Record the requested trigger/authority in the existing change-log, then append
|
|
41
|
+
the affected ID, actual confirmation time and readback after success. Preserve
|
|
42
|
+
the known cause for this run; later balance or deadline changes do not replace it.
|
|
43
|
+
If the provider exposes no cause, record it as unknown. A later relaunch does not
|
|
44
|
+
reuse the earlier stop timestamp. A failed pause or stopped monitoring alone is
|
|
45
|
+
not a confirmed stop.
|
|
46
|
+
|
|
47
|
+
Archive/cleanup leaves DRAFT objects non-serving, pauses other owned
|
|
48
|
+
groups/campaigns/creatives and retains image/history
|
|
49
|
+
resources; it never changes another product's objects or deletes the Page.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Read results and change settings
|
|
2
|
+
|
|
3
|
+
Resolve the selected campaign from artifacts or owned lists. Read the campaign,
|
|
4
|
+
group, creatives and results for explicit inclusive UTC dates. Today is supported
|
|
5
|
+
but partial. Return fetched_at, requested dates, provider ranges, currency and
|
|
6
|
+
any error/unknown status with the observations.
|
|
7
|
+
|
|
8
|
+
Inspect delivery/moderation/serving-hold fields first when spend or impressions
|
|
9
|
+
are missing. Account eligibility, schedule, audience, CPC and creative review
|
|
10
|
+
can each prevent serving despite ACTIVE configuration. Do not infer the cause
|
|
11
|
+
from zero alone or automatically raise bids.
|
|
12
|
+
|
|
13
|
+
`metrics:null` / `data_status=unavailable` is not zero: LinkedIn can return an
|
|
14
|
+
empty report both for no activity and missing reporting access. A real provider
|
|
15
|
+
row containing zeros is observed zero. API failures remain failures.
|
|
16
|
+
Older ranges may be rounded to full months; inspect observed_ranges.
|
|
17
|
+
Clicks, product visits and product outcomes have different meanings; do not label
|
|
18
|
+
a UTM product signup as a provider-attributed conversion.
|
|
19
|
+
If provider conversions were configured, use the
|
|
20
|
+
[conversions workflow](conversions.md) for the selected campaign/rule report.
|
|
21
|
+
An accepted event receipt isn't a conversion count; report the two separately.
|
|
22
|
+
|
|
23
|
+
Registry periodically synchronizes cumulative actual campaign spend into wallet.
|
|
24
|
+
The launch hold is not a second charge. Report unsupported currency, missing
|
|
25
|
+
reporting permission or unavailable cumulative spend as a billing-sync blocker;
|
|
26
|
+
never settle missing data as zero. Historical data beyond provider retention
|
|
27
|
+
requires Egbe team reconciliation.
|
|
28
|
+
|
|
29
|
+
## Changes
|
|
30
|
+
|
|
31
|
+
Read before changing. `PATCH /campaigns/{id}` changes only supplied name, daily
|
|
32
|
+
budget, CPC, targeting or schedule; it does not change status, format or objective.
|
|
33
|
+
Preserve omitted settings. Confirm fresh readback and append the reason/evidence
|
|
34
|
+
and authorization to change-log. Monitoring alone authorizes no mutations.
|
|
35
|
+
Use the build workflow for creative replacement; do not guess a raw PATCH body.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Readiness
|
|
2
|
+
|
|
3
|
+
Call `GET /ads/linkedin/readiness` and `GET /ads/linkedin/account`.
|
|
4
|
+
Record account ID, USD currency, linked organization URN, status, serving holds
|
|
5
|
+
and timestamp in channel-readiness. Check the Page is the intended advertiser.
|
|
6
|
+
A successful account GET verifies read access only. `ready:null` means remaining
|
|
7
|
+
permissions/serving checks are unverified, not a green light to spend.
|
|
8
|
+
|
|
9
|
+
The Egbe team supplies a verified/approved LinkedIn developer app, an enabled USD
|
|
10
|
+
Campaign Manager account with billing, and member OAuth access. The member needs
|
|
11
|
+
the appropriate account management role and Page role for Direct Sponsored Content.
|
|
12
|
+
Client ID/secret alone cannot manage campaigns: LinkedIn Marketing uses member
|
|
13
|
+
authorization, not client-credentials OAuth. Development access may require the
|
|
14
|
+
selected account on the app's allowlist.
|
|
15
|
+
|
|
16
|
+
If access is missing, return the precise failing operation/status and required
|
|
17
|
+
action from the Egbe team. Do not create disposable campaigns merely to probe permissions.
|
|
18
|
+
The requested non-serving DRAFT build is the controlled write test; report which steps
|
|
19
|
+
succeeded and which permissions remain unverified.
|
|
20
|
+
|
|
21
|
+
## Egbe admin configuration (not product credentials)
|
|
22
|
+
|
|
23
|
+
Tools deployment reads:
|
|
24
|
+
- `LINKEDIN_ADS_CLIENT_ID`, `LINKEDIN_ADS_CLIENT_SECRET`;
|
|
25
|
+
- `LINKEDIN_ADS_ACCESS_TOKEN`, `LINKEDIN_ADS_ACCESS_TOKEN_EXPIRES_AT`;
|
|
26
|
+
- optional `LINKEDIN_ADS_REFRESH_TOKEN`, `LINKEDIN_ADS_REFRESH_TOKEN_EXPIRES_AT`;
|
|
27
|
+
- `LINKEDIN_ADS_ACCOUNT_ID`, `LINKEDIN_ADS_REDIRECT_URI`;
|
|
28
|
+
- `LINKEDIN_ADS_API_VERSION` (YYYYMM, currently 202608).
|
|
29
|
+
|
|
30
|
+
Expiry values are Unix seconds. Blank refresh fields are legitimate: programmatic
|
|
31
|
+
refresh is available only when LinkedIn grants it. Without refresh, the Egbe team
|
|
32
|
+
must renew member consent before access expires. Gateway refreshes near expiry
|
|
33
|
+
when a valid refresh token is configured; it does not rotate the configured
|
|
34
|
+
refresh token or write secrets back to the repository.
|
|
35
|
+
|
|
36
|
+
Register the exact redirect URI in the LinkedIn app. OAuth setup by an Egbe admin:
|
|
37
|
+
1. Open `https://www.linkedin.com/oauth/v2/authorization` with URL-encoded
|
|
38
|
+
`response_type=code`, `client_id`, `redirect_uri`, random `state` and the
|
|
39
|
+
app-approved scopes (`rw_ads`, `r_ads`, `r_ads_reporting`; applicable organization
|
|
40
|
+
social permissions for image/DSC operations).
|
|
41
|
+
2. The authorized member signs in and consents; verify returned state locally.
|
|
42
|
+
3. Exchange the one-time code server-side at
|
|
43
|
+
`https://www.linkedin.com/oauth/v2/accessToken` with form fields
|
|
44
|
+
`grant_type=authorization_code`, code, identical redirect_uri, client_id,
|
|
45
|
+
client_secret. Save returned tokens/expiry only in Egbe's restricted secret storage.
|
|
46
|
+
4. Configure the account ID from Campaign Manager; the gateway discovers its Page
|
|
47
|
+
through account `reference`. Do not put Page identity into product source.
|
|
48
|
+
|
|
49
|
+
Exact permissions depend on the approved API products:
|
|
50
|
+
[Marketing authentication](https://learn.microsoft.com/en-us/linkedin/marketing/getting-started),
|
|
51
|
+
[authorization code flow](https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow),
|
|
52
|
+
[refresh tokens](https://learn.microsoft.com/en-us/linkedin/shared/authentication/programmatic-refresh-tokens).
|
|
53
|
+
|
|
54
|
+
Optional conversion measurement additionally needs approved Conversions API
|
|
55
|
+
access and member scopes `rw_conversions`, `r_ads`. Successful rule reads do
|
|
56
|
+
not prove create/event-ingestion permission. Check through the requested
|
|
57
|
+
configuration and real events, not a throwaway conversion.
|
|
58
|
+
|
|
59
|
+
Advertising, Conversions and any future Ad Library product have independent
|
|
60
|
+
approval/version lifecycles. Current gateway calls are pinned to 202608; recheck
|
|
61
|
+
the relevant API product when changing the version, not every routine campaign.
|
|
62
|
+
`BILLING_HOLD` blocks serving, not necessarily DRAFT object creation; don't
|
|
63
|
+
change billing or launch to test this assumption. Record the provider's response.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Targeting and creative assembly
|
|
2
|
+
|
|
3
|
+
Use the requested targeting, format, budget, copy, assets and destination.
|
|
4
|
+
Resolve missing operation inputs before writing; preserve unaffected settings
|
|
5
|
+
when editing an existing object.
|
|
6
|
+
|
|
7
|
+
Resolve targeting with `GET /ads/linkedin/targeting/facets` and
|
|
8
|
+
`GET /ads/linkedin/targeting/entities`. Use returned facet/entity URNs, not guessed
|
|
9
|
+
company names or copied example IDs. Explicit locations are required. Values
|
|
10
|
+
within a facet are OR; included facets are AND; exclusions remove matching members.
|
|
11
|
+
The first release exposes locations, industries, staff count ranges, seniorities,
|
|
12
|
+
job functions, titles, employers and skills.
|
|
13
|
+
|
|
14
|
+
Call audience-estimate and budget-pricing with the proposed targeting/format.
|
|
15
|
+
Record estimates as estimates. Check provider minimum/suggested CPC and daily
|
|
16
|
+
budget against the authorized amount. A too-small audience is a decision to
|
|
17
|
+
discuss targeting, not permission to silently broaden it. Audience expansion
|
|
18
|
+
and offsite delivery are disabled.
|
|
19
|
+
|
|
20
|
+
## Two creative formats
|
|
21
|
+
|
|
22
|
+
- Single Image: image, headline, introductory text, CTA and exact landing URL.
|
|
23
|
+
Current gateway bounds: headline ≤200 and text ≤3000 characters.
|
|
24
|
+
- Text Ad: headline ≤25 and description ≤75 characters, plus image and landing URL.
|
|
25
|
+
|
|
26
|
+
These formats require separate native campaigns. Verify asset dimensions/cropping
|
|
27
|
+
against the current format rules below.
|
|
28
|
+
|
|
29
|
+
Use approved product assets or generate an image through Egbe OS: discover the
|
|
30
|
+
current `images` capability via `GET $OS_URL/`, read its live skill and exact
|
|
31
|
+
generation contract. Save the resulting PNG/JPEG locally, inspect its readability
|
|
32
|
+
and claims, then upload its bytes through LinkedIn images. An OS-generated URL,
|
|
33
|
+
an image URN and a creative ID are different things; only the returned LinkedIn
|
|
34
|
+
`urn:li:image:...` goes in `image_id`. No embedded credentials or external
|
|
35
|
+
provider keys are needed.
|
|
36
|
+
|
|
37
|
+
Read the format's current rules before producing final assets:
|
|
38
|
+
[Single Image](https://business.linkedin.com/advertise/ads/sponsored-content/single-image-ads),
|
|
39
|
+
[Text Ads](https://business.linkedin.com/advertise/ads/text-ads),
|
|
40
|
+
[Advertising policies](https://www.linkedin.com/legal/ads-policy).
|
|
41
|
+
Use truthful, substantiated claims and a matching destination. No deceptive UI,
|
|
42
|
+
unsupported endorsements or fabricated customer proof.
|
|
43
|
+
|
|
44
|
+
## Measurement
|
|
45
|
+
|
|
46
|
+
Bind stable UTMs before creative creation. Read the product's Egbe analytics
|
|
47
|
+
workflow when integrating attribution; reuse existing tracking rather than adding
|
|
48
|
+
a second tracker. Verify destination preserves the intended path/query and that
|
|
49
|
+
product analytics can distinguish the campaign. Record unverified attribution.
|
|
50
|
+
Traffic impressions/clicks are available independently of Insight Tag/CAPI.
|
|
51
|
+
If provider outcome measurement is requested, follow [Conversions](conversions.md).
|
|
52
|
+
It is optional and does not implicitly change the approved traffic strategy.
|