Skip to main content

DV360 SDF (Structured Data File) Connector Documentation

Updated this week
DV360-logo - Thunder Experience Cloud

πŸ›  Overview

The DV360 SDF connector retrieves YouTube-specific structural data from Google’s DV360 platform using the Structured Data Files (SDF) API. This includes YouTube ad entities for programmatic video campaigns and creative setups.

Granularity: YouTube Ad level

Purpose: Enrich campaign data with configuration and setup metadata for YouTube ads managed in DV360, such as settings not available via standard reporting.

Refresh Cadence: Daily

Update Modes: Refresh (for metadata only)
​


βš™οΈ Connection Setup

Key

Description

Required

Type

dv360_advertisers

List of advertiser IDs

βœ…

Text

(secret, username)

Not used

❌

This connector does not require user credentials beyond advertiser scope, and uses service-side authentication.


πŸ—“οΈ Jobs & Scheduling

Job Label

Feed

Look -

back

First Run

Poll

Targets

Update Mode

DV360 - SDF Import

dv360_sdf

1 day

06:00 UTC

24h

dv360_sdf_youtubead

Refresh

  • Job Type: Lookup-only (no facts)

  • Mode: Daily full refresh

  • Lookback Window: 0 days (non-temporal)


πŸ“š Table Schema

πŸ“„ dv360_sdf_youtubead

A direct reflection of YouTube-specific ad structures retrieved from the SDF API. Each row represents a YouTube Ad entity with full configuration and targeting detail.

Field Name

Description

displayName

YouTube ad name

youtubeAdId

Unique YouTube Ad ID

lineItemId

Associated Line Item ID

insertionOrderId

Associated Insertion Order ID

campaignId

Associated Campaign ID

advertiserId

Associated Advertiser ID

status

Ad status (e.g. ACTIVE, PAUSED)

entityStatus

Entity-level status

videoId

YouTube-hosted video ID used in the ad

finalUrls

Destination URLs

companionBannerIds

Linked companion banners (if any)

skippable

Whether the ad is skippable (TRUE/FALSE)

bumper

Indicates bumper ad format

adLength

Length in seconds

adFormat

Format type (e.g., in-stream, in-feed, bumper)

bidStrategyType

Bidding strategy (e.g., CPV, CPC)

bidAmountMicros

Bid amount in micros (Β΅)

activeViewEnabled

Whether ActiveView tracking is enabled

conversionTrackingEnabled

Whether conversion tracking is applied

inventorySourceIds

List of inventory sources

targeting.*

Embedded targeting details (geo, devices, languages, etc.)

videoLengthBucket

Bucketed video duration classification

videoAspectRatio

Aspect ratio (e.g., 16:9, 4:3)

videoPositioning

Placement strategy (e.g., pre-roll, mid-roll)

audienceTargeting

Structured audience segment settings

youtubeChannelId

Channel tied to the ad (if owned)

creativeSource

How the video was uploaded (manual, linked, etc.)

createdTime, lastModifiedTime

Timestamps for data lifecycle

⚠ Some fields may contain nested JSON or arrays depending on DV360’s internal modeling via SDF v5.5+.


πŸ”„ Update Mode

  • Table is marked with "update_mode": "refresh" meaning all records are reloaded once daily.

  • No history is preserved β€” each run replaces the previous content.


πŸ”— Relationships & Joins

Although this connector does not explicitly join with fact tables, the youtubeAdId and associated foreign keys (advertiserId, campaignId, etc.) can be joined to other DV360 datasets (such as dv360_data_trueview) using manual model-level mapping.


πŸ“Œ Use Cases

  • Validate YouTube ad configurations within DV360 accounts

  • Extract targeting and format breakdown for ad ops QA

  • Build creative audit dashboards showing ad status, bidding, and structure

  • Pair with performance tables (dv360_data_trueview) to evaluate performance vs. configuration


βœ… Summary

The DV360 SDF connector offers a granular lookup into YouTube ad entity configuration across DV360 advertisers via the dv360_sdf_youtubead table. Fully refreshed daily, it is ideal for creative validation, auditing, and configuration-driven insights. Although it does not include delivery metrics, it aligns with fact tables via shared keys for richer analysis.

Did this answer your question?