POST /v3/delta/campaign → Query.campaignDelta

Overview

Note: This endpoint will be deprecated in the near future. Use 'delta/campaign/query/advertiser' instead. Prefer the canonical GraphQL field Query.campaignDelta via POST /v3/delta/campaign/query/advertiser.

Request and filter field mapping

GraphQL-only input fields (no REST equivalent)

Response field mapping

Endpoint-specific nested types and enums

BallotMeasureProfile

RTBAttributes → AudienceTargeting → TargetDemographicSettings

Code examples

The following are examples of querying campaign deltas with REST and GraphQL.

Basic delta query:

REST example

POST /v3/delta/campaign HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

{
  "LastChangeTrackingVersion": null,
  "AdvertiserId": "example-id",
  "ReturnEntireCampaign": false
}

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query CampaignDelta {
  campaignDelta(input: {
    advertiser: {
      changeTrackingVersion: 0
      ids: ["adv123"]
      pageSize: 100
    }
  }) {
    currentMinimumTrackingVersion
    nextChangeTrackingVersion
    moreAvailable
    campaigns {
      id
      name
      status
      pacingMode
      primaryGoal {
        type
        target
      }
    }
  }
}

Campaign goals, budget, and flights:

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query CampaignDeltaDetails {
  campaignDelta(input: {
    advertiser: {
      changeTrackingVersion: 0
      ids: ["adv123"]
      pageSize: 10
    }
  }) {
    campaigns {
      id
      name
      status
      pacingMode
      primaryGoal {
        type
        target
      }
      budget {
        total
        version
      }
      flights(first: 10) {
        nodes {
          id
          startDateInclusiveUTC
          endDateExclusiveUTC
          budgetInAdvertiserCurrency
        }
      }
      associatedBidLists {
        nodes {
          bidList { id source adjustmentType }
          isEnabled
        }
      }
      frequencyConfigs {
        counter { id name resetIntervalInMinutes }
      }
    }
  }
}