> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/grow-and-monetize/monetization/integration-and-data-operator-learning-path.md).

# Integration and data operator learning path

A guided path for connecting delivery platforms, demand sources, APIs, events, and reports.

This path helps an integration operator connect external systems without confusing control, data, and delivery boundaries. It covers service access, owned players, Apple, Spotify, VAST, OpenRTB, CATS, events, reports, APIs, and safe recovery.

![The current One Podigee Apple delivery view shows the Apple HLS standards and interstitial checks for the selected presentation.](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-34d9daa348dece809f9dccab5999d7ca485d3f70%2Fdoc-monetization-058-apple-standards.png?alt=media)

*Check the destination contract before you activate delivery.*

## Before you start

Read [New ad operations team learning path](/documentation/grow-and-monetize/monetization/new-ad-operations-team-learning-path.md) and [Large network and Marketplace operator learning path](/documentation/grow-and-monetize/monetization/large-network-and-marketplace-operator-learning-path.md). You need the selected workspace scope, a named integration owner, and the credentials or service access required by the destination.

## Understand the boundary

### 1. Check capability and authority

Use [Understand integration states and capability levels](/documentation/grow-and-monetize/monetization/understand-integration-states-and-capability-levels.md). Record which system owns media, ad selection, insertion, measurement, reporting, and retries. A connected destination can control insertion even when Podigee owns the Campaign plan.

### 2. Create scoped service access

Use [Create service access](/documentation/grow-and-monetize/monetization/create-service-access.md) and [Connect an external business or data system](/documentation/grow-and-monetize/monetization/connect-an-external-business-or-data-system.md). Give each connector only the scopes that its job needs. Set an owner, expiry, rotation rule, and evidence destination.

## Connect delivery surfaces

### 3. Register an owned player

Use [Register an owned player or delivery surface](/documentation/grow-and-monetize/monetization/register-an-owned-player-or-delivery-surface.md). Confirm the public authority, media formats, fallback, analytics, and event contract before you publish a Campaign to the player.

### 4. Connect Apple and Spotify

Use [Connect and verify Apple Podcasts delivery](/documentation/grow-and-monetize/monetization/connect-and-verify-apple-podcasts-delivery.md) and [Connect and verify Spotify delivery](/documentation/grow-and-monetize/monetization/connect-and-verify-spotify-delivery.md). Follow each platform's media, cuepoint, upload, API, and reporting rules. Apple HLS interstitials and Spotify SPAN delivery have different ownership and evidence steps.

![The current One Podigee Spotify setup shows Priority delivery without a limit and omits the impression limit field from the flight.](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-cbdd21162fcc37b92a0ccf4eac59dba854d86447%2Fdoc-monetization-059-spotify-priority.png?alt=media)

*Priority delivery requires no impression limit. Stop the Spotify Campaign when it must no longer run.*

## Connect demand and data

### 5. Add VAST, OpenRTB, or CATS demand

Use [Connect a VAST demand source](/documentation/grow-and-monetize/monetization/connect-a-vast-demand-source.md), [Connect an OpenRTB demand source](/documentation/grow-and-monetize/monetization/connect-an-openrtb-demand-source.md), and [Configure CATS transport](/documentation/grow-and-monetize/monetization/configure-cats-transport.md). Set timeout, request limit, response validation, fallback, privacy, and provider evidence before you activate the source.

### 6. Configure events and reports

Use [Configure event webhooks](/documentation/grow-and-monetize/monetization/configure-event-webhooks.md) for delivery and decision events. Use [Configure report delivery](/documentation/grow-and-monetize/monetization/configure-report-delivery.md) for scheduled business data. Test the destination, confirm the external receipt, and monitor retries.

### 7. Use the management API

Use [Use the management API](/documentation/grow-and-monetize/monetization/use-the-management-api.md) when a business system needs to create, read, or update records. Use idempotency, version checks, scoped credentials, and read-back after a write.

## Recover safely

* **The destination rejects the contract:** keep the last valid configuration and fix the named field before retry.
* **A callback is late or missing:** use [Repair a failed external synchronization](/documentation/grow-and-monetize/monetization/repair-a-failed-external-synchronization.md) and check the acknowledgement.
* **A source is unsafe:** suspend the integration, preserve evidence, and rotate access.
* **A report is not received:** retry the report delivery and verify the external receipt.
* **The integration must stop:** use [Suspend an integration](/documentation/grow-and-monetize/monetization/suspend-an-integration.md) before you remove access or delete credentials.

## Expected result

Every connected system has a named owner, a limited scope, a tested contract, and a clear delivery boundary. Operators can explain what happened in Podigee, what happened at the destination, and how the event or report evidence connects the two.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/grow-and-monetize/monetization/integration-and-data-operator-learning-path.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
