Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 3.13 KB

viewing-transactions-for-your-listing.md

File metadata and controls

53 lines (42 loc) · 3.13 KB
Raw
title intro redirect_from versions topics shortTitle
Viewing transactions for your listing
The {% data variables.product.prodname_marketplace %} transactions page allows you to download and view all transactions for your {% data variables.product.prodname_marketplace %} listing. You can view transactions for the past day (24 hours), week, month, or for the entire duration of time that your {% data variables.product.prodname_github_app %} has been listed.
/marketplace/github-marketplace-transactions
/developers/github-marketplace/viewing-transactions-for-your-listing
/developers/github-marketplace/creating-apps-for-github-marketplace/viewing-transactions-for-your-listing
/apps/publishing-apps-to-github-marketplace/creating-apps-for-github-marketplace/viewing-transactions-for-your-listing
fpt ghec
*
*
Marketplace
View listing transactions

{% data reusables.marketplace.marketplace-apps-not-actions %}

{% note %}

Note: Because it takes time to aggregate data, you'll notice a slight delay in the dates shown. When you select a time period, you can see exact dates for the metrics at the top of the page.

{% endnote %}

You can view or download the transaction data to keep track of your subscription activity. Click the Export CSV button to download a .csv file. You can also select a period of time to view and search within the transaction page.

Transaction data fields

  • date: The date of the transaction in yyyy-mm-dd format.
  • app_name: The app name.
  • user_login: The login of the user with the subscription.
  • user_id: The id of the user with the subscription.
  • user_type: The type of GitHub account, either User or Organization.
  • country: The three letter country code.
  • amount_in_cents: The amount of the transaction in cents. When a value is less the plan amount, the user upgraded and the new plan is prorated. A value of zero indicates the user canceled their plan.
  • renewal_frequency: The subscription renewal frequency, either Monthly or Yearly.
  • marketplace_listing_plan_id: The id of the subscription plan.
  • region: The name of the region present in billing address.
  • postal_code: The postal code value present in billing address.

Screenshot of the "Transactions" tab in the {% data variables.product.prodname_marketplace %} listing for an app. Transactions from the past week are listed in a table layout, with a search bar labeled "Search this file...".

Accessing {% data variables.product.prodname_marketplace %} transactions

To access {% data variables.product.prodname_marketplace %} transactions:

{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %}

  1. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %}
  2. Click the Transactions tab.
  3. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page.