Ellipse Gradient for Header

Adobe Analytics Integration Guide

Connect Adobe Analytics 2.0 REST APIs with enterprise applications, databases, files, and reporting workflows using OAuth 2.0 and Martini.

Adobe Analytics integration options at a glance

Adobe Analytics primarily integrates through its 2.0 REST APIs, including reporting, components, segments, calculated metrics, classifications, and administration capabilities. OAuth 2.0 server-to-server credentials from Adobe Developer Console provide the current authentication model. Martini can run scheduled workflows that submit reports, poll asynchronous jobs, transform dimensions and metrics, and write results to databases, files, or downstream applications. For larger or more granular datasets, Data Feeds, Data Warehouse exports, and Bulk Data Insertion support file-oriented and batch processing. Adobe Analytics 1.4 SOAP-based APIs remain relevant only for legacy migration scenarios; a general Analytics webhook mechanism was not confirmed.

Integration pointSupported by Adobe Analytics?Common use casesHow Martini supports it
REST APIsYesAdobe Analytics 2.0 REST APIs support report suites, reports, dimensions, metrics, segments, calculated metrics, classifications, and administration capabilities.Martini can consume REST APIs from workflows, configure OAuth 2.0 credentials, transform responses, and route results to applications, databases, files, or exposed APIs.
AuthenticationYesAdobe Developer Console OAuth 2.0 server-to-server credentials provide bearer tokens alongside the client identifier and Adobe organization identifier.Martini can store client secrets, tokens, organization identifiers, and API keys in environment configuration or secrets and apply them to REST requests.
Bulk / async / batch APIsYesReports and larger data operations may be queued or asynchronous; Bulk Data Insertion supports batch ingestion into Adobe Analytics.Martini can submit jobs or batches, persist request identifiers, poll status with bounded retries, retrieve results, and prevent duplicate processing.
File / attachment APIsLimitedData Feeds, Data Warehouse exports, and bulk ingestion provide file-oriented exchange for granular or scheduled data. Adobe Analytics does not provide a general attachment API.Martini can process delivered files, validate schemas and intervals, transform rows, and load the results into databases or downstream platforms.
Database / analytics accessLimitedAdobe Analytics data is accessed through reporting and export services rather than a general-purpose operational SQL connection.Martini can retrieve or process Analytics data and write it to a supported SQL database, but does not connect directly to an Adobe Analytics database.
SOAP APIsLegacyAdobe Analytics 1.4 includes older SOAP-based and legacy API patterns that may require migration for existing implementations.Martini can consume SOAP services where required, but new Adobe Analytics integrations should use the 2.0 REST APIs.
Webhooks / outbound callbacksNot confirmedA generally available Adobe Analytics webhook or outbound callback mechanism for report-suite changes or report completion was not confirmed.Martini should use scheduled workflows and API polling unless the specific Adobe event provider and event type are separately verified.
GraphQL APIsNot confirmedNo official Adobe Analytics GraphQL API was confirmed in the reviewed documentation.Martini can consume GraphQL APIs generally, but this Adobe Analytics integration should use the confirmed REST interfaces instead.

How Adobe Analytics exposes data and business events

Adobe Analytics REST APIs

Adobe Analytics 2.0 provides REST APIs for report suites, reports, dimensions, metrics, segments, calculated metrics, classifications, administration, and related data operations. Reporting requests may return aggregated data and can involve response-size or processing constraints.

Martini implementation pattern

Martini uses an authenticated workflow to call the relevant Adobe Analytics endpoint, submit a report or component request, handle pagination or asynchronous processing, transform the response, and route the result to an application, database, file, or Martini API.

Implementation sequence

Load OAuth 2.0 credentials and Adobe identifiers from secure configuration
Validate the report suite and configured component identifiers
Submit the report or component request
Poll the operation when Adobe returns an asynchronous job
Retrieve and validate the response
Map dimensions and metrics to the target model and write the result

Adobe Analytics asynchronous and batch processing

Adobe Analytics supports queued or asynchronous processing for some report and batch-oriented operations. Bulk Data Insertion and larger export processes require explicit handling of submission, status, results, and validation.

Martini implementation pattern

Martini models the operation as a durable workflow state, records request or batch identifiers, polls with bounded intervals and backoff, branches on completion or failure, and stores the final outcome for restartability and duplicate prevention.

Implementation sequence

Create the report, export, or ingestion request
Store the Adobe request or batch identifier
Wait using a bounded polling interval
Retrieve status and branch on running, completed, failed, or timed-out states
Retrieve results or validation details
Persist the processing outcome and source key

Adobe Analytics Data Feeds and exports

Data Feeds and Data Warehouse provide file-oriented paths for granular or larger scheduled extracts. These exchanges are distinct from ordinary aggregated Reporting API responses and may require Adobe configuration, delivery settings, and permissions.

Martini implementation pattern

Martini runs or coordinates a scheduled file-processing workflow, validates the expected file, date interval, report suite, and schema, transforms rows into a target model, and loads them into a database or analytics platform.

Implementation sequence

Determine the expected export interval and processing key
Locate or receive the configured export file
Validate file completeness, schema, and reporting period
Transform and normalize rows
Load the result into the target data platform
Record the file identifier and mark the interval as processed

Adobe Analytics Bulk Data Insertion

The Bulk Data Insertion API can accept data into Adobe Analytics where the implementation and permissions support it. The workflow must conform to Adobe’s required format and account for batching, required fields, validation, and duplicate prevention.

Martini implementation pattern

Martini receives events from an enterprise source, validates timestamps and identity fields, maps them to Adobe’s ingestion structure, submits bounded batches, and handles Adobe validation or retry responses without unintentionally duplicating events.

Implementation sequence

Receive or retrieve source events
Validate required event, timestamp, and identity fields
Map events to the Adobe ingestion format
Submit a bounded batch to Adobe Analytics
Inspect validation and ingestion results
Record the source batch outcome and isolate rejected rows

Adobe Analytics 1.4 SOAP APIs

Adobe Analytics 1.4 represents an older API generation with SOAP-based and legacy patterns. It is relevant mainly when an existing implementation must be maintained or migrated to Analytics 2.0.

Martini implementation pattern

Where a legacy dependency is unavoidable, Martini can consume the SOAP service through a workflow, transform the legacy response, and isolate it behind a reusable integration boundary while a migration plan is developed.

Implementation sequence

Identify the legacy operation and required permissions
Load SOAP configuration and credentials securely
Call the legacy service from the workflow
Validate and transform the response
Route the result to the target system
Record legacy usage and migration considerations

Common Adobe Analytics integration patterns

Pattern 1: Export scheduled Adobe Analytics reports

When to use this pattern

Use this pattern for daily or periodic performance reporting when aggregated dimensions and metrics are sufficient. It supports executive dashboards, marketing analysis, and downstream operational reporting.

Integration direction
Adobe Analytics
Martini
Snowflake
Example Mapping
Adobe Analytics FieldCanonical FieldTarget Field
reportSuiteIdanalytics.reportSuiteIdsource_report_suite
dimension itemanalytics.dimensionValuedimension_value
metric valueanalytics.metricValuemetric_value
date rangeanalytics.reportingPeriodreporting_period
Martini implementation pattern

A scheduler-triggered Martini workflow validates the report definition, submits the request, polls if required, maps dimensions and metrics into a stable reporting model, applies date and attribution rules, and loads the result into Snowflake. It records the report definition and interval as an idempotency key and routes authentication, permission, rate-limit, and oversized-report failures separately.

Martini capabilities used
  • workflows
  • scheduled execution
  • API consumption
  • data mapping
  • business rules
  • error handling

Pattern 2: Synchronize Analytics metrics with Salesforce

When to use this pattern

Use this pattern when CRM users need campaign, engagement, or conversion measures alongside Salesforce data. Analytics aggregates should be mapped to defined CRM fields rather than treated as Salesforce records.

Integration direction
Adobe Analytics
Martini
Salesforce
Example Mapping
Adobe Analytics FieldCanonical FieldTarget Field
tracking codecampaign.externalKeyCampaign.External_Key__c
revenuecampaign.attributedRevenueCampaign.Attributed_Revenue__c
visitscampaign.visitsCampaign.Analytics_Visits__c
reporting periodcampaign.periodCampaign.Analytics_Period__c
Martini implementation pattern

Martini retrieves a controlled report, joins classification values where needed, resolves Salesforce campaign keys, and writes updates through the target API. Business rules reject ambiguous keys, preserve the Analytics reporting period, and use deterministic keys and bounded retries to avoid duplicate updates.

Martini capabilities used
  • workflows
  • API consumption
  • data mapping
  • data transformation
  • business rules
  • retry handling

Pattern 3: Load granular exports into a data platform

When to use this pattern

Use this pattern when aggregated Reporting API results are insufficient and the organization needs hit-level or more detailed data for governed analysis.

Integration direction
Adobe Analytics
Martini
Databricks
Example Mapping
Adobe Analytics FieldCanonical FieldTarget Field
export file datebatch.processingDateingestion_date
report suiteanalytics.reportSuiteIdsource_suite
event timestampevent.occurredAtevent_timestamp
classification valueevent.campaignCategorycampaign_category
Martini implementation pattern

Martini coordinates the Data Feed or Data Warehouse export, validates the file and processing interval, transforms rows into the lakehouse schema, and stages them for Databricks. The workflow tracks file and interval keys, quarantines invalid rows, and supports restart without reloading an already completed batch.

Martini capabilities used
  • scheduled workflows
  • file processing
  • data mapping
  • validation
  • database or platform integration
  • error handling

Pattern 4: Send external events through Bulk Data Insertion

When to use this pattern

Use this pattern when an application or enterprise source must submit supported event data into Adobe Analytics and the configured implementation permits Bulk Data Insertion.

Integration direction
Application
Martini
Adobe Analytics
Example Mapping
Adobe Analytics FieldCanonical FieldTarget Field
event timestampevent.occurredAtAdobe event timestamp
visitor identifiervisitor.idAdobe visitor identity field
event typeevent.nameAdobe event or metric field
source batch IDbatch.idAdobe batch tracking context
Martini implementation pattern

Martini receives source events through an API or scheduled extraction, validates required fields and timestamps, maps events to Adobe’s ingestion format, submits bounded batches, and records accepted and rejected outcomes. Source batch identifiers and validation results support retry decisions and duplicate prevention.

Martini capabilities used
  • API exposure
  • workflows
  • data validation
  • data mapping
  • batch orchestration
  • error handling

Applications commonly integrated with Adobe Analytics

Adobe Analytics data is commonly combined with Adobe products, CRM platforms, business intelligence tools, and data platforms. Martini can orchestrate these exchanges through REST APIs, scheduled workflows, file pipelines, and intermediate databases without treating aggregated Analytics results as direct equivalents of operational application records.

Application Scenario Direction Martini Pattern
Adobe Experience Platform Combine Analytics data with broader customer, identity, and profile data for analysis or activation. Adobe Analytics → Martini → Adobe Experience Platform Martini retrieves reports or export files, validates the reporting interval and schema, maps Analytics dimensions and metrics to the target ingestion model, and submits or stages the result through the configured Adobe services.
Adobe Target Use Analytics reporting and segments alongside personalization and experimentation results. Adobe Analytics → Martini → Adobe Target A Martini workflow retrieves selected segments, metrics, or campaign results, applies eligibility and time-window rules, and exchanges the normalized data with the configured Adobe Target integration endpoints.
Adobe Campaign Combine digital behavior data with campaign execution, segmentation, and campaign measurement. Adobe Analytics → Martini → Adobe Campaign Martini schedules Analytics report retrieval, maps campaign and engagement dimensions to Campaign data structures, validates component availability, and sends the result through the configured API or file exchange.
Salesforce Enrich CRM and marketing processes with digital engagement, campaign, and conversion metrics. Adobe Analytics → Martini → Salesforce Martini retrieves aggregated Analytics results, applies reporting-period and attribution rules, maps campaign or account keys to Salesforce fields, and writes updates through Salesforce APIs with retry and duplicate controls.
Microsoft Power BI Build operational or executive dashboards from Adobe Analytics reports or exported datasets. Adobe Analytics → Martini → Microsoft Power BI A scheduled Martini workflow submits reports or processes export files, converts them into a stable analytical schema, and publishes or stages the result for Power BI consumption.
Tableau Analyze Adobe Analytics data alongside CRM, commerce, and financial information. Adobe Analytics → Martini → Tableau Martini retrieves reports or granular exports, normalizes dates, dimensions, metrics, and classifications, then loads the result into a Tableau-accessible database or file location.
Snowflake Centralize granular Analytics exports with other enterprise data for governed analysis. Adobe Analytics → Martini → Snowflake Martini orchestrates Data Feed or Data Warehouse processing, validates files and processing keys, transforms the data, and loads it into Snowflake using a staged or database-mediated pipeline.
Databricks Process granular digital-event data with other lakehouse workloads and machine-learning pipelines. Adobe Analytics → Martini → Databricks Martini coordinates export availability, validates and transforms delivered files, tracks batch status, and stages the resulting data for Databricks ingestion.

How to build a Adobe Analytics integration in Martini

Objective

Establish Adobe Developer Console OAuth 2.0 access and confirm that the project has the required Adobe Analytics product profile, report-suite access, and component permissions.

Instructions in Martini

  • Configure the Adobe client identifier, organization identifier, client secret, and token handling through Martini secrets or environment configuration.
  • Use the Adobe Analytics 2.0 REST API as the default interface.
  • Validate access with a low-risk report-suite or component request.

Objective

Select a schedule or API-driven entry point based on whether the integration extracts reports, processes files, or ingests external events.

Instructions in Martini

  • Use a scheduler for recurring reports, Data Warehouse extracts, and Data Feed processing.
  • Use a Martini API when an enterprise system submits data for Bulk Data Insertion.
  • Do not assume Adobe Analytics provides a general webhook trigger.

Objective

Call Adobe Analytics, submit the required report or batch operation, and handle pagination, asynchronous status, and result retrieval.

Instructions in Martini

  • Validate report suite, dimension, metric, segment, and classification identifiers.
  • Persist request, export, or batch identifiers.
  • Use bounded polling and explicit timeout and failure branches.

Objective

Convert Adobe Analytics dimensions, metrics, classifications, and export rows into a canonical model suitable for the target system.

Instructions in Martini

  • Normalize dates, time zones, numeric values, identifiers, and reporting periods.
  • Join classifications or reference data where required.
  • Preserve source identifiers and report definitions for traceability.

Objective

Apply business and data-quality rules before writing or submitting data.

Instructions in Martini

  • Reject unavailable components, ambiguous target keys, invalid timestamps, and malformed files.
  • Define whether the workflow uses finalized, near-real-time, or revisable data.
  • Mask or filter sensitive identifiers according to organizational policy.

Objective

Deliver normalized results to a database, data platform, file, CRM, marketing application, or exposed Martini API.

Instructions in Martini

  • Use deterministic keys for report intervals, files, batches, and target updates.
  • Separate aggregated reporting outputs from operational application objects.
  • Commit or publish only after validation succeeds.

Common Adobe Analytics data objects used in integrations

ObjectTypical UseCommon target systemsMartini handling
Report SuitesDefine Analytics data containers, permissions, time zones, and available reporting data.Martini workflows, data warehouses, Power BI, Tableau, SalesforceMartini can list accessible report suites, validate configured identifiers, and use the selected suite as a workflow input and processing key.
ReportsRequest aggregated Analytics data grouped by dimensions and measured with metrics.Databases, data warehouses, Power BI, Tableau, CRM and marketing platformsMartini submits report definitions, polls asynchronous jobs where necessary, maps results to a canonical reporting model, and applies date and attribution rules.
DimensionsBreak down reports by attributes such as page, tracking code, device type, or marketing channel.Reporting stores, dashboards, Salesforce, Adobe CampaignMartini resolves configured dimension identifiers, validates availability, and maps dimension values into downstream analytical or campaign fields.
MetricsMeasure visits, visitors, page views, occurrences, revenue, and custom events.Data warehouses, dashboards, CRM and marketing platformsMartini validates metric definitions, normalizes numeric values and periods, and applies business rules before writing downstream results.
SegmentsConstrain report results using saved audience or filtering definitions.Adobe Experience Platform, Adobe Target, Adobe Campaign, reporting platformsMartini retrieves or references segment identifiers, applies controlled configuration, and records the segment context with each extracted result.
ClassificationsAdd descriptive metadata to Analytics values, such as campaign or channel classifications.Data warehouses, BI platforms, campaign systemsMartini retrieves classification data, joins it to report or export results, validates keys, and preserves source identifiers for traceability.

Authentication and security considerations

OAuth 2.0 and Adobe permissions

Adobe Analytics uses Adobe Developer Console projects and Adobe Identity Management. The current server-to-server model uses OAuth 2.0 bearer tokens with the client identifier and Adobe organization identifier.

  • Grant the project the required Adobe Analytics product profile and report-suite permissions.
  • Confirm access to required dimensions, metrics, segments, calculated metrics, classifications, and data services.
  • Store client secrets, access tokens, organization identifiers, and API keys in Martini secrets or environment configuration.
  • Do not embed credentials in workflow mappings, source control, or logs.

Legacy authentication

JWT-based server-to-server authentication has been deprecated for new integrations. Existing implementations should be reviewed and migrated to OAuth 2.0 where appropriate.

Operational considerations for Adobe Analytics integrations

Limits and asynchronous processing

Adobe Analytics operations are subject to service limits, organization entitlements, response-size constraints, and operation-specific behavior. Avoid aggressive polling, use bounded retries with backoff, and record request identifiers and processing states.

Pagination and data size

Component lists and reports may require pagination, smaller date ranges, fewer breakdowns, or export-oriented processing. Do not assume that one response contains all matching data.

Idempotency and reporting semantics

Use report suite, report definition, date interval, export identifier, or source batch identifiers as deterministic processing keys. Document time zones, attribution, processing latency, late-arriving data, segment definitions, and whether results are finalized or revisable.

Schema and data quality

Dimensions, metrics, classifications, calculated metrics, and response schemas can change. Resolve controlled component configuration, validate required fields, quarantine malformed files or rows, and version report definitions.

Privacy and monitoring

Analytics data may include identifiers, campaign information, device data, and digital behavior. Apply data minimization, access control, masking, retention, secure file handling, workflow logging, and operational monitoring.

Why use Martini instead of scripts or point-to-point integrations?

Orchestration beyond a single script

Martini coordinates authentication, report submission, asynchronous polling, file processing, transformation, target delivery, and failure paths in maintainable workflows rather than scattering logic across scripts.

Reusable integration assets

Teams can expose controlled APIs, reuse workflow services, centralize environment configuration, and apply consistent mappings and business rules across Adobe Analytics reporting and export processes.

Operational reliability

Martini supports scheduled execution, validation, bounded retries, error branches, logging, and restartable processing. This is useful for rate limits, large reports, asynchronous jobs, file batches, and duplicate prevention.

Flexible targets

Martini can route normalized Analytics data to databases, files, APIs, CRM and marketing applications, or analytics platforms without requiring a dedicated vendor connector.

Frequently asked questions

How can Adobe Analytics be integrated with enterprise systems?

Adobe Analytics integrates primarily through its 2.0 REST APIs, using OAuth 2.0 credentials managed in Adobe Developer Console. Reporting, component, batch, Data Feed, Data Warehouse, and Bulk Data Insertion capabilities can support scheduled extraction, file pipelines, data-platform loading, and selected ingestion scenarios.

Can Martini integrate with Adobe Analytics?

Yes. Martini can consume Adobe Analytics 2.0 REST APIs, authenticate with OAuth 2.0, orchestrate report and batch workflows, process export files, transform Analytics data, and route results to applications, databases, files, or APIs.

Do I need a connector to integrate Adobe Analytics with Martini?

No. A dedicated Adobe Analytics connector is not required. Martini can integrate using Adobe Analytics REST APIs, OAuth 2.0 authentication, scheduled workflows, file-oriented exports, and Bulk Data Insertion where the Adobe implementation supports it.

Is there any extra Lonti cost to integrate Adobe Analytics with Martini?

Lonti does not charge an additional per-connector or per-vendor fee to integrate Adobe Analytics. The integration is subject to the provisioned capacity of the Martini environment. Separate costs may apply from Adobe, cloud infrastructure, storage, or other third-party systems depending on subscriptions, usage, and deployment model.

Which Adobe Analytics integration method should new implementations use?

New implementations should generally use the Adobe Analytics 2.0 REST APIs with OAuth 2.0 server-to-server credentials. Data Feeds, Data Warehouse, and Bulk Data Insertion are appropriate for larger, granular, or ingestion-oriented use cases. Adobe Analytics 1.4 SOAP APIs should be treated as legacy migration candidates.

Does Adobe Analytics provide webhooks, callbacks, or GraphQL?

A generally available Adobe Analytics webhook or outbound callback mechanism was not confirmed in the reviewed documentation, so scheduled API workflows are the safer default. No official Adobe Analytics GraphQL API was confirmed; REST APIs should be used unless Adobe verifies another interface for the required capability.

How does synchronization with Adobe Analytics work?

Synchronization is commonly schedule-driven. Martini submits reports or coordinates exports, polls asynchronous operations when needed, validates reporting periods and schemas, maps dimensions and metrics, and writes results to the target. Deterministic report, interval, file, or batch keys help support restartability and duplicate prevention.

How are Adobe Analytics errors, retries, and duplicate events handled?

Martini can distinguish authentication, permission, validation, rate-limit, asynchronous job, file, and schema errors. Bounded retries with backoff are appropriate for transient failures, while permission and validation errors should be corrected rather than repeatedly retried. Source batch identifiers and processing keys help prevent duplicate loads or event submissions.