Skip to main content

Scheduled report exports for Vimeo OTT Enterprise

If you have an Enterprise account on Vimeo OTT, you can schedule recurring CSV reports on viewership, signups, renewals, and cancellations. Delivered to email or S3 on your cadence, with every schedule and past run in one view.

This article covers setting up a schedule, managing it afterwards, and what's in each of the 11 report types.

Set up a report

  1. Go to Manage → Exports and click New Schedule.
  2. Choose a Report type (see below), a Frequency (daily, weekly, monthly, or quarterly), and a Generation hour (00:00–23:00 UTC). Monthly and quarterly schedules also take a Day of month — shorter months use their last calendar day.
  3. Add a Destination — recipient emails, or an S3 bucket. Destinations are saved under the name you give them and can be reused on other schedules.
  4. Click Create Schedule.

Manage a report

By clicking on a report you will access its detail page — the same page you land on right after creating a schedule. From there you can:

  • Edit the frequency, generation hour, and day of month, then Save. Report type is locked after creation.
  • Run now to trigger an immediate export.
  • Pause schedule to stop automatic runs without losing the setup, or Delete schedule to remove it.
  • Add, edit, or remove Destinations.
  • Open Job history to see past runs and download their files.

Note: Your first report is sent the following day and covers the last complete period. It then follows the normal cadence. A week is Monday to Sunday.

Report types

Minutes Viewed by User (minutes_viewed_by_user) — user-level viewership, one row per user per video per day.

  • USER_ID — logged-out viewers appear as 0
  • EMAIL — blank for logged-out viewers
  • VIDEO_ID
  • TITLE
  • PLATFORM
  • START_DATE
  • IS_LIVE — Yes/No
  • TOTAL_MINUTES_WATCHED
  • DISTINCT_SESSIONS
  • FINISHES — sessions played to at least 90% of the video’s duration; not counted for live videos

💡 Viewership in this report is based on Eastern Time, not UTC.

Minutes Viewed by Platform (minutes_viewed_by_platform) — minutes watched per video, split by device.

  • VIDEO_ID
  • TITLE
  • One column per platform: IPHONE, TIZEN, IPAD, WEB, APPLETV, ANDROID, ROKU, XBOX_ONE, ANDROID_TV, TVOS, FIRE_TV, FIRE_TABLET, LG_TV, VIZIO_TV, OTHER

Apple TV viewing is reported under TVOS. APPLETV is a legacy column and always returns 0 for data after 2018.

Watchlist Items (watchlist_items) — what each user has saved.

  • USER_ID
  • EMAIL
  • SOURCE_ID
  • SOURCE_TYPE — Video, Collection::Movie, or LiveEvent
  • TITLE — video title, or N.A. for collections
  • NAME — collection name, or N.A. for videos
  • UPDATED_DATE — date added to the watchlist

Video Information Export (video_information_export) — your video assets and their metadata.

  • ID
  • TITLE
  • SHORT_DESCRIPTION
  • PLAN — Standard, Free, Public, or NULL if unassigned
  • DURATION_MINUTES
  • IS_ACTIVE — Yes/No
  • CREATED_DATE
  • RELEASE_DATE — N.A. if unset
  • EXPIRATION_DATE — N.A. if unset
  • MEDIA_ID — N.A. if unset

The reports below only apply to sellers with a Subscription product. They do not apply to transactional, free, or advertising-supported products.

New Customers (new_customers) — users joining, and conversions into paid.

  • customer_id
  • email
  • subscription_frequency — monthly, yearly, or custom
  • event_type — New Free Trial, Direct to Paid, Free Trial to Paid, Paused to Paid
  • event_occurred_at
  • current_customer_status — the customer’s status now, not at the time of the event

Cancellations (cancellations) — customers who cancelled or paused, and why.

  • customer_id
  • email
  • ticket_status
  • cancel_type:
    • Set Cancellation — auto-renew turned off; the customer still has access
    • Cancelled Paying / Cancelled Free Trial / Cancelled from Pause
    • Undo Set Cancellation — the customer reversed a pending cancellation. This is a reactivation, not churn.
  • occurred_at — when the event was recorded
  • subscription_last_active_date — the last day the customer has access
  • cancel_reason:
    • budget — “No longer fits my budget”
    • high-price — “Subscription price too high”
    • lost-interest — “Content no longer interesting or meeting expectations”
    • no-time — “No time to watch/don’t use it enough”
    • promised-return — “I’ll be back!”
    • other — chose Other, may have typed into cancel_reason_other
    • no-reason — skipped the question
    • Non-renewable yearly ticket — the customer is in a region that doesn't allow automatic renewal
  • cancel_reason_other

⚠️ This report does not include app cancellations. All other subscriber reports do include app subscribers. For app cancellations, use the Customer CSV.

Renewals (renewals) — every subscription renewal, including apps.

  • customer_id
  • email
  • start_date
  • renewal_date
  • age_in_months
  • subscription_frequency
  • charged_price_cents — (1299 = $12.99). Reads see developer account for app renewals.
  • platform
  • maker_type — Transaction, Fulfillment (an app renewal), or Gift

Re-subscribers (resubscribers) — customers who left and came back.

  • customer_id
  • email
  • latest_ticket_status
  • total_ticket_count — 2 or more means they’ve returned at least once
  • latest_ticket_id
  • latest_ticket_created

Total Active Subscribers (total_active_subscribers) — a snapshot count at the time the report ran. The rows sum to your total active subscribers.

  • total
  • subscription_frequency — monthly, yearly, or custom

Subscriber Product Changes (subscriber_product_changes) — upgrades, downgrades, and plan switches.

  • change_date
  • customer_name
  • customer_email
  • previous_product_id
  • previous_frequency
  • current_product_id
  • current_frequency
  • promotion_id
  • promotion_code

Customer CSV (customer_csv) — the full customer export. One row per customer event, so a customer can appear on several rows.

  • customer_id
  • email
  • first_name
  • last_name
  • city
  • state
  • country
  • product_id
  • product_name
  • action — subscription, rental, purchase, registration, follow
  • action_type — transaction, free_access, gift, coupon, fulfillment (an app event)
  • status
  • frequency
  • platform
  • coupon_code
  • coupon_code_id
  • promotion_id
  • promotion_code
  • campaign
  • referrer
  • event_created_at
  • customer_created_at
  • expiration_date
  • marketing_opt_in
  • converted_to_paid

If you have questions about these reports, check our reports FAQ or reach out to your account manager.

Related articles