What the SIGNAL integration layer is for
SIGNAL is the measurement and activation layer between brand activity and AI behavior. Its integration surface is designed for organizations that need the same intelligence visible in SIGNAL to participate in existing enterprise workflows: dashboards, warehouse pipelines, client reporting, internal agents, campaign operations and governance systems.
Read intelligence
Consume AI demand, prompt and intent trends, brand visibility, recommendations, citations, competitive position and influential-source observations produced by InnMedia Intelligence.
Read first-party analytics
Bring crawler and agent activity, retrieved-content observations, AI referrals, conversions and downstream business outcomes from InnMedia Analytics into internal reporting.
Read verification evidence
Use audit outputs, methodology metadata, confidence, baseline/post-campaign comparisons and AI-access-policy findings from InnMedia Verify in governance and client evidence workflows.
Connect activation
Link approved campaign and distribution workflows to SIGNAL Ads and Distribution while keeping measurement and verification connected to the same operating context.
This page documents the public integration model and the data families exposed to authorized SIGNAL customers. It does not publish anonymous production credentials or invent undocumented endpoint paths. Exact base URLs, scopes and account-specific credentials are provisioned through your SIGNAL workspace.
Getting started
A typical enterprise integration starts with the organization and measurement scope, not with a single isolated API call. SIGNAL needs to know what you are measuring, which digital properties belong to the organization, which brands/markets should be separated, and where the resulting data should be delivered.
- Create or join your SIGNAL organization.
Use the SIGNAL application to establish the organization that owns the measurement and integration context. - Define the entities you want to measure.
Brands, products, competitors, markets, languages and digital properties become the stable context for intelligence, analytics and verification. - Connect first-party properties where required.
Analytics and AI-access auditing depend on authorized data from the digital properties being measured. - Choose the data families your workflow needs.
For example: answer intelligence for a BI dashboard, crawler observations for a data warehouse, or verification evidence for client reporting. - Provision integration access.
Access is account-scoped. Your workspace provides the environment-specific authentication and permissions required for the approved integration. - Map SIGNAL objects into your downstream schema.
Preserve entity IDs, observation timestamps, methodology/evidence references and dimensions so downstream analysis remains reproducible. - Validate before automating decisions.
Confirm the intended market, model/source context, time window and evidence scope before using SIGNAL outputs in automated business logic.
Core concepts
Organization
The top-level customer/account boundary used for access, permissions, properties, brands and reporting context.
Entity
A stable subject of measurement such as a brand, product, competitor, category, market or digital property.
Observation
A measured event or result at a point in time — for example an AI answer observation, crawler request, referral, conversion or policy check.
Dimension
The context used to segment an observation: AI environment, query/intent, market, language, property, source, campaign, device or time window where applicable.
Evidence
The supporting material and metadata that make a verification or measurement result auditable rather than just a dashboard number.
Methodology version
The measurement logic associated with a result. Preserving methodology versioning matters when comparing periods or using results for independent verification.
Resource families
| Family | What it represents | Typical downstream use |
|---|---|---|
| Intelligence | AI demand, prompt/intent trends, visibility, recommendations, citations, competitors and source influence. | Market intelligence, brand dashboards, competitive monitoring, planning. |
| Analytics | AI crawlers and agents, content retrieval, AI referrals, conversions and revenue/outcomes. | Data warehouse, web intelligence, content strategy, attribution. |
| Verify | Independent campaign/AI-access audits, baseline comparisons, confidence, methodology and evidence. | Client proof, procurement, audit, governance, vendor verification. |
| Ads | Campaign planning, delivery, budget/performance and attribution context across supported AI advertising environments. | Media operations, cross-channel reporting, optimization workflows. |
| Distribution | Authoritative structured brand information and delivery state across publisher and agent-ready channels. | Content operations, machine-readable delivery, provenance and citation monitoring. |
Access and authentication
SIGNAL integration access is scoped to an authorized organization. Production credentials are not embedded in public documentation and should never be placed in browser code, public repositories, screenshots or client-side analytics payloads.
- Server-side by default.
Use integration credentials from trusted backend, serverless, data-platform or workflow environments rather than exposing them in public frontend code. - Least privilege.
Request only the data families and organization scope required for the integration. - Separate environments.
Keep development/testing and production credentials isolated when your account provides separate environments. - Rotate and revoke.
Treat credentials as operational secrets and replace them when access changes or exposure is suspected.
The exact credential format and authorization scopes are supplied with provisioned API access. This public guide deliberately does not fabricate a universal header name or token format.
Data model: keep context with the number
AI measurement is easy to misuse if a downstream system keeps the score but drops the context. Integrations should preserve enough metadata to answer: what was measured, for whom, where, when, under which methodology, and with what supporting evidence?
| Field class | Examples of information to preserve |
|---|---|
| Identity | Organization, entity, property, brand/product/category identifiers. |
| Measurement context | AI environment, query/intent, market, language, source, campaign or property. |
| Time | Observed timestamp, reporting period, baseline/post period where relevant. |
| Metric | Metric name, value, unit/ratio, comparison value and direction where available. |
| Methodology | Observed/modeled/verified classification, methodology version, confidence where applicable. |
| Evidence | Evidence reference, source/citation context, audit or provenance link where applicable. |
Common integration workflows
Executive AI visibility dashboard
Combine category demand, brand visibility, share of voice, recommendations, citation/source influence and competitive changes into an executive BI view. Use stable entity and market dimensions so period-over-period changes remain comparable.
AI crawler → referral → outcome analysis
Join first-party crawler/agent observations with AI referrals and business outcomes to understand the relationship between machine access and downstream human discovery. Do not assume a crawler request is itself a conversion or direct attribution event.
Independent agency/campaign evidence
Pull baseline and post-campaign verification outputs into client reporting while preserving methodology, evidence and confidence context. This keeps vendor-reported performance separate from independently measured results.
Agent-ready information operations
Coordinate authoritative information prepared for publisher, Web, API, MCP, A2A, Mobile and TRUYN delivery with provenance and citation monitoring. Distribution is the information supply layer; measurement remains connected through Intelligence and Analytics.
Evidence, provenance and reproducibility
SIGNAL Verify is designed around independent evidence rather than self-reported success. When integration consumers use verified outputs, they should retain the identifiers and methodology context necessary to trace a reported conclusion back to its supporting evidence.
Do preserve
Observation time, entity scope, methodology/version, comparison window, confidence where available, evidence reference and relevant source context.
Do not collapse
Do not convert observed, modeled and independently verified values into a single unlabeled metric. They answer different questions and carry different evidentiary weight.
Integration and delivery patterns
SIGNAL participates in several machine-readable delivery patterns. The correct pattern depends on whether your system is consuming measurement data, receiving event-style updates, building a governed internal dashboard, or exposing authoritative information to software agents.
Enterprise API
Structured programmatic access for authorized systems and data workflows.
Web and BI workflows
Use SIGNAL outputs inside dashboards, reporting pipelines and operational interfaces.
MCP
Agent-oriented integration for tool-aware AI environments where MCP is the selected delivery contract.
A2A
Agent-to-agent delivery for workflows designed around interoperable software-agent communication.
Mobile
Mobile delivery surfaces for approved consumer and enterprise experiences.
TRUYN
Distribution through the Truyn Network where the configured workflow uses that channel.
Web, API, MCP, A2A, Mobile and TRUYN are part of the current SIGNAL Distribution delivery model. Availability and account scope depend on the product configuration provisioned to the customer.
Illustrative data examples
The examples below show the shape of information an enterprise integration should preserve. They are intentionally not presented as undocumented production endpoint contracts.
{
"entity": { "type": "brand", "name": "Example Brand" },
"market": "example-market",
"period": { "from": "…", "to": "…" },
"measurement": {
"metric": "ai_visibility",
"value": 72.4,
"comparison": { "direction": "up", "change": 8.7 }
},
"context": {
"intent": "enterprise purchase intent",
"methodology": "versioned",
"evidence": "reference retained"
}
}{
"audit": "campaign-or-ai-access",
"entity": "Example Brand",
"comparison": {
"baseline": "retained",
"post_period": "retained"
},
"result": {
"classification": "independently_verified",
"confidence": "retained when applicable"
},
"methodology_version": "retained",
"evidence_reference": "retained"
}Governance and security expectations
- Keep tenant boundaries explicit.
Do not mix brands, subsidiaries, clients or markets merely because they share one reporting destination. - Keep provenance attached.
When data leaves SIGNAL, retain the fields required to explain where a result came from and how it was measured. - Separate measurement from activation permissions.
A team allowed to read analytics should not automatically gain authority to change media or distribution operations. - Protect credentials and exported evidence.
API secrets belong in secret-management systems; evidence may contain business-sensitive information and should follow your organization's access policy.
Connect SIGNAL to your data stack.
Tell us which SIGNAL modules, entities, markets and downstream systems you need to connect. We will provision the appropriate account-scoped integration surface rather than exposing generic public credentials.