Interface NormalizedDiscoveredSignal

Type Declaration

• Optionalrestricted_attributes?: RestrictedAttribute[]

  Restricted attribute categories this signal touches.

• Optionalpolicy_categories?: string[]

  Policy categories this signal is sensitive for.

• Optionaltaxonomy?: {
      ref: string;
      version?: string;
      segtax?: number;
      etag?: string;
      values: { id: string; path?: string; modifiers?: string[] }[];
      value_mappings?: {
          value: string;
          taxonomy_value_id: string;
          path?: string;
          modifiers?: string[];
      }[];
      parent_match_behavior?: "unknown"
      | "exact_only"
      | "descendants_supported";
  }

  Optional taxonomy metadata describing what this signal means in an external audience, content, retail-media, or provider-owned taxonomy.

• Optionalsegmentation_criteria?: string

• Optionalcriteria_url?: string

• Optionaldata_sources?: (
      | "email"
      | "app_behavior"
      | "app_usage"
      | "web_usage"
      | "geo_location"
      | "tv_ott_or_stb_device"
      | "panel"
      | "online_ecommerce"
      | "credit_data"
      | "loyalty_card"
      | "transaction"
      | "online_survey"
      | "offline_survey"
      | "public_record_census"
      | "public_record_voter_file"
      | "public_record_other"
      | "offline_transaction"
  )[]

• Optionalmethodology?: "modeled" | "observed" | "declared" | "derived" | "inferred"

• Optionalaudience_expansion?: boolean

• Optionaldevice_expansion?: boolean

• Optionalrefresh_cadence?:
      | "daily"
      | "weekly"
      | "monthly"
      | "quarterly"
      | "intra_day"
      | "bi_monthly"
      | "bi_annually"
      | "annually"

• Optionallookback_window?:
      | "daily"
      | "weekly"
      | "monthly"
      | "quarterly"
      | "intra_day"
      | "bi_monthly"
      | "bi_annually"
      | "annually"

• Optionalonboarder?: {
      match_keys: (
          | "email"
          | "name"
          | "address"
          | "postal"
          | "lat_long"
          | "mobile_id"
          | "cookie_id"
          | "ip"
          | "customer_id"
          | "phone"
      )[];
      pre_onboarding_audience_expansion?: boolean;
      pre_onboarding_device_expansion?: boolean;
      pre_onboarding_precision_level?: | "individual"
      | "household"
      | "business"
      | "geography";
  }

• Optionalcountries?: string[]

• Optionalconsent_basis?: ConsentBasis[]

  Data provider's declared GDPR Article 6 lawful basis or consent basis for the underlying signal definition, projected into this get_signals response row when requested. Sellers and federating agents that pass through another provider's signal MUST NOT substitute their own processing basis for the provider-declared basis.

• Optionalart9_basis?:
      | "explicit_consent"
      | "manifestly_made_public"
      | "substantial_public_interest"
      | "vital_interests"

  Data provider's declared GDPR Article 9 basis for the underlying signal definition when special-category data is involved and Article 9 applies, projected into this get_signals response row when requested. Sellers and federating agents that pass through another provider's signal MUST NOT substitute their own Article 9 basis for the provider-declared basis.

• Optionalmodeling?: {
      method: "lookalike" | "supervised" | "embedding" | "rules";
      seed_source: {
          type:
              | "panel"
              | "first_party_crm"
              | "declared_survey"
              | "transactional"
              | "behavioral";
          provider_signed: boolean;
      };
      training_data_jurisdictions: string[];
      ai_act_risk_class: "minimal"
      | "limited"
      | "high_risk";
      disclosure?: SignalModelingDisclosure;
  }

  • method: "lookalike" | "supervised" | "embedding" | "rules"

  • seed_source: {
        type:
            | "panel"
            | "first_party_crm"
            | "declared_survey"
            | "transactional"
            | "behavioral";
        provider_signed: boolean;
    }

    • type: "panel" | "first_party_crm" | "declared_survey" | "transactional" | "behavioral"

    • provider_signed: boolean

      Provider assertion that the seed source carries a signed attestation. Consumers MUST NOT treat this boolean alone as cryptographic proof.

  • training_data_jurisdictions: string[]

  • ai_act_risk_class: "minimal" | "limited" | "high_risk"

  • Optionaldisclosure?: SignalModelingDisclosure

• Optionaldata_subject_rights?: {
      upstream_source_domain?: string;
      channels: {
          rights: (
              "access"
              | "rectification"
              | "erasure"
              | "portability"
              | "objection"
          )[];
          url?: string;
          email?: string;
          languages?: string[];
          countries?: string[];
      }[];
      response_sla_days?: number;
      ccpa_opt_out_url?: string;
  }

  Per-signal data-subject-rights routing. This is a contact/routing reference, not a machine-callable AdCP API.

• Optionallast_updated?: string

  When this listing record was last updated. This indicates freshness of the listing record, not an attestation that the underlying data or model was refreshed at that time.

• Optionaldts_compliant_version?: string

• Optionalsignal_ref?: SignalRef

• Optionalsignal_id?: SignalID

• name: string

  Human-readable signal name

• description: string

  Detailed signal description

• Optionalmethodology_url?: string

  Optional link to published methodology, media-kit, or data documentation. For data_provider and signal_source refs, this SHOULD match or supplement the referenced definition.

• Optionalvalue_type?: SignalValueType

• Optionalcategories?: string[]

  Valid values for categorical signals. Present when value_type is 'categorical'. Buyers must use one of these values in SignalTargeting.values.

• Optionalrange?: { min: number; max: number }

  Valid range for numeric signals. Present when value_type is 'numeric'.

  • min: number

    Minimum value (inclusive)

  • max: number

    Maximum value (inclusive)

• signal_agent_segment_id: string

  Opaque resolved-segment handle issued by this signal source. Pass this string verbatim to activate_signal.signal_agent_segment_id, and echo it in package signal targeting when the selected product option exposes the same handle. Treat the value as provider-scoped and opaque: providers MAY namespace it so two providers can expose similarly named signals without relying on a shared taxonomy. Do not pass the signal_id object as this handle, and do not reconstruct a segment handle from categorical values when get_signals returned a resolved segment.

• signal_type: SignalAvailabilityType

• Optionaldata_provider?: string

  Human-readable source name for the signal, when applicable. For data_provider-scoped signals this is the data provider name; for signal_source-scoped signals it may identify the signal source or proprietary origin.

• Optionalcoverage_percentage?: number

  Deprecated

  DEPRECATED for detailed planning. Optional legacy scalar percentage of audience coverage retained only as a fallback for clients that do not consume coverage_forecast. When coverage_forecast is present, coverage_forecast is authoritative for signal-level discovery and coverage_percentage is fallback-only. If coverage_forecast includes an absent bucket over the same denominator, coverage_percentage SHOULD align with 100 * (1 - absent coverage_rate.mid).

  Minimum

  0

  Maximum

  100

• Optionalcoverage_forecast?: SignalCoverageForecast

• deployments: Deployment[]

  Array of deployment targets

• Optionalpricing_options?: VendorPricingOption[]

  Pricing options available for this signal when it has an incremental price. The buyer selects one and passes its pricing_option_id in report_usage or package-level signal_targeting_groups for billing verification. Omit when pricing is unavailable to the caller, bundled into the destination product, or has no incremental cost.