personalize
Personalizes sections of AEM Edge Delivery Services (DA) pages with Section Metadata. The authored content is the default; Personalization rows pick an EDS fragment variant per visitor from rules (geo, device, new/returning, URL/UTM param, page state, custom audiences), a decision engine (v1 API, OF1), a section A/B split, or Adobe Target (inline or popup). Consent-first (no consent, no personalization), with measurement events per decision, a client runtime and an optional Cloudflare edge worker, all checked with a simulator and Playwright. Use for "personalize this section", "different hero for visitors from <country>", "returning visitor banner", "connect our decision engine / OF1", "A/B test this section", "let Target pick this offer", "edge personalization", or /aem-eds-personalization:personalize. Not for creating Target activities, AJO journeys or text tokens. DA projects only.
- Version
- 1.0.0
- License
- Apache-2.0
- Compatibility
- Requires Node 22+, an AEM Edge Delivery Services project authored in DA whose Section Metadata reaches the page as section attributes (rendering v2, or an aem.js that reads it), @adobe/aem-cli 16.21+ for local preview, and Playwright with Chromium in this skill's folder or ~/.cache/aem-eds-personalization/playwright for verify-preview (never installed into the site); wrangler only for edge mode.
Pinned to revision 81d1d53afdd4, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/personalize/SKILL.md
- skills/personalize/CHANGELOG.md
- skills/personalize/assets/content/fragment.html
- skills/personalize/assets/content/section-metadata.html
- skills/personalize/assets/contract/README.md
- skills/personalize/assets/contract/pilot-scenarios.json
- skills/personalize/assets/contract/schemas/decision-feedback.schema.json
- skills/personalize/assets/contract/schemas/decision-request.schema.json
- skills/personalize/assets/contract/schemas/decision-response.schema.json
- skills/personalize/assets/contract/schemas/measurement-event.schema.json
- skills/personalize/assets/contract/schemas/section.schema.json
- skills/personalize/assets/contract/schemas/site-config.schema.json
- skills/personalize/assets/contract/schemas/target-offer.schema.json
- skills/personalize/assets/edge/cloudflare/LICENSE_APACHE
- skills/personalize/assets/edge/cloudflare/README.md
- skills/personalize/assets/edge/cloudflare/src/aem-worker.mjs
- skills/personalize/assets/edge/cloudflare/src/index.mjs
- skills/personalize/assets/edge/cloudflare/src/personalization/adapters/of1.js
- skills/personalize/assets/edge/cloudflare/src/personalization/edge-config.js
- skills/personalize/assets/edge/cloudflare/src/personalization/html.js
- skills/personalize/assets/edge/cloudflare/src/personalization/personalize.js
- skills/personalize/assets/edge/cloudflare/wrangler.toml.tmpl
- skills/personalize/assets/runtime/blocks/fragment/fragment.js
- skills/personalize/assets/runtime/scripts/personalization/config.js
- skills/personalize/assets/runtime/scripts/personalization/context.js
- skills/personalize/assets/runtime/scripts/personalization/contract.js
- skills/personalize/assets/runtime/scripts/personalization/mock-engine.js
- skills/personalize/assets/runtime/scripts/personalization/mocks.js
- skills/personalize/assets/runtime/scripts/personalization/outcomes.js
- skills/personalize/assets/runtime/scripts/personalization/popup.js
- skills/personalize/assets/runtime/scripts/personalization/provider-api.js
- skills/personalize/assets/runtime/scripts/personalization/rules.js
- skills/personalize/assets/runtime/scripts/personalization/section-spec.js
- skills/personalize/assets/runtime/scripts/personalization/sections.js
- skills/personalize/assets/runtime/scripts/personalization/sources/api.js
- skills/personalize/assets/runtime/scripts/personalization/sources/split.js
- skills/personalize/assets/runtime/scripts/personalization/sources/target-websdk.js
- skills/personalize/assets/runtime/scripts/personalization/sources/target.js
- skills/personalize/assets/runtime/scripts/personalization/visitor.js
- skills/personalize/assets/runtime/styles/target-popup.css
- skills/personalize/package.json
- skills/personalize/reference/authoring-model.md
- skills/personalize/reference/client-mode.md
- skills/personalize/reference/consent.md
- skills/personalize/reference/criteria.md
- skills/personalize/reference/cross-cutting.md
- skills/personalize/reference/da-content.md
- skills/personalize/reference/decision-api.md
- skills/personalize/reference/decisions-and-measurement.md
- skills/personalize/reference/edge-cloudflare.md
- skills/personalize/reference/preview-and-testing.md
- skills/personalize/reference/split.md
- skills/personalize/reference/target.md
- skills/personalize/scripts/detect-project.mjs
- skills/personalize/scripts/install-edge.mjs
- skills/personalize/scripts/install-runtime.mjs
- skills/personalize/scripts/lib.mjs
- skills/personalize/scripts/mock-decision-api.mjs
- skills/personalize/scripts/schema.mjs
- skills/personalize/scripts/simulate.mjs
- skills/personalize/scripts/test/conformance.test.mjs
- skills/personalize/scripts/test/context.test.mjs
- skills/personalize/scripts/test/contract.test.mjs
- skills/personalize/scripts/test/detect-project.test.mjs
- skills/personalize/scripts/test/edge.test.mjs
- skills/personalize/scripts/test/fixtures/browser/site.mjs
- skills/personalize/scripts/test/fixtures/contract/examples/decision-feedback/invalid/unknown-type.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-feedback/seen-and-clicked.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/browser.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/edge-no-device.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/candidates-without-default.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/hint-too-long.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/lowercase-country.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/no-placeholders.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/personal-data-in-context.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/referrer-with-path.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/invalid/wrong-version.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-request/of1-hint.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/absolute-fragment.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/control-and-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/control-false.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/empty-decision.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/no-decisions.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/null-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/reason-with-spaces.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/unknown-field.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/variant-and-fragment.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/variant-and-reason.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/invalid/variant-is-number.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/mixed.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/no-answers.json
- skills/personalize/scripts/test/fixtures/contract/examples/decision-response/of1-provider-error.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/applied-fragment-failed.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/applied-unchanged.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/applied.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/clicked.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-cached.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-intentional-default.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-low-confidence-rules.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-no-consent.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-provider-fallback.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-refresh-same-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-split-control.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-split.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/decided-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/cached-on-seen.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/clicked-href-with-query.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/clicked-without-href.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/control-applied.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/control-assigned-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/decided-without-trigger.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/failed-treatment-as-control.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/intentional-default-showing-variant.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/missing-decision-id.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/no-consent-assigned.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/personal-data.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/seen-without-outcome.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/seen-without-result.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/shown-differs-from-assigned.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/source-edge.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/target-notified-seen.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/trigger-on-applied.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/unknown-outcome.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/variant-shown-as-kept-default.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/invalid/variant-without-assigned.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/notified-engine-feedback.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/notified.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/seen-control.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/seen-failed-treatment.json
- skills/personalize/scripts/test/fixtures/contract/examples/measurement-event/seen.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/api-of1-hint.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/api-with-fallback-rules.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/absolute-fragment-url.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/bad-id.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/custom-source.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/hint-outside-api.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/rules-source-without-rules.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/split-row-outside-split.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/split-with-rule-rows.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/target-without-variants.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/trigger-outside-target.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/invalid/variant-named-default.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/rules-geo-device.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/split-ab-test.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/split-even.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/target-existing-location.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/target-inline.json
- skills/personalize/scripts/test/fixtures/contract/examples/section/target-popup.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/delivery-api.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/budget-too-small.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/cmp-without-tool.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/consent-without-mode.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/deny-with-tool.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/exception-without-approval.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/no-consent.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/send-without-consent.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/unknown-engine.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/unknown-exception.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/unknown-transport.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/invalid/websdk-with-endpoint.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/minimal.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/of1.json
- skills/personalize/scripts/test/fixtures/contract/examples/site-config/websdk.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/control.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/fragment.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/invalid/absolute-url.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/invalid/control-and-fragment.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/invalid/control-false.json
- skills/personalize/scripts/test/fixtures/contract/examples/target-offer/invalid/html-in-json.json
- skills/personalize/scripts/test/fixtures/contract/of1-native/README.md
- skills/personalize/scripts/test/fixtures/contract/of1-native/request.json
- skills/personalize/scripts/test/fixtures/contract/of1-native/response-intentional-default.json
- skills/personalize/scripts/test/fixtures/contract/of1-native/response-low-confidence.json
- skills/personalize/scripts/test/fixtures/contract/of1-native/response-provider-error.json
- skills/personalize/scripts/test/fixtures/contract/of1-native/response-variant.json
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/home-hero/india.html
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/home-hero/na-mobile.html
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/offer/diwali.html
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/offer/india.html
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/welcome/back.html
- skills/personalize/scripts/test/fixtures/site/content/fragments/personalization/welcome/cn.html
- skills/personalize/scripts/test/fixtures/site/content/index.html
- skills/personalize/scripts/test/fixtures/site/content/offer.plain.html
- skills/personalize/scripts/test/fixtures/site/decisions.json
- skills/personalize/scripts/test/fixtures/site/index.html
- skills/personalize/scripts/test/fixtures/site/scripts/personalization/config.js
- skills/personalize/scripts/test/helpers.mjs
- skills/personalize/scripts/test/html.test.mjs
- skills/personalize/scripts/test/install-edge.test.mjs
- skills/personalize/scripts/test/install-runtime.test.mjs
- skills/personalize/scripts/test/lib.test.mjs
- skills/personalize/scripts/test/mock-decision-api.test.mjs
- skills/personalize/scripts/test/outcomes.test.mjs
- skills/personalize/scripts/test/pilot.test.mjs
- skills/personalize/scripts/test/provider-api.test.mjs
- skills/personalize/scripts/test/rules.test.mjs
- skills/personalize/scripts/test/runtime-style.test.mjs
- skills/personalize/scripts/test/section-spec.test.mjs
- skills/personalize/scripts/test/sections.test.mjs
- skills/personalize/scripts/test/simulate.test.mjs
- skills/personalize/scripts/test/sources.test.mjs
- skills/personalize/scripts/test/validate-placeholders.test.mjs
- skills/personalize/scripts/test/verify-preview.test.mjs
- skills/personalize/scripts/validate-placeholders.mjs
- skills/personalize/scripts/verify-preview.mjs
Every link opens the file at its source, pinned to the revision this page describes.