Connector evidence record · x-ads

X Ads

X Ads logoX Ads

Validation required

Independent validation is still required. The capabilities below describe the current registry contract, not production readiness.

Connection contract

How this source enters toorow

Category
Paid media
Authorization
OAuth 1.0aConnect through toorow's governed Nango broker; signing and token secrets stay inside the broker.
Onboarding
  • Connector pull

Capability ledger

Declared report profiles

4 profiles, including current limitations.

campaign_daily

Campaign analytics

Selectable in current contract

This profile is selectable by the current registry contract; that is not a production-readiness claim.

Metrics
  • billed_charge_local_micro
  • clicks
  • conversions
  • engagements
  • impressions
Dimensions
  • account_id
  • campaign_id
  • date
  • placement
Complete joint grain
  • account_id + campaign_id + date + placement
Cadence
Minimum interval: 1440 minutes
Supported modes
  • daily
  • manual

line_item_daily

Line item analytics

Selectable in current contract

This profile is selectable by the current registry contract; that is not a production-readiness claim.

Metrics
  • billed_charge_local_micro
  • clicks
  • conversions
  • engagements
  • impressions
Dimensions
  • account_id
  • campaign_id
  • date
  • line_item_id
  • placement
Complete joint grain
  • account_id + campaign_id + date + line_item_id + placement
Cadence
Minimum interval: 1440 minutes
Supported modes
  • daily
  • manual

promoted_post_daily

Promoted post analytics

Selectable in current contract

This profile is selectable by the current registry contract; that is not a production-readiness claim.

Metrics
  • billed_charge_local_micro
  • clicks
  • engagements
  • impressions
Dimensions
  • account_id
  • campaign_id
  • date
  • placement
  • promoted_tweet_id
Complete joint grain
  • account_id + campaign_id + date + placement + promoted_tweet_id
Cadence
Minimum interval: 1440 minutes
Supported modes
  • daily
  • manual

segmented_daily

Segmented asynchronous analytics

Selectable in current contract

This profile is selectable by the current registry contract; that is not a production-readiness claim.

Metrics
  • clicks
  • engagement_rate
  • engagements
  • frequency
  • impressions
  • reach
Dimensions
  • account_id
  • campaign_id
  • date
  • placement
  • segment_type
  • segment_value
Complete joint grain
  • account_id + campaign_id + date + placement + segment_type + segment_value
Cadence
Minimum interval: 1440 minutes
Supported modes
  • daily
  • manual