What does itch.io show about my traffic?

It shows views, downloads, purchases and the pages that sent visitors. The table lists each piece of data that itch.io describes in its own posts and documentation, and if Manalens also has it.

The graphs on the project analytics page take any date range up to 1 year, by day or by week. Impressions and click-through rate are different: they cover only the last week, and itch.io hides them when the data is too low.

For third-party analytics, itch.io supports Google Analytics 4 only. You add one measurement ID for your account, or one for a project, on the third-party analytics page under Interact. The itch.io pages that we read describe no other third-party analytics option for the project page.

What itch.io analytics shows, and what Manalens reads from itch.io
DataWhere itch.io shows itWhat it tells youIn Manalens?
Views, downloads and purchasesThe dashboard and the project analytics pageHow many times the page was viewed, and the game downloaded and boughtYes: views, downloads, payments and gross revenue per day, from the day after you connect
Referrers of visitorsThe project analytics page, since July 2013Where your visitors come fromNo: referrers are not in the itch.io API
Referrer of each purchaseThe Referrer column of the purchases list, since July 2014The itch.io page or the external page where the purchase startedNo. A matched purchase gets the channel of the website visit of the buyer, not the itch.io referrer
Buy location of each purchaseThe Buy location column of the purchases listGame page, Embed widget or Popup APINo
Impressions and click-through rateThe project analytics page, for the last week onlyHow often itch.io showed your title and thumbnail, and how often people clickedNo: impressions are not in the itch.io API
Collections, comments and ratingsThe top of the project analytics pageCounts for the projectNo

Sources: itch.io Your first itch.io page; itch.io Creator FAQ; itch.io Referrers and share buttons (2013); itch.io View where purchases come from (2014); itch.io Updates to project analytics (2018); itch.io Google Analytics 4 Update Guide (2023); Manalens itch.io documentation.

How do I read the itch.io referrer list?

Read it as an estimate of which sites send visitors, not as a count of each post. itch.io can only record the referrer that the browser sends. The itch.io admin leafo wrote in July 2024 that itch.io tries to collect anything it is sent, but if nothing is sent, it cannot attribute a referrer.

In December 2023, itch.io added a note to its jam analytics: referral data may not show the real number of visits from different sites, browsers and apps, because many platforms limit or leave out the referrer for privacy and security. itch.io says to read this data as an estimate.

The itch.io pages that we read do not describe a report for UTM parameters or campaigns. So a referrer names a site or a page. It does not name the post, the video or the creator. For that, give each one its own link.

How to read a row in the itch.io referrer data
What you seeWhat it meansWhat you can do
The name of an itch.io page, with its parametersAn internal page sent the visit or the purchase, such as browse, search, the home page or a user profile. The 2014 example is a purchase while browsing action games for OS XCheck your genre, tags and metadata. itch.io says correct tags give the project more places to show
An external linkA page outside itch.io sent the visit or the purchase, such as a game blog, Reddit, Twitter or Facebook. In the purchases list, the row links to that pageOpen the page to find the post. Compare the days with your short link clicks
No referrer, or fewer visits than you expectThe site, browser or app sent no referrer, or only a part of itDo not read it as zero. Use one short link for each post to count the clicks

Sources: itch.io View where purchases come from (2014); itch.io Analytics for Jam Hosts (8 December 2023); itch.io forum answer by leafo (31 July 2024).

How do I set up itch.io attribution step by step?

Do it in nine steps: links first, then the build, then purchases. Steps 1 to 3 need no code. Steps 5 to 8 need the owner or admin role and a verified MFA session in Manalens, and a server that knows a verified email address for each player.

  1. In itch.io, open the analytics page of the project. Note the referrers and the purchases list as your start point.
  2. Optional: add a Google Analytics 4 measurement ID in your itch.io account settings, or for one project under Interact.
  3. In Manalens, open Links and create one short link to the itch.io page for each post, video and creator. Set the creator, the channel and the UTM fields. Bulk create takes up to 100 rows.
  4. Add an SDK to the build. For an HTML5 build, send app events with the storefront itch: a Unity WebGL build or a Godot web export with our SDK does it for you, and a JavaScript game posts them from its own code. The web SDK snippet also works in the itch.io iframe, because *.itch.zone is in Allowed origins by default. For a download, use the Unity or Godot SDK.
  5. Create an API key in your itch.io account settings, under API keys.
  6. In Manalens, open Settings, then Integrations. In the itch.io section, paste the key, select Connect itch.io and choose the game. One project connects to one game.
  7. From your server, send an identify event with the verified email of each player, using the Secret key. Use the address that the player uses on itch.io.
  8. Select Sync now. After that, the sync runs one time each day.
  9. Read the result: choose itch.io in the Overview source picker, and open Attribution with purchase as the goal.

The app context of an app event from an HTML5 build on itch.io (example values)

app: { platform: 'web', storefront: 'itch', app_version: '1.4.0', build: '571', engine: 'other' }

Sources: itch.io Google Analytics 4 Update Guide (2023); itch.io Serverside API reference; Manalens short links, app events and itch.io documentation.

How do I measure players in the game?

Put an SDK in the build. itch.io runs an HTML5 game in an iframe on the project page, from hosts such as html-classic.itch.zone. Every Manalens project accepts requests from *.itch.zone by default, so app events from a Unity WebGL build, a Godot web export or your own JavaScript code arrive without setup. The web SDK snippet works there too, because the collector accepts web events from a page on a host in Allowed origins. Inside the iframe it sees the itch.io game host, not the itch.io page, so the UTM tags and referrer of that page are not visible.

For a downloaded build, the Unity and Godot SDKs send game_open on the first launch. Install attribution links it to a recent visit on your own website when the network matches. The match key stays for 72 hours, and the report then looks back 30 days by default for a page view of that visitor.

A player who goes from a short link straight to itch.io has no website visit, so that install stays unattributed. If attribution of installs is important to you, send players to a page on your own site first, with a button to itch.io.

Sources: itch.io Uploading HTML5 games; Manalens app events and install attribution documentation.

How do I match itch.io purchases to players?

Ask the itch.io API for the purchases of a verified email address. Manalens asks itch.io one question for each player whose email your server sent: which purchases did this address make for this game?

Each purchase becomes a purchase event with the channel itch, on the player's profile. It joins every browser and game install that is linked to that player, and attribution credits the player's earlier website visits. An HTML5 game on itch.io takes payments as donations only, and such a payment has the property donation.

The match is on by default after you choose a game, and you can turn it off. itch.io receives each email address that your server sent, also for players who bought nothing. So tell players about it in your privacy policy.

Sources: itch.io Serverside API reference; itch.io Uploading HTML5 games; Manalens itch.io documentation.

Which question does each tool answer?

itch.io answers which site sent visitors and purchases. Short links answer which post or creator got the click. The email match answers which channel brought a buyer who also visited your website. No tool in this guide connects every sale to one click.

Attribution questions for an itch.io game
Questionitch.io dashboardManalens
Which site sent visitors to my page?Yes, as an estimate: the referrersNo
Which itch.io page led to a purchase?Yes: the Referrer column of the purchases listNo
Which post or creator got the click?NoYes: link_clicked for each short link
Which click became a purchase?NoNo: a click is not joined to a later purchase
Which channel brought a buyer?NoOnly for a buyer who visited your website and whose verified email your server sent
What do players do in the game?NoYes, with an SDK in the build
What did I spend for each sale?NoNo: ad spend is not imported

Sources: itch.io View where purchases come from (2014); Manalens short links and itch.io documentation.

What are the limits?

Amounts are gross: itch.io's share and payment fees are not subtracted. Refunds are not imported. For a bundle purchase, the full price of the bundle is recorded. A purchase matches only when the email from your server is the email of the itch.io purchase. If two players share an email, neither is matched.

Daily numbers from itch.io start on the day after you connect, because the API gives only totals since the game was made.

Keep buyer data inside itch.io. The Creator FAQ says you must not share the data that itch.io collects about buyers, such as the email address, name, IP address, country code and transaction IDs, in public or with third-party services. The email match does not use that data. It uses only the addresses that your own server verified.

Sources: itch.io Creator FAQ; Manalens itch.io documentation.

How do I start?

Manalens is the analytics and growth engine built for games. Add the SDK to your itch.io build and connect the itch.io API. Then choose itch.io in the Overview source picker to see views, downloads, purchases and earnings.

Sources: Manalens product documentation.

Frequently asked questions

Can I add my own analytics script to an itch.io project page?

The project page accepts one Google Analytics 4 measurement ID. An HTML5 build runs your own code, so an SDK inside it can send events. Every Manalens project accepts events from *.itch.zone by default, so app events and the web SDK snippet in the build need no setup.

Does itch.io show UTM parameters?

The itch.io pages that we read describe referrers, not UTM parameters or campaigns. A referrer names the site or the page that sent the visit. To see the post or the creator, use a tracked short link for each one. Manalens records the UTM values and the creator with each click.

Why does itch.io show no referrer for my social posts?

itch.io can only record the referrer that the browser sends. The itch.io admin leafo wrote in July 2024 that each site has its own policy: some send the full referrer, some a part, and some nothing. Since December 2023, itch.io says referral data is an estimate, because many platforms and apps limit it.

Can I see itch.io referrers in Manalens?

No. Referrers and impressions are not in the itch.io API, so they stay in your itch.io dashboard. Manalens reads views, downloads, payments and gross revenue per day from itch.io. It also records the clicks on your short links, with the origin of the page that opened each link.

Is email matching private?

The sync sends to itch.io only the email addresses that your server sent with an identify event. It is on by default after you choose a game, and you can turn it off. Tell players about it in your privacy policy. A purchase matches only when the two email addresses are the same.

Are itch.io purchase amounts net of fees?

No. Amounts are gross: itch.io's share and payment fees are not subtracted. Refunds are not imported. Each purchase becomes a purchase event with the channel itch (a donation has the property donation), on the player's profile. Open Attribution with purchase as the goal to see which channels and campaigns sell the game.

Sources and implementation