Cleeng reporting includes both customer_country and transaction_country information. This article explains what each field represents and how their values are determined across web and mobile app transactions.
It's important to understand the distinctions between these fields, as each serves a unique purpose for sales reports, revenue recognition, and in-depth data analysis.
Customer Country
The customer_country is the country associated with a customer's profile in your system, and it is the value stored in the customer API endpoint.
How it's collected: This value is required during the customer's initial registration, and is usually determined by the IP address of the device used for sign-up. However, it can be captured through any method you choose, for example, your application may allow the user to select their country from a dropdown menu in your registration form. The customer_country value can be updated any time you send an Update Customer API request from an application.
It is also a standard field in User Report, Pass Report, and Subscription Report
Transaction Country
The transaction_country (sometimes in the API documentation referred to as payment_country) is the country associated with a specific financial transaction. How this is collected depends on the platform where the transaction is being performed (eg, Web or App Store)
How it's collected: For web transactions, the customer’s IP address is required for order creation, and from this, the country value for the transaction is set. For Apple transactions, the customer’s Apple ID Country or Region is used to set the transaction_country in Cleeng reports. For Android transactions, the country value is derived from the customer’s Play Store Country.
You can find the transaction_country in your Transactions Report.
How do country values differ for Web, Android and Apple?
When transactions or subscriptions come from the Apple or Google stores, the country is based on the customer’s account settings in those platforms. For web, the country is determined from the customer’s IP address.
| Country Value | Web | Apple | Android (Google Play) |
| Customer | Based on the customer’s IP address | Based on your app’s customer creation flow | Based on your app’s customer creation flow |
| Transaction | Based on the customer’s IP address | Based on the customer’s Apple ID Country or Region | Based on the customer’s Play Store Country |