Sync measurement data

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

POST /api/v2/buyer/advertisers/{advertiserId}/measurement-data/sync Advertisers or MMPs call this to provide performance data instead of the Conversion API. Accepts time-series measurement points keyed by campaign, media buy, package, and/or creative. Up to 1,000 measurements per call; deduplicates on external_row_id.

Request

curl -X POST https://api.apostra.com/api/v2/buyer/advertisers/12345/measurement-data/sync \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "measurements": [
      {
        "start_time": "2026-03-01T00:00:00-05:00",
        "end_time": "2026-03-07T23:59:59-05:00",
        "metric_id": "incremental_revenue",
        "metric_value": 8450.75,
        "unit": "currency",
        "currency": "USD",
        "campaign_id": "camp_456",
        "media_buy_id": "mb_789",
        "source": "advertiser",
        "source_platform": "acme-analytics",
        "source_metric_name": "Incremental Revenue",
        "external_row_id": "acme_row_001"
      }
    ]
  }'

{
  "measurements": [
    {
      "start_time": "2026-03-01T00:00:00-05:00",
      "end_time": "2026-03-07T23:59:59-05:00",
      "metric_id": "purchase_count",
      "metric_value": 142,
      "unit": "count",
      "campaign_id": "camp_456",
      "external_row_id": "acme_row_002"
    }
  ]
}

Parameters

Field	Type	Required	Notes
`measurements`	array	Yes	1–1000 measurement points
`measurements[].start_time`	string	Yes	ISO 8601 with timezone offset
`measurements[].end_time`	string	Yes	ISO 8601 with timezone offset
`measurements[].metric_id`	enum	Yes	`revenue`, `incremental_revenue`, `conversions`, `incremental_conversions`, `page_view_count`, `add_to_cart_count`, `purchase_count`, `ltv_1d`, `ltv_7d`, `ltv_30d`
`measurements[].metric_value`	number	Yes	Measured value
`measurements[].unit`	enum	Yes	`currency`, `count`, `ratio`, `percentage`
`measurements[].currency`	string	Conditional	ISO 4217 (`^[A-Z]{3}$`). Required when `unit` is `currency`
`measurements[].campaign_id`	string	No	Attach to a campaign (max 255)
`measurements[].media_buy_id`	string	No	Attach to a media buy (max 255)
`measurements[].package_id`	string	No	Attach to a package (max 255)
`measurements[].creative_id`	string	No	Attach to a creative (max 255)
`measurements[].source`	enum	No	`advertiser`, `mmp`, `measurement_partner`
`measurements[].source_platform`	string	No	Originating platform (max 255)
`measurements[].source_metric_name`	string	No	Raw partner metric name (max 255)
`measurements[].external_row_id`	string	No	Idempotency key for re-syncs (max 255)

Response

{
  "measurements": [
    { "index": 0, "action": "created" },
    { "index": 1, "action": "updated" }
  ]
}

Each result reports its index in the request array and an action of created, updated, unchanged, or failed. Failed rows include an error string.

Errors

400 VALIDATION_ERROR — missing required field, start_time not before end_time, missing currency when unit is currency, or more than 1,000 measurements.

See Errors for the full error contract.

Measurement tasks

All measurement operations

Measurement overview

Pipeline, belief state, and concepts

Upload measurement records

Batch per-geo outcome records

Get measurement freshness

Confirm data is arriving

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Sync measurement data

Request

Parameters

Response

Errors

Measurement tasks

Measurement overview

Upload measurement records

Get measurement freshness

​Request

​Parameters

​Response

​Errors

​Related

Measurement tasks

Measurement overview

Upload measurement records

Get measurement freshness

Request

Parameters

Response

Errors

Related