@adobe/alloy 2.32.1-beta.1 → 2.33.0

package/dist/alloyServiceWorker.js

@@ -590,7 +590,7 @@ governing permissions and limitations under the License.
 // @ts-check
 /// <reference lib="webworker" />
 
-/** @import { ServiceWorkerLogger } from '@adobe/alloy-core/types.js' */
+/** @import { ServiceWorkerLogger } from './components/PushNotifications/types.js' */
 
 /** @type {ServiceWorkerGlobalScope} */
 // @ts-ignore

package/dist/types/{core → browser}/src/components/Advertising/constants/index.d.ts

@@ -10,6 +10,8 @@ export const LAST_CONVERSION_TIME_KEY_EXPIRES: "lastConversionTimeExpires";
 export const SKWCID_PARAM: "s_kwcid";
 export const EFID_PARAM: "ef_id";
 export const SURFER_ID: "surferId";
+export const HASHED_IP: "hashedIp";
+export const HASHED_IP_ADDR: "hashedIPAddr";
 export const RAMP_ID: "rampId";
 export const ID5_ID: "id5Id";
 export const UNKNOWN_ADVERTISER: "";
@@ -30,6 +32,7 @@ export const SURFER_USER_ID: "1";
 export const SURFER_TIMEOUT_MS: 5000;
 export const SURFER_TRUSTED_ORIGIN: "www.everestjs.net";
 export const SURFER_PARAM_KEY: "gsurfer";
+export const SURFER_IP: "clientIp";
 export const ERROR_ID5_PARTNER_ID_REQUIRED: "ID5 partner ID is required";
 export const ERROR_RAMP_ID_MAX_RETRIES: "Failed to retrieve RampID after maximum retries";
 export const LOG_AD_CONVERSION_START: "Processing ad conversion";

package/dist/types/{core → browser}/src/components/Advertising/handlers/createOnBeforeSendEventHandler.d.ts

@@ -1,4 +1,4 @@
-declare function _default({ cookieManager, logger, componentConfig, getBrowser, consent, collectSurferId, getID5Id, getRampId, appendAdvertisingIdQueryToEvent, getUrlParams, isThrottled, }: {
+declare function _default({ cookieManager, logger, componentConfig, getBrowser, consent, collectSurferId, getID5Id, getRampId, appendAdvertisingIdQueryToEvent, appendAdCloudIdentityToEvent, collectHashedIPAddr, getUrlParams, isThrottled, normalizeAdvertiser, }: {
     cookieManager: any;
     logger: any;
     componentConfig: any;
@@ -8,8 +8,11 @@ declare function _default({ cookieManager, logger, componentConfig, getBrowser,
     getID5Id: Function;
     getRampId: Function;
     appendAdvertisingIdQueryToEvent: Function;
+    appendAdCloudIdentityToEvent: Function;
+    collectHashedIPAddr: Function;
     getUrlParams: Function;
     isThrottled: Function;
+    normalizeAdvertiser: Function;
 }): ({ event, advertising }: {
     event: any;
     advertising?: any;

package/dist/types/{core → browser}/src/components/Advertising/handlers/sendAdConversion.d.ts

@@ -1,4 +1,4 @@
-declare function _default({ eventManager, cookieManager, adConversionHandler, logger, componentConfig, getBrowser, consent, }: {
+declare function _default({ eventManager, cookieManager, adConversionHandler, logger, componentConfig, getBrowser, consent, collectSurferId, collectHashedIPAddr, }: {
     eventManager: any;
     cookieManager: any;
     adConversionHandler: any;
@@ -6,5 +6,7 @@ declare function _default({ eventManager, cookieManager, adConversionHandler, lo
     componentConfig: any;
     getBrowser: any;
     consent: any;
+    collectSurferId: any;
+    collectHashedIPAddr: any;
 }): () => Promise<any>;
 export default _default;

package/dist/types/{core → browser}/src/components/Advertising/handlers/viewThroughHandler.d.ts

@@ -1,8 +1,10 @@
-export default function handleViewThrough({ eventManager, cookieManager, logger, componentConfig, adConversionHandler, getBrowser, }: {
+export default function handleViewThrough({ eventManager, cookieManager, logger, componentConfig, adConversionHandler, getBrowser, collectSurferId, collectHashedIPAddr, }: {
     eventManager: any;
     cookieManager: any;
     logger: any;
     componentConfig: any;
     adConversionHandler: any;
     getBrowser: any;
+    collectSurferId: any;
+    collectHashedIPAddr: any;
 }): Promise<PromiseSettledResult<any>[]>;

package/dist/types/{core → browser}/src/components/Advertising/identities/collectAllIdentities.d.ts

@@ -1,5 +1,5 @@
 export default collectAllIdentities;
-declare function collectAllIdentities(logger: any, componentConfig: any, cookieManager: any, getBrowser: any): {
+declare function collectAllIdentities(logger: any, componentConfig: any, cookieManager: any, getBrowser: any, collectSurferId: any): {
     surferId: any;
     id5Id: any;
     rampId: any;

package/dist/types/browser/src/components/Advertising/identities/collectSurferId.d.ts

@@ -0,0 +1,15 @@
+export default createCollectSurferId;
+/**
+ * Factory for surferId collection. Cache lives at closure scope — no module-level state.
+ *
+ * @param {Object} deps
+ * @param {Function} deps.initiateAdvertisingIdentityCall
+ * @param {Object} deps.cookieManager
+ * @param {Function} deps.getBrowser
+ * @returns {Function} collectSurferId(useShortTimeout?)
+ */
+declare function createCollectSurferId({ initiateAdvertisingIdentityCall, cookieManager, getBrowser, }: {
+    initiateAdvertisingIdentityCall: Function;
+    cookieManager: any;
+    getBrowser: Function;
+}): Function;

package/dist/types/browser/src/components/Advertising/identities/createHashedIpHandler.d.ts

@@ -0,0 +1,9 @@
+declare function _default({ cookieManager, hash }: {
+    cookieManager: any;
+    hash?: (str: string, seed?: number) => string;
+}): {
+    captureFromIframe: (clientIp: any) => void;
+    get: () => any;
+    collect: (initiateCallFn: any) => any;
+};
+export default _default;

package/dist/types/browser/src/components/Advertising/identities/initiateAdvertisingIdentityCall.d.ts

@@ -0,0 +1,5 @@
+export function createInitiateAdvertisingIdentityCall({ appendNode: appendNodeFn, awaitSelector: awaitSelectorFn, createNode: createNodeFn, }?: {
+    appendNode?: Function;
+    awaitSelector?: Function;
+    createNode?: Function;
+}): Function;

package/dist/types/{core → browser}/src/components/Advertising/utils/helpers.d.ts

@@ -16,6 +16,20 @@ export function normalizeAdvertiser(advertiserSettings: any[]): string;
  */
 export function createManagedAsyncOperation(operationName: string, workerFn: Function): Function;
 export function appendAdvertisingIdQueryToEvent(idsToInclude: any, event: any, cookieManager: any, componentConfig: any, addEventType?: boolean): any;
+/**
+ * Appends AdCloud identity data to the event XDM as _experience.adcloud.stitchId.
+ * @param {{ surferId?: string, hashedIp?: string, id5Id?: string, rampId?: string, adfId?: string }} idsToInclude
+ * @param {{ mergeXdm: (xdm: Object) => void }} event
+ */
+export function appendAdCloudIdentityToEvent(idsToInclude: {
+    surferId?: string;
+    hashedIp?: string;
+    id5Id?: string;
+    rampId?: string;
+    adfId?: string;
+}, event: {
+    mergeXdm: (xdm: any) => void;
+}): void;
 export function isAnyIdUnused(availableIds: any, conversionCalled: any): boolean;
 export function markIdsAsConverted(idTypes: any, conversionCalled: any, cookieManager: any, logger: any): void;
 export function isThrottled(idType: any, cookieManager: any): boolean;

package/dist/types/browser/src/components/Advertising/utils/murmurHash128GuavaHex.d.ts

@@ -0,0 +1,2 @@
+export function murmurHash128GuavaHex(str: string, seed?: number): string;
+export default murmurHash128GuavaHex;

package/dist/types/browser/src/components/Personalization/constants/surface.d.ts

@@ -0,0 +1,4 @@
+export const WEB: "web";
+export const WEBAPP: "webapp";
+export const SURFACE_TYPE_DELIMITER: "://";
+export const FRAGMENT_DELIMITER: "#";

package/dist/types/browser/src/components/Personalization/dom-actions/dom/isDomElement.d.ts

@@ -0,0 +1,2 @@
+declare function _default(element: any): element is Element | HTMLDocument;
+export default _default;

package/dist/types/browser/src/components/Personalization/utils/addRenderAttemptedToDecisions.d.ts

@@ -0,0 +1,5 @@
+declare function _default({ decisions, renderAttempted }: {
+    decisions: any;
+    renderAttempted: any;
+}): any;
+export default _default;

package/dist/types/browser/src/components/Personalization/utils/surfaceUtils.d.ts

@@ -0,0 +1,3 @@
+export function buildPageSurface(getPageLocation: any): string;
+export function isPageWideSurface(scope: any): boolean;
+export function normalizeSurfaces(surfaces: any[], getPageLocation: any, logger: any): string[];

package/dist/types/{core → browser}/src/components/PushNotifications/helpers/saveToIndexedDb.d.ts

@@ -5,4 +5,4 @@
  * @returns {Promise<void>}
  */
 export default function saveToIndexedDB(data: any, logger: Logger): Promise<void>;
-import type { Logger } from '../../../core/types.js';
+import type { Logger } from '@adobe/alloy-core/core/types.js';

package/dist/types/{core → browser}/src/components/PushNotifications/index.d.ts

@@ -42,9 +42,9 @@ declare namespace createPushNotifications {
     let namespace: string;
     let configValidators: any;
 }
-import type { StorageCreator } from '../../utils/types.js';
-import type { EventManager } from '../../core/types.js';
-import type { Logger } from '../../core/types.js';
-import type { ConsentManager } from '../../core/consent/types.js';
-import type { IdentityManager } from '../../core/identity/types.js';
-import type { EdgeRequestExecutor } from '../../core/edgeNetwork/types.js';
+import type { StorageCreator } from '@adobe/alloy-core/utils/types.js';
+import type { EventManager } from '@adobe/alloy-core/core/types.js';
+import type { Logger } from '@adobe/alloy-core/core/types.js';
+import type { ConsentManager } from '@adobe/alloy-core/core/consent/types.js';
+import type { IdentityManager } from '@adobe/alloy-core/core/identity/types.js';
+import type { EdgeRequestExecutor } from '@adobe/alloy-core/core/edgeNetwork/types.js';

package/dist/types/{core → browser}/src/components/PushNotifications/request/createSendPushSubscriptionPayload.d.ts

@@ -5,5 +5,5 @@ declare function _default({ ecid, eventManager, serializedPushSubscriptionDetail
     appId: string;
 }): Promise<DataCollectionRequestPayload>;
 export default _default;
-import type { EventManager } from "../../../core/types.js";
-import type { DataCollectionRequestPayload } from "../../../utils/request/types.js";
+import type { EventManager } from "@adobe/alloy-core/core/types.js";
+import type { DataCollectionRequestPayload } from "@adobe/alloy-core/utils/request/types.js";

package/dist/types/browser/src/components/PushNotifications/request/createSendPushSubscriptionRequest.d.ts

@@ -0,0 +1,6 @@
+declare function _default({ payload }: {
+    payload: DataCollectionRequestPayload;
+}): Request;
+export default _default;
+import type { DataCollectionRequestPayload } from '@adobe/alloy-core/utils/request/types.js';
+import type { Request } from '@adobe/alloy-core/utils/request/types.js';

package/dist/types/{core → browser}/src/components/PushNotifications/request/makeSendPushSubscriptionRequest.d.ts

@@ -12,9 +12,9 @@ declare function _default({ config: { vapidPublicKey, appId }, storage, logger,
     window: Window;
 }): Promise<void>;
 export default _default;
-import type { Storage } from '../../../utils/types.js';
-import type { Logger } from '../../../core/types.js';
-import type { EventManager } from '../../../core/types.js';
-import type { IdentityManager } from '../../../core/identity/types.js';
-import type { EdgeRequestExecutor } from '../../../core/edgeNetwork/types.js';
-import type { ConsentManager } from '../../../core/consent/types.js';
+import type { Storage } from '@adobe/alloy-core/utils/types.js';
+import type { Logger } from '@adobe/alloy-core/core/types.js';
+import type { EventManager } from '@adobe/alloy-core/core/types.js';
+import type { IdentityManager } from '@adobe/alloy-core/core/identity/types.js';
+import type { EdgeRequestExecutor } from '@adobe/alloy-core/core/edgeNetwork/types.js';
+import type { ConsentManager } from '@adobe/alloy-core/core/consent/types.js';

package/dist/types/{core → browser}/src/components/PushNotifications/types.d.ts

@@ -1,4 +1,4 @@
-/** @import { Identity } from '../../utils/request/types.js' */
+/** @import { Identity } from '@adobe/alloy-core/utils/request/types.js' */
 /**
  * @typedef {Object} PushSubscription
  * @property {string} endpoint - The push service endpoint URL

package/dist/types/browser/src/components/componentCreators.d.ts

@@ -1 +1,4 @@
 export { default as activityCollector } from "./ActivityCollector/index.js";
+export { default as advertising } from "./Advertising/index.js";
+export { default as personalization } from "./Personalization/index.js";
+export { default as pushNotifications } from "./PushNotifications/index.js";

package/dist/types/browser/src/components/requiredComponentCreators.d.ts

@@ -0,0 +1 @@
+export { default as context } from "./Context/index.js";

package/dist/types/core/src/components/Identity/injectAddQueryStringIdentityToPayload.d.ts

@@ -1,5 +1,6 @@
-declare function _default({ locationSearch, dateProvider, orgId, logger }: {
+declare function _default({ locationSearch, locationHash, dateProvider, orgId, logger, }: {
     locationSearch: any;
+    locationHash: any;
     dateProvider: any;
     orgId: any;
     logger: any;

package/dist/types/core/src/core/componentCreators.d.ts

@@ -2,9 +2,6 @@ export { default as audiences } from "../components/Audiences/index.js";
 export { default as consent } from "../components/Consent/index.js";
 export { default as eventMerge } from "../components/EventMerge/index.js";
 export { default as mediaAnalyticsBridge } from "../components/MediaAnalyticsBridge/index.js";
-export { default as personalization } from "../components/Personalization/index.js";
 export { default as rulesEngine } from "../components/RulesEngine/index.js";
 export { default as streamingMedia } from "../components/StreamingMedia/index.js";
-export { default as advertising } from "../components/Advertising/index.js";
-export { default as pushNotifications } from "../components/PushNotifications/index.js";
 export { default as brandConcierge } from "../components/BrandConcierge/index.js";

package/dist/types/core/src/core/requiredComponentCreators.d.ts

@@ -1,4 +1,3 @@
-export { default as context } from "../components/Context/index.js";
 export { default as dataCollector } from "../components/DataCollector/index.js";
 export { default as identity } from "../components/Identity/index.js";
 export { default as libraryInfo } from "../components/LibraryInfo/index.js";

package/dist/types/core/src/types.d.ts

@@ -1,9 +1,5 @@
 /**
  * @typedef {import("./core/types.js").AlloyMonitor} AlloyMonitor
  */
-/**
- * @typedef {import("./components/PushNotifications/types.js").ServiceWorkerLogger} ServiceWorkerLogger
- */
 export const Types: {};
 export type AlloyMonitor = import("./core/types.js").AlloyMonitor;
-export type ServiceWorkerLogger = import("./components/PushNotifications/types.js").ServiceWorkerLogger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/alloy",
-  "version": "2.32.1-beta.1",
+  "version": "2.33.0",
   "description": "Adobe Experience Platform Web SDK",
   "type": "module",
   "repository": {
@@ -68,7 +68,7 @@
     "commander": "^14.0.2",
     "rollup": "^4.52.5",
     "rollup-plugin-license": "^3.6.0",
-    "@adobe/alloy-core": "^1.1.2-beta.1"
+    "@adobe/alloy-core": "^1.1.2"
   },
   "devDependencies": {
     "glob": "^11.0.3",

package/src/components/Advertising/configValidators.js

@@ -0,0 +1,32 @@
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+import {
+  objectOf,
+  string,
+  arrayOf,
+  boolean,
+} from "@adobe/alloy-core/utils/validation";
+
+export default objectOf({
+  advertising: objectOf({
+    id5PartnerId: string(),
+    rampIdJSPath: string(),
+    dspEnabled: boolean(),
+    advertiserSettings: arrayOf(
+      objectOf({
+        advertiserId: string().required(),
+        enabled: boolean().required(),
+      }).noUnknownFields(),
+    ),
+  }).noUnknownFields(),
+});

package/src/components/Advertising/constants/index.js

@@ -0,0 +1,80 @@
+/*
+Copyright 2025 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+// Cookie Keys
+export const ADVERTISING_COOKIE_KEY = "advertising";
+export const SURFER_ID_COOKIE_KEY = "surfer_id";
+export const RAMP_ID_COOKIE_KEY = "ramp_id";
+export const ID5_COOKIE_KEY = "id5_id";
+export const LAST_CLICK_COOKIE_KEY = "_les_lsc";
+export const LAST_CONVERSION_TIME_KEY = "lastConversionTime";
+export const DISPLAY_CLICK_COOKIE_KEY_EXPIRES = "displayClickCookieExpires";
+export const RAMP_ID_EXPIRES = "rampIdExpires";
+export const LAST_CONVERSION_TIME_KEY_EXPIRES = "lastConversionTimeExpires";
+// URL Parameters
+export const SKWCID_PARAM = "s_kwcid";
+export const EFID_PARAM = "ef_id";
+
+// Identity Types
+export const SURFER_ID = "surferId";
+export const HASHED_IP = "hashedIp"; // logical key — matches surferId/id5Id/rampId casing
+export const HASHED_IP_ADDR = "hashedIPAddr"; // cookie key only
+export const RAMP_ID = "rampId";
+export const ID5_ID = "id5Id";
+
+// Default Values
+export const UNKNOWN_ADVERTISER = "";
+export const DEFAULT_THROTTLE_MINUTES = 30;
+export const DEFAULT_COOKIE_EXPIRATION_MINUTES = 527040; // 365 days
+
+// Event Types
+export const AD_CONVERSION_CLICK_EVENT_TYPE = "advertising.enrichment_ct";
+export const AD_CONVERSION_VIEW_EVENT_TYPE = "advertising.enrichment";
+
+// XDM Paths
+export const XDM_AD_CLOUD_PATH = "_experience.adloud";
+export const XDM_AD_ASSET_REFERENCE = "adAssetReference";
+export const XDM_AD_STITCH_DATA = "adStitchData";
+export const XDM_AD_ASSET_DATA = "adAssetData";
+export const XDM_ADVERTISER = "advertiser";
+export const TRACKING_CODE = "trackingCode";
+export const TRACKING_IDENTITIES = "trackingIdentities";
+
+// Script URLs
+export const ID5_SCRIPT_URL = "https://www.everestjs.net/static/id5-api.js";
+
+// Surfer ID Configuration
+export const SURFER_PIXEL_HOST = "pixel.everesttech.net";
+export const SURFER_USER_ID = "1";
+export const SURFER_TIMEOUT_MS = 5000;
+export const SURFER_TRUSTED_ORIGIN = "www.everestjs.net";
+export const SURFER_PARAM_KEY = "gsurfer";
+export const SURFER_IP = "clientIp";
+
+// Error Messages
+export const ERROR_ID5_PARTNER_ID_REQUIRED = "ID5 partner ID is required";
+export const ERROR_RAMP_ID_MAX_RETRIES =
+  "Failed to retrieve RampID after maximum retries";
+
+// Log Messages
+export const LOG_AD_CONVERSION_START = "Processing ad conversion";
+export const LOG_COOKIE_WRITTEN = "Ad tracking data saved";
+export const LOG_CONVERSION_TIME_UPDATED = "Conversion timing recorded";
+export const LOG_SENDING_CONVERSION = "Submitting ad conversion data";
+export const LOG_ALL_IDS_THROTTLED =
+  "Ad conversion paused to prevent duplicate submissions";
+export const LOG_ALL_IDS_USED = "Ad conversion already processed";
+export const LOG_ID_RESOLVED = "Ad identity available";
+export const LOG_ERROR_RESOLVING_ID = "Unable to obtain ad identity";
+export const LOG_ID_CONVERSION_SUCCESS = "Ad conversion submitted successfully";
+export const LOG_AD_CONVERSION_FAILED = "Ad conversion submission failed";
+export const DISPLAY_CLICK_COOKIE_KEY = "ev_lcc";

package/src/components/Advertising/createComponent.js

@@ -0,0 +1,24 @@
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+export default ({ handleOnBeforeSendEvent, sendAdConversionHandler }) => {
+  return {
+    lifecycle: {
+      onComponentsRegistered() {
+        // Fire-and-forget: don't return the promise so we don't block
+        // the configure command from resolving while waiting for consent.
+        sendAdConversionHandler();
+      },
+      onBeforeEvent: handleOnBeforeSendEvent,
+    },
+  };
+};

package/src/components/Advertising/handlers/clickThroughHandler.js

@@ -0,0 +1,94 @@
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+import {
+  LAST_CLICK_COOKIE_KEY,
+  LAST_CONVERSION_TIME_KEY,
+  LOG_AD_CONVERSION_START,
+  LOG_AD_CONVERSION_FAILED,
+  AD_CONVERSION_CLICK_EVENT_TYPE,
+  TRACKING_CODE,
+  TRACKING_IDENTITIES,
+  LAST_CONVERSION_TIME_KEY_EXPIRES,
+} from "../constants/index.js";
+
+/**
+ * Handles click-through ad conversions
+ * @param {Object} params - All required parameters
+ * @param {Object} params.eventManager - Event manager for creating events
+ * @param {Object} params.cookieManager - Session manager for cookie operations
+ * @param {Object} params.adConversionHandler - Handler for sending ad conversion events
+ * @param {Object} params.logger - Logger instance
+ * @param {string | string[]} params.skwcid - Search keyword click ID
+ * @param {string | string[]} params.efid - EF ID parameter
+ * @param {Object} params.optionsFromCommand - Additional options from command
+ * @returns {Promise} Result of the ad conversion tracking
+ */
+export default async function handleClickThrough({
+  eventManager,
+  cookieManager,
+  adConversionHandler,
+  logger,
+  skwcid: rawSkwcid,
+  efid: rawEfId,
+}) {
+  const skwcid = Array.isArray(rawSkwcid) ? rawSkwcid[0] : rawSkwcid;
+  const efid = Array.isArray(rawEfId) ? rawEfId[0] : rawEfId;
+
+  logger.info(LOG_AD_CONVERSION_START, { skwcid: skwcid, efid });
+
+  const event = eventManager.createEvent();
+  if (
+    typeof skwcid !== "undefined" &&
+    typeof efid !== "undefined" &&
+    skwcid.startsWith("AL!")
+  ) {
+    const clickData = {
+      click_time: Date.now(),
+      skwcid,
+      efid,
+    };
+    cookieManager.setValue(LAST_CLICK_COOKIE_KEY, clickData);
+  }
+
+  const xdm = {
+    _experience: {
+      adcloud: {
+        conversionDetails: {
+          ...(typeof skwcid !== "undefined" && {
+            [TRACKING_CODE]: skwcid,
+          }),
+          ...(typeof efid !== "undefined" && {
+            [TRACKING_IDENTITIES]: efid,
+          }),
+        },
+      },
+    },
+    eventType: AD_CONVERSION_CLICK_EVENT_TYPE,
+    timestamp: new Date().toISOString(),
+  };
+
+  event.setUserXdm(xdm);
+
+  cookieManager.setValue(LAST_CONVERSION_TIME_KEY);
+  cookieManager.setValue(
+    LAST_CONVERSION_TIME_KEY_EXPIRES,
+    Date.now() + 91 * 24 * 60 * 60 * 1000,
+  ); //expires in 91 days
+
+  try {
+    return await adConversionHandler.trackAdConversion({ event });
+  } catch (error) {
+    logger.error(LOG_AD_CONVERSION_FAILED, error);
+    throw error;
+  }
+}

package/src/components/Advertising/handlers/createAdConversionHandler.js

@@ -0,0 +1,50 @@
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+/**
+ * Creates a specialized handler for ad conversion events.
+ * This follows a similar pattern to the media event handling in the StreamingMedia component.
+ */
+export default ({
+  sendEdgeNetworkRequest,
+  consent,
+  createDataCollectionRequest,
+  createDataCollectionRequestPayload,
+  logger,
+}) => {
+  /**
+   * Tracks an ad conversion event by sending it directly to the Edge Network
+   */
+  const trackAdConversion = ({ event }) => {
+    const dataCollectionRequestPayload = createDataCollectionRequestPayload();
+    dataCollectionRequestPayload.addEvent(event);
+    event.finalize();
+    const request = createDataCollectionRequest({
+      payload: dataCollectionRequestPayload,
+    });
+
+    return consent.awaitConsent().then(() => {
+      return sendEdgeNetworkRequest({ request })
+        .then(() => {
+          return { success: true };
+        })
+        .catch((error) => {
+          logger.error("Failed to send ad conversion event", error);
+          throw error;
+        });
+    });
+  };
+
+  return {
+    trackAdConversion,
+  };
+};