@adobe/alloy 2.32.1-beta.0 → 2.33.0-beta.2

package/src/components/ActivityCollector/utils/dom/findClickableElement.js

@@ -0,0 +1,36 @@
+/*
+Copyright 2024 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 isSupportedAnchorElement from "./isSupportedAnchorElement.js";
+import elementHasClickHandler from "./elementHasClickHandler.js";
+import isInputSubmitElement from "./isInputSubmitElement.js";
+import isButtonSubmitElement from "./isButtonSubmitElement.js";
+
+export default (element) => {
+  let node = element;
+  while (node) {
+    // Stop looking when BODY is reached
+    if (node.nodeName && node.nodeName === "BODY") {
+      break;
+    }
+    if (
+      isSupportedAnchorElement(node) ||
+      elementHasClickHandler(node) ||
+      isInputSubmitElement(node) ||
+      isButtonSubmitElement(node)
+    ) {
+      return node;
+    }
+    node = node.parentNode;
+  }
+  return null;
+};

package/src/components/ActivityCollector/utils/dom/getAbsoluteUrlFromAnchorElement.js

@@ -0,0 +1,25 @@
+/*
+Copyright 2024 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 (window, element) => {
+  const base = window.location.href;
+  let href = element.href || "";
+  // Some objects (like SVG animations) can contain a href object instead of a string
+  if (typeof href !== "string") {
+    href = "";
+  }
+  try {
+    return new URL(href, base).href;
+  } catch {
+    return base;
+  }
+};

package/src/components/ActivityCollector/utils/dom/isButtonSubmitElement.js

@@ -0,0 +1,15 @@
+/*
+Copyright 2024 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 (element) => {
+  return element.tagName === "BUTTON" && element.type === "submit";
+};

package/src/components/ActivityCollector/utils/dom/isDownloadLink.js

@@ -0,0 +1,27 @@
+/*
+Copyright 2024 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 trimQueryFromUrl from "../trimQueryFromUrl.js";
+
+export default (downloadLinkQualifier, linkUrl, clickedObj) => {
+  let result = false;
+  if (linkUrl) {
+    if (clickedObj && clickedObj.download) {
+      result = true;
+    } else if (downloadLinkQualifier) {
+      const re = new RegExp(downloadLinkQualifier);
+      const trimmedLinkUrl = trimQueryFromUrl(linkUrl).toLowerCase();
+      result = re.test(trimmedLinkUrl);
+    }
+  }
+  return result;
+};

package/src/components/ActivityCollector/utils/dom/isExitLink.js

@@ -0,0 +1,24 @@
+/*
+Copyright 2024 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 trimQueryFromUrl from "../trimQueryFromUrl.js";
+
+export default (window, linkUrl) => {
+  let result = false;
+  // window.location.hostname should always be defined, but checking just in case
+  if (linkUrl && window.location.hostname) {
+    const currentHostname = window.location.hostname.toLowerCase();
+    const trimmedLinkUrl = trimQueryFromUrl(linkUrl).toLowerCase();
+    result = trimmedLinkUrl.indexOf(currentHostname) < 0;
+  }
+  return result;
+};

package/src/components/ActivityCollector/utils/dom/isInputSubmitElement.js

@@ -0,0 +1,26 @@
+/*
+Copyright 2024 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 (element) => {
+  if (element.tagName === "INPUT") {
+    const type = element.getAttribute("type");
+    if (type === "submit") {
+      return true;
+    }
+    // Image type input elements are considered submit elements.
+    // https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/image
+    if (type === "image" && element.src) {
+      return true;
+    }
+  }
+  return false;
+};

package/src/components/ActivityCollector/utils/dom/isSupportedAnchorElement.js

@@ -0,0 +1,24 @@
+/*
+Copyright 2024 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 (element) => {
+  if (
+    element.href &&
+    (element.tagName === "A" || element.tagName === "AREA") &&
+    (!element.onclick ||
+      !element.protocol ||
+      element.protocol.toLowerCase().indexOf("javascript") < 0)
+  ) {
+    return true;
+  }
+  return false;
+};

package/src/components/ActivityCollector/utils/dom/isSupportedTextNode.js

@@ -0,0 +1,27 @@
+/*
+Copyright 2024 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.
+*/
+
+const unsupportedNodeNames = /^(SCRIPT|STYLE|LINK|CANVAS|NOSCRIPT|#COMMENT)$/i;
+
+/**
+ * Determines if a node qualifies as a supported link text node.
+ * @param {*} node Node to determine support for.
+ * @returns {boolean}
+ */
+export default (node) => {
+  if (node && node.nodeName) {
+    if (node.nodeName.match(unsupportedNodeNames)) {
+      return false;
+    }
+  }
+  return true;
+};

package/src/components/ActivityCollector/utils/hasPageName.js

@@ -0,0 +1,23 @@
+/*
+Copyright 2024 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 (event) => {
+  const content = event.getContent();
+  return (
+    content.xdm !== undefined &&
+    // NOTE: A page view event should "ideally" include the pageViews type
+    // && event.xdm.eventType === "web.webpagedetails.pageViews"
+    content.xdm.web !== undefined &&
+    content.xdm.web.webPageDetails !== undefined &&
+    content.xdm.web.webPageDetails.name !== undefined
+  );
+};

package/src/components/ActivityCollector/utils/isDifferentDomains.js

@@ -0,0 +1,19 @@
+/*
+Copyright 2024 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 extractDomain from "./dom/extractDomain.js";
+
+export default (uri1, uri2) => {
+  const domain1 = extractDomain(uri1);
+  const domain2 = extractDomain(uri2);
+  return domain1 !== domain2;
+};

package/src/components/ActivityCollector/utils/trimQueryFromUrl.js

@@ -0,0 +1,31 @@
+/*
+Copyright 2024 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.
+*/
+
+/**
+ * Trims the query from the URL.
+ * @param {string} url
+ * @returns {string}
+ */
+export default (url) => {
+  const questionMarkIndex = url.indexOf("?");
+  const hashIndex = url.indexOf("#");
+  if (
+    questionMarkIndex >= 0 &&
+    (questionMarkIndex < hashIndex || hashIndex < 0)
+  ) {
+    return url.substring(0, questionMarkIndex);
+  }
+  if (hashIndex >= 0) {
+    return url.substring(0, hashIndex);
+  }
+  return url;
+};

package/src/components/ActivityCollector/utils/truncateWhiteSpace.js

@@ -0,0 +1,22 @@
+/*
+Copyright 2024 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.
+*/
+
+/**
+ * Reduces repeated whitespace within a string. Whitespace surrounding the string
+ * is trimmed and any occurrence of whitespace within the string is replaced with
+ * a single space.
+ * @param {string} str String to be formatted.
+ * @returns {string} Formatted string.
+ */
+export default (str) => {
+  return str && str.replace(/\s+/g, " ").trim();
+};

package/src/components/ActivityCollector/validateClickCollectionConfig.js

@@ -0,0 +1,47 @@
+/*
+Copyright 2024 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.
+*/
+// src/components/ActivityCollector/validateClickCollectionConfig.js
+/*
+Copyright 2024 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 { DEFAULT_DOWNLOAD_QUALIFIER } from "./configValidators.js";
+
+export default (config, logger) => {
+  const {
+    clickCollectionEnabled,
+    onBeforeLinkClickSend,
+    downloadLinkQualifier: dlq,
+  } = config;
+
+  if (clickCollectionEnabled === false) {
+    if (onBeforeLinkClickSend) {
+      logger.warn(
+        "The 'onBeforeLinkClickSend' configuration was provided but will be ignored because clickCollectionEnabled is false.",
+      );
+    }
+
+    if (dlq && dlq !== DEFAULT_DOWNLOAD_QUALIFIER) {
+      logger.warn(
+        "The 'downloadLinkQualifier' configuration was provided but will be ignored because clickCollectionEnabled is false.",
+      );
+    }
+  }
+};

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,
+  };
+};