{"id":1006,"date":"2026-06-22T10:00:00","date_gmt":"2026-06-22T08:00:00","guid":{"rendered":"https:\/\/example.com\/evergreen-countdown-generator-documentazione\/tracking-data-and-database\/"},"modified":"2026-06-28T18:54:48","modified_gmt":"2026-06-28T18:54:48","slug":"tracking-data-and-database","status":"publish","type":"page","link":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/documentation-pro-version\/tracking-data-and-database\/","title":{"rendered":"Tracking data and database"},"content":{"rendered":"<p>This guide explains how the countdown configurations generated with the plugin are stored in the database.<\/p>\n<h2>Countdown configuration<\/h2>\n<p>Countdown settings define:<\/p>\n<ul>\n<li>timer type;<\/li>\n<li>duration;<\/li>\n<li>end date;<\/li>\n<li>recurrence;<\/li>\n<li>template;<\/li>\n<li>colors;<\/li>\n<li>expiry action;<\/li>\n<li>shortcode;<\/li>\n<li>countdown ID.<\/li>\n<\/ul>\n<p>This data determines how the timer should work and appear.<\/p>\n<h2>Tracking data<\/h2>\n<p>Tracking data is used only for Evergreen timers.<\/p>\n<p>It is used to determine:<\/p>\n<ul>\n<li>when the timer started for a visitor;<\/li>\n<li>which record should be reused on subsequent visits;<\/li>\n<li>whether the countdown should continue or restart.<\/li>\n<\/ul>\n<p>Tracking data does not contain the full timer configuration. For example, it does not store the template, colors, configured duration, messages, or expiry actions. This information remains in the countdown settings.<\/p>\n<h2>Anonymous tracking records<\/h2>\n<p>For anonymous methods, the plugin uses the option:<\/p>\n<p><code>tipcg_countdown_tracking<\/code><\/p>\n<p><a href=\"\/tip-countdown-generator-pro\/wp-content\/uploads\/2026\/06\/database_option.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"imgBorder\" src=\"\/tip-countdown-generator-pro\/wp-content\/uploads\/2026\/06\/database_option.jpg\" alt=\"\" width=\"1200\" height=\"414\" class=\"alignnone size-full wp-image-9586\" \/><\/a><\/p>\n<p>This option stores the tracking records linked to cookies and IP addresses.<\/p>\n<p>Each record can contain:<\/p>\n<ul>\n<li><strong>timestamp<\/strong>: timer start time;<\/li>\n<li><strong>created<\/strong>: record creation date;<\/li>\n<li><strong>updated<\/strong>: last update;<\/li>\n<li><strong>expires<\/strong>: time after which the record can be removed.<\/li>\n<\/ul>\n<h2>IP, cookies, and data not stored in plain text<\/h2>\n<p>For Evergreen tracking management, the plugin does not store the IP address in plain text inside the tracking record.<\/p>\n<p>When IP tracking is used, the plugin generates a hashed version of the IP address and uses this value to build the record key in the database.<\/p>\n<p>Example of an IP-based key:<\/p>\n<p><code>tipcg_countdown_ip_countdown_1_837ec5754f503cfaaee0929fd48974e7<\/code><\/p>\n<p>In this example:<\/p>\n<ul>\n<li><code>tipcg_countdown_ip<\/code> indicates that the record is IP-based;<\/li>\n<li><code>countdown_1<\/code> identifies the countdown;<\/li>\n<li><code>837ec5754f503cfaaee0929fd48974e7<\/code> is the hashed version of the IP address.<\/li>\n<\/ul>\n<p>The original IP address is not stored in plain text in the record key.<\/p>\n<p>When cookie tracking is used, the plugin uses a generated cookie identifier to recognize the visitor\u2019s browser.<\/p>\n<p>Example of a cookie-based key:<\/p>\n<p><code>tipcg_countdown_cookie_countdown_1_tipcg_6a36e64c6ce338.70076691<\/code><\/p>\n<p>In this example:<\/p>\n<ul>\n<li><code>tipcg_countdown_cookie<\/code> indicates that the record is cookie-based;<\/li>\n<li><code>countdown_1<\/code> identifies the countdown;<\/li>\n<li><code>tipcg_6a36e64c6ce338.70076691<\/code> is the visitor\u2019s cookie identifier.<\/li>\n<\/ul>\n<p>The cookie identifier does not contain the visitor\u2019s name, email address, or IP address. It is used only to recognize the same browser on subsequent visits.<\/p>\n<h3>Privacy and GDPR note<\/h3>\n<p>The fact that the IP address is not stored in plain text reduces the exposure of the technical data in the database, but tracking data may still be considered pseudonymous data or technical identifiers because it makes it possible to recognize the same visitor, browser, or user over time.<\/p>\n<p>For this reason, it is advisable to assess its use within your privacy policy and, if necessary, within the website\u2019s cookie or consent management tools.<\/p>\n<h2>User meta for logged-in users<\/h2>\n<p>When the method is Logged-in user and the user is authenticated, the plugin stores the tracking in the user\u2019s user_meta.<\/p>\n<p>The data is linked to the countdown ID.<\/p>\n<p>It mainly contains:<\/p>\n<ul>\n<li><strong>timestamp<\/strong>;<\/li>\n<li><strong>created<\/strong>.<\/li>\n<\/ul>\n<p>In this case, the tracking is associated with the WordPress account of the logged-in user. This allows the Evergreen countdown to remain consistent even if the user changes browser, device, or IP address.<\/p>\n<h2>Practical difference<\/h2>\n<h3>Settings<\/h3>\n<p>They answer the question: how should this countdown be configured?<\/p>\n<h3>Tracking<\/h3>\n<p>It answers the question: when did this countdown start for this visitor or user?<\/p>\n<h2>Practical example<\/h2>\n<ul>\n<li>Configured Evergreen duration: 24 hours.<\/li>\n<li>Visitor\u2019s first access: Monday at 10:00.<\/li>\n<li>Saved tracking: timestamp for Monday at 10:00.<\/li>\n<li>Frontend: the timer shows the remaining time until Tuesday at 10:00.<\/li>\n<\/ul>\n<p>The database does not need to store the remaining time. The plugin calculates the remaining time by comparing the start timestamp with the duration configured in the countdown.<\/p>\n<h2>Important<\/h2>\n<p>If you change the countdown ID, the old tracking records no longer match the new ID. For Evergreen timers, this can cause the countdown to restart from the beginning.<\/p>\n<p>Likewise, if the cookie is deleted, the IP address changes, or the tracking data is removed by automatic cleanup, the plugin may no longer recognize the visitor and may create a new tracking record.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This guide explains how the countdown configurations generated with the plugin are stored in the database. Countdown configuration Countdown settings define: timer type; duration; end date; recurrence; template; colors; expiry action; shortcode; countdown ID. This data determines how the timer should work and appear. Tracking data Tracking data is used only for Evergreen timers. It&hellip; <a class=\"more-link\" href=\"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/documentation-pro-version\/tracking-data-and-database\/\">Continue reading <span class=\"screen-reader-text\">Tracking data and database<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":10007,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1006","page","type-page","status-publish","hentry","entry"],"_links":{"self":[{"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/pages\/1006","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/comments?post=1006"}],"version-history":[{"count":11,"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/pages\/1006\/revisions"}],"predecessor-version":[{"id":10148,"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/pages\/1006\/revisions\/10148"}],"up":[{"embeddable":true,"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/pages\/10007"}],"wp:attachment":[{"href":"https:\/\/demo.themeinprogress.eu\/tip-countdown-generator-pro\/wp-json\/wp\/v2\/media?parent=1006"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}