@glomex/integration-analytics 1.1486.1 → 1.1487.0

package/dist/nielsen/nielsen-event-mapper.d.ts

@@ -1,4 +1,4 @@
-import type { IntegrationElement } from '@glomex/integration-web-component';
+import { type IntegrationElement } from '@glomex/integration-web-component';
 import { BaseEventMapper } from '../base-event-mapper.js';
 import type { NielsenAdMetadata, NielsenContentMetadata, NielsenInstance } from './nielsen-types.js';
 export declare class NielsenEventMapper extends BaseEventMapper {

package/dist/nielsen/nielsen-event-mapper.js

@@ -1,3 +1,4 @@
+import { PlaybackMode } from '@glomex/integration-web-component';
 import { BaseEventMapper } from '../base-event-mapper.js';
 /**
  * Transform metadata to Nielsen format
@@ -144,7 +145,14 @@ export class NielsenEventMapper extends BaseEventMapper {
     get #transformedContentMetadata() {
         return transformMetadata(this.#contentMetadata);
     }
+    get #isLive() {
+        return this.integration.source?.playbackMode === PlaybackMode.LIVE;
+    }
     get #currentTimeInMilliseconds() {
+        // For livestreams, Nielsen requires UTC timestamp per AGF spec
+        if (this.#isLive) {
+            return this.integration.wallClockTime * 1000;
+        }
         const currentTime = this.integration.currentTime ?? 0;
         return Math.floor(currentTime * 1000);
     }

package/dist/nielsen/nielsen-metadata.js

@@ -116,13 +116,17 @@ export function createDeAdMetadataBuilder(options) {
         const channelName = integration.content?.channel?.name ?? '';
         // Universal Ad ID for campaign identification (c1)
         const universalAdId = ad.universalAdIds?.[0]?.id;
+        // Web only flag must match content's web-only status per AGF spec
+        // "N" if content matches linear TV (has externalId or is livestream), "Y" if web-only
+        const externalId = integration.content?.additionalIds?.externalId;
+        const webOnly = externalId || isLive ? 'N' : 'Y';
         return {
             assetid: truncate(ad.id ?? '', 64),
             type: adRollType,
             length: durationInSeconds.toString(),
             title: truncate(ad.id ?? '', 255),
             nol_c1: universalAdId ? truncate(universalAdId, 252) : undefined,
-            nol_c2: 'Y', // optional but always provided
+            nol_c2: webOnly, // must match content's web-only status per AGF spec
             nol_c4: adRollType, // optional but always provided
             nol_c10: truncate(channelName, 251), // 255 - 4 for "p10,"
             nol_c11: truncate(ad.id ?? '', 251), // 255 - 4 for "p11,"

package/dist/sensic/index.d.ts

@@ -15,6 +15,8 @@ export interface SensicOptions {
      * @example 'de' - Germany
      */
     country: string;
+    /** Log level for Sensic SDK console output */
+    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'log' | 'debug';
     /** Optional callback for warning messages */
     warnCallback?: (error: Error) => void;
     /**
@@ -52,15 +54,6 @@ export interface SensicOptions {
      */
     buildStreamId?: (streamId: string) => string;
 }
-/** @deprecated Use SensicOptions instead */
-export interface SensicProviderOptions {
-    /** Sensic media identifier */
-    media: string;
-    /** Platform type: 'web' or 'tv' */
-    platform: 'web' | 'tv';
-    /** Optional callback for warning messages */
-    warnCallback?: (error: Error) => void;
-}
 /**
  * Connects Sensic analytics integration to a turbo player integration.
  *

package/dist/sensic/index.js

@@ -30,7 +30,7 @@ const IAB_VENDOR_SENSIC = '758';
  * ```
  */
 export const connectToSensic = (integration, options) => {
-    const { media, platform, country, warnCallback } = options;
+    const { media, platform, country, logLevel, warnCallback } = options;
     const scriptUrl = buildSensicScriptUrl(country, platform);
     let initializationPromise;
     let currentMapper;
@@ -51,7 +51,8 @@ export const connectToSensic = (integration, options) => {
         initializationPromise = initSensicS2S({
             media,
             url: scriptUrl,
-            type: 'WEB'
+            type: 'WEB',
+            logLevel
         }).catch((error) => {
             onWarn(error instanceof Error ? error : new Error(String(error)));
             return undefined;

package/dist/sensic/sensic-event-mapper.js

@@ -26,7 +26,7 @@ export class SensicEventMapper extends BaseEventMapper {
             return;
         this.#isLive = this.integration.source?.playbackMode === PlaybackMode.LIVE;
         // Create agent with position callback
-        this.#agent = this.#sensicSdk.getAgent(() => this.#isLive ? undefined : this.#currentTimeInMilliseconds);
+        this.#agent = this.#sensicSdk.getAgent(this.#isLive ? undefined : () => this.#currentTimeInMilliseconds);
     }
     onContentImpression() {
         this.#triggerPlay(this.#currentTimeInMilliseconds);
@@ -96,8 +96,8 @@ export class SensicEventMapper extends BaseEventMapper {
         if (!this.#agent)
             return;
         const customParams = this.#buildCustomParams() ?? {};
-        const contentId = 'default'; // Always 'default' as per integration guide
         const isAd = this.isInAd;
+        const contentId = isAd ? 'ad' : 'default';
         const streamId = this.#buildStreamId
             ? this.#buildStreamId()
             : (() => {

package/dist/sensic/sensic-types.d.ts

@@ -1,80 +1,147 @@
 /**
  * Sensic S2S (Server-to-Server) TypeScript Definitions
- * Types for the GfK Sensic streaming measurement SDK
- * @see https://at-config.sensic.net/s2s-web.js
+ * Types aligned with official @gfksensic/s2s-js package (v1.1.3)
+ * @see https://npmreg.sensic.net/@gfksensic/s2s-js
  */
 /**
- * Options passed to play methods for screen and volume state
+ * Configuration for initializing the Sensic SDK via script loading.
+ * Based on InterfaceS2sTagConf from official package, with required `url` for script loading.
  */
-export interface SensicOptions {
+export interface SensicConfig {
+    /** Media identifier provided by Sensic */
+    media: string;
+    /** Application type (e.g., 'WEB', 'APP', 'TV') */
+    type: string;
+    /** URL to the Sensic S2S script (required for script loading) */
+    url: string;
+    /** Application identifier */
+    ai?: string;
+    /** Device type (e.g., 'TABLET', 'SMARTPHONE', 'SMART-TV', 'UNKNOWN') */
+    device?: string;
+    /** Override TCF-based consent determination */
+    optin?: boolean;
+    /** Log level for SDK console output */
+    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'log' | 'debug';
+    /** Custom log URL */
+    logUrl?: string;
+    /** External IDs for cross-device tracking */
+    extID?: {
+        [extIDName: string]: string;
+    };
+    /** Enable crash reporting */
+    crashReporting?: boolean;
+}
+/**
+ * Options passed to play methods for screen, volume, and speed state
+ * Matches InterfaceEventPlayOptions from official package
+ */
+export interface SensicPlayOptions {
     /** Fullscreen state: '1' for fullscreen, '0' for not fullscreen */
-    screen: string;
-    /** Volume level as string (0-100) */
-    volume: string;
+    screen?: string;
+    /** Volume level as string (0-100), or '-1' if not accessible */
+    volume?: string;
+    /** Playback speed (default is 1) */
+    speed?: number;
 }
 /**
  * Custom parameters sent with each play event.
  * The specific keys and values depend on the integration.
  */
 export type SensicCustomParams = Record<string, string>;
+export interface PlayStreamLiveResult {
+    contentId: boolean;
+    streamStart: boolean;
+    streamOffset: boolean;
+    streamId: boolean;
+    options: boolean;
+    customParams: boolean;
+}
+export interface PlayStreamOnDemandResult {
+    contentId: boolean;
+    streamId: boolean;
+    options: boolean;
+    customParams: boolean;
+}
+export interface StopResult {
+    stop: boolean;
+}
+export interface VolumeResult {
+    volume: boolean;
+}
+export interface ScreenResult {
+    screen: boolean;
+}
 /**
  * Sensic streaming agent instance for tracking playback
+ * Matches S2SAgent from official package
  */
 export interface SensicAgent {
-    /**
-     * Update the volume state
-     * @param volume - Volume level as string (0-100)
-     */
-    volume: (volume: string) => void;
-    /**
-     * Update the fullscreen state
-     * @param isFullscreen - '1' for fullscreen, '0' for not fullscreen
-     */
-    screen: (isFullscreen: string) => void;
     /**
      * Start tracking a live stream
-     * @param contentId - Content identifier (usually 'default')
-     * @param contentStart - Content start time (usually empty string)
+     * @param contentId - Content identifier (usually 'default' for content, 'ad' for ads)
+     * @param streamStart - ISO 8601 date string of content start, or empty string for current time
      * @param streamOffset - Offset from live edge in milliseconds
-     * @param streamId - Stream/content title
-     * @param options - Screen and volume options
+     * @param streamId - Stream identifier (must be unique per stream)
+     * @param options - Screen, volume, and speed options
      * @param customParams - Custom tracking parameters
+     * @returns Validation result for each parameter
      */
-    playStreamLive: (contentId: string, contentStart: string, streamOffset: number, streamId: string, options: SensicOptions, customParams: Record<string, string>) => void;
+    playStreamLive: (contentId: string, streamStart: string, streamOffset: number, streamId: string, options: SensicPlayOptions, customParams: object) => PlayStreamLiveResult;
     /**
-     * Start tracking an on-demand stream
-     * @param contentId - Content identifier (usually 'default')
-     * @param streamId - Stream/content title
-     * @param position - Current playback position in milliseconds
-     * @param options - Screen and volume options
+     * Start tracking an on-demand stream (without explicit position)
+     * Position will be determined from streamPositionCallback
+     * @param contentId - Content identifier (usually 'default' for content, 'ad' for ads)
+     * @param streamId - Stream identifier (must be unique per stream)
+     * @param options - Screen, volume, and speed options
      * @param customParams - Custom tracking parameters
+     * @returns Validation result for each parameter
      */
-    playStreamOnDemand: (contentId: string, streamId: string, position: number, options: SensicOptions, customParams: Record<string, string>) => void;
+    playStreamOnDemand(contentId: string, streamId: string, options: SensicPlayOptions, customParams: object): PlayStreamOnDemandResult;
+    /**
+     * Start tracking an on-demand stream (with explicit position)
+     * @param contentId - Content identifier (usually 'default' for content, 'ad' for ads)
+     * @param streamId - Stream identifier (must be unique per stream)
+     * @param streamPosition - Current playback position in milliseconds
+     * @param options - Screen, volume, and speed options
+     * @param customParams - Custom tracking parameters
+     * @returns Validation result for each parameter
+     */
+    playStreamOnDemand(contentId: string, streamId: string, streamPosition: number, options: SensicPlayOptions, customParams: object): PlayStreamOnDemandResult;
     /**
      * Stop tracking playback
-     * @param position - Current playback position in milliseconds (undefined for live)
+     * @param streamPosition - Current playback position in milliseconds (optional, uses callback if not provided)
+     * @returns Validation result
      */
-    stop: (position?: number) => void;
-}
-/**
- * Configuration for initializing the Sensic SDK
- */
-export interface SensicConfig {
-    /** Media identifier provided by Sensic */
-    media: string;
-    /** URL to the Sensic S2S script */
-    url: string;
-    /** Device type (e.g., 'WEB') */
-    type: string;
+    stop: (streamPosition?: number) => StopResult;
+    /**
+     * Update the volume state
+     * @param volume - Volume level as string (0-100), or '-1' if not accessible
+     * @returns Validation result
+     */
+    volume: (volume: string) => VolumeResult;
+    /**
+     * Update the fullscreen state
+     * @param screen - '1' for fullscreen, '0' for not fullscreen
+     * @returns Validation result
+     */
+    screen: (screen: string) => ScreenResult;
+    /**
+     * Set or update the stream position callback
+     * @param callback - Function that returns current position in milliseconds
+     */
+    setStreamPositionCallback?: (callback: () => number) => void;
 }
 /**
- * Global Sensic SDK interface
+ * Global Sensic SDK interface (available on window.gfkS2s after script load)
  */
 export interface SensicGlobal {
     /**
      * Get a streaming agent for tracking playback
-     * @param agentArg - Callback that returns current position (undefined for live)
+     * @param callback - Callback that returns current position in milliseconds (undefined for live)
+     * @param pId - Optional player identifier
      * @returns A SensicAgent instance for tracking
      */
-    getAgent: (agentArg: () => number | undefined) => SensicAgent;
+    getAgent: (callback?: () => number | undefined, pId?: string) => SensicAgent;
+    /** Array of active agents */
+    agents?: SensicAgent[];
 }

package/dist/sensic/sensic-types.js

@@ -1,6 +1,6 @@
 /**
  * Sensic S2S (Server-to-Server) TypeScript Definitions
- * Types for the GfK Sensic streaming measurement SDK
- * @see https://at-config.sensic.net/s2s-web.js
+ * Types aligned with official @gfksensic/s2s-js package (v1.1.3)
+ * @see https://npmreg.sensic.net/@gfksensic/s2s-js
  */
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glomex/integration-analytics",
-  "version": "1.1486.1",
+  "version": "1.1487.0",
   "description": "Analytics integrations for the turbo player",
   "documentation": "https://docs.glomex.com",
   "homepage": "https://glomex.com",
@@ -63,5 +63,5 @@
     "access": "public"
   },
   "license": "MIT",
-  "gitHead": "60e468bf5548cb0fa6d38e9ae0435ccdd589f5fa"
+  "gitHead": "efe6bfb544aebc668df8d533f1660273a1447294"
 }