Export Plan Details (Ad Set Information)

Learn how to export all Ad Set details from a Plan in Review Mode. This guide covers how to generate and download CSV exports, what data is included, notification behaviour, and permissions.

Overview & Use Cases

Users can now export all Ad Set details from a single Plan directly from the UI while in Review Mode. The export includes every Ad Set in the Plan, along with content from each Ad and Ad Set — such as Media Type, schedule, and custom field information.

The requesting user receives a download link by email once the export is complete.

Note: Performance and spend metrics are not included.

This provides a simple way for Plan reviewers to pull structured Ad and Ad Set data for analysis, scheduling, or reconciliation. It’s particularly valuable for networks that manage media delivery outside the Zitcha platform, or need to reconcile Plans against other platforms and campaign activity.

How It Works

  1. Enter Review Mode Open any Plan and switch to Review Mode.
  1. Click Export An Export button appears above the Ad Set table.

  2. Export Initiation

    • A page-level notification confirms that the export has started.
    • If your organisation has in-app notifications enabled, the Notification Centre displays:

      “Export has been initiated.”

  3. Completion

    • The requester receives an email with:

      • A download link to the CSV file
      • A link to the related Plan
    • If in-app notifications are enabled, you’ll also see:

      “Export has been completed successfully. Please check emails to download the file.”

  4. Failure Case

    • The requester receives an email indicating the export failed and can try again.

    • If in-app notifications are enabled, the Notification Centre displays:

      “Export has failed. Please try again.”

File Format

Each CSV includes all Ad Sets in the selected Plan, with one line per Ad.

User Permissions

  • Any user who can view a Plan can also export it in Review Mode.
  • Access follows existing Plan permissions.
  • Only the requesting user receives the download link and notifications.

Notifications

In-App Notifications

  • Shown only if the organisation has notifications enabled.
  • Sent only to the requesting user.
  • Users cannot opt out of export notifications.
  • Events covered:
    • Export initiated
    • Export completed
    • Export failed

Email Notifications

  • Always sent to the requesting user.
  • Users cannot opt out of export emails.
  • Email includes:
    • Network branding for the Plan
    • Download link to the CSV
    • Link to the related Plan
  • Failure email indicates the export did not complete and prompts the user to retry.

Organisations without in-app notifications enabled will rely solely on email updates.

Export Fields

Column NameDescription
ADVERTISER_nameName of Advertiser the Plan was submitted by
NETWORK_nameName of Network the Plan was submitted to
PLAN_idZitcha ID of the Plan
PLAN_nameName of Plan
PLAN_statusStatus of the Plan at time of export
PLAN_created_atDate and time Plan was created
PLAN_updated_atDate and time Plan was last updated
PLAN_wallet_idZitcha ID of the wallet used in the Plan
WALLET_nameName of the Wallet used in the Plan
WALLET_descriptionAdditional description from the Wallet used in the Plan
ADSET_titleAd Set Title
ADSET_idZitcha ID of Ad Set
ADSET_media_type_nameMedia Type (Media Space) selected in Ad Set
ADSET_statusAd Set status
ADSET_cal_periodCalendar Period selected in Ad Set
ADSET_start_atStart date and time of Ad Set
ADSET_end_atEnd date and time of Ad Set
ADSET_budgetSubmitted budget of Ad Set
discount_typeDiscount Type applied to Ad Set (Fixed or Percentage)
discount_valueValue of discount applied (Fixed or %)
ADSET_max_invoiceableSubmitted budget with discounts subtracted
ADSET_fieldsInputs added to the custom fields of the Ad Set
ADSET_skusList of SKU IDs selected in the Ad Set (not Ad)
ADSET_created_atDate and time Ad Set was created
ADSET_updated_atDate and time Ad Set was last updated
ADSET_pricing_strategyPricing type of the Media Type (Fixed, Dynamic, CPC, CPM)
ADSET_location_type_nameLocation Type selected in placement
ADSET_location_nameLocation selected in placement
AD_idZitcha ID of Ad
AD_skusList of SKU IDs selected in the Ad
AD_stateAd Status
AD_fieldsInputs added to custom fields of the Ad (one line per Ad)
AD_created_atDate and time Ad was created
AD_updated_atDate and time Ad was last updated