{"id":30239191,"url":"https://github.com/stape-io/postscript-tag","last_synced_at":"2026-02-12T14:02:34.383Z","repository":{"id":302684146,"uuid":"1009814849","full_name":"stape-io/postscript-tag","owner":"stape-io","description":"Postscript Tag for Google Tag Manager Server Side","archived":false,"fork":false,"pushed_at":"2025-07-07T13:26:39.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-17T06:19:12.524Z","etag":null,"topics":["gtm","gtm-custom-template","gtm-server-side","postscript","postscript-api","stape"],"latest_commit_sha":null,"homepage":"https://stape.io","language":"Smarty","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stape-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T18:59:16.000Z","updated_at":"2025-07-25T18:06:44.000Z","dependencies_parsed_at":"2025-07-03T18:08:47.741Z","dependency_job_id":"92fb11c7-fea6-45d1-8859-163e9a038f53","html_url":"https://github.com/stape-io/postscript-tag","commit_stats":null,"previous_names":["stape-io/postscript-tag"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stape-io/postscript-tag","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stape-io%2Fpostscript-tag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stape-io%2Fpostscript-tag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stape-io%2Fpostscript-tag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stape-io%2Fpostscript-tag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stape-io","download_url":"https://codeload.github.com/stape-io/postscript-tag/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stape-io%2Fpostscript-tag/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29367830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gtm","gtm-custom-template","gtm-server-side","postscript","postscript-api","stape"],"created_at":"2025-08-15T03:39:36.384Z","updated_at":"2026-02-12T14:02:34.378Z","avatar_url":"https://github.com/stape-io.png","language":"Smarty","readme":"# Postscript Tag for Google Tag Manager Server-Side\n\nThe **Postscript Tag** for Google Tag Manager Server-Side allows sending Subscriber and Event data directly to [Postscript](https://postscript.io/) via their REST API.\n\nThis tag supports multiple request types:\n\n- **Track Event**: Send custom event data associated with a subscriber (e.g., purchases, form submissions).\n- **Create Subscriber**: Add a new subscriber with optional tags, keyword subscription, and custom properties.\n- **Update Subscriber**: Update subscriber data, such as email, tags, and custom fields.\n\n## How to use the Postscript Tag\n\n1. Add the **Postscript Tag** to your server container in GTM.\n2. Select the **Type** of request you want to send:\n   - **Track Event**\n   - **Create Subscriber**\n   - **Update Subscriber**\n3. Fill in required and optional parameters based on the selected type.\n4. Provide your **Private API Key** (found in your Postscript [API Settings](https://app.postscript.io/account/api)).\n\n### Track Event\n\nSend custom events with metadata tied to a subscriber using identifiers like `Subscriber ID`, `Phone`, or `Email`.\n\n\u003e Use fallback option to read Subscriber ID from `ps-id` URL query parameter, `ps_id` cookie, or from Stape Data Tag Event Data.\n\n- Required:\n  - `Event Name`\n  - **At least one subscriber identifier**: `Subscriber ID`, `Phone`, or `Email`\n\n- Optional:\n  - **Event Properties**: Predefined fields like `Occured At` and `Event ID`\n  - **Custom Properties**: Additional event metadata\n\n\u003e If no Subscriber is found from identifiers, the event will still be recorded and used later if a match is made.\n\n### Create Subscriber\n\nAdds a new subscriber to Postscript.\n\n- Required:\n  - `Phone Number`\n  - One of: `Keyword` or `Keyword ID`\n\n- Optional:\n  - `Email`, `Origin`, `Shopify Customer ID`\n  - `Tags` (can be used in segmentation or filtering)\n  - **Custom Properties**: Additional metadata about the user that can be used in segmentation or filtering\n\n### Update Subscriber\n\nUpdates an existing subscriber.\n\n- Required:\n  - `Subscriber ID`\n    \u003e Use fallback option to read Subscriber ID from `ps-id` URL query parameter, `ps_id` cookie, or from Stape Data Tag Event Data (`common_cookie.ps_id`)\n\n- Optional:\n  - `Email`\n  - `Tags` (additive - can be used in segmentation or filtering)\n  - **Custom Properties**: Additional metadata about the user that can be used in segmentation or filtering\n\n### Additional Options\n\n- **Optimistic Scenario**: Improves performance by firing `gtmOnSuccess()` immediately without waiting for API response.\n- **Consent Settings**: Prevent sending data unless ad storage consent is given.\n- **Logging Options**: Log to console (during debug or always) or to BigQuery for analytics and debugging.\n\n## Useful links:\n\n- [Step-by-step guide on how to configure Postscript Tag](https://stape.io/helpdesk/documentation/postscript-tag)\n\n## Open Source\n\nThe **Postscript Tag for GTM Server-Side** is developed and maintained by the [Stape Team](https://stape.io/) under the Apache 2.0 license.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstape-io%2Fpostscript-tag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstape-io%2Fpostscript-tag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstape-io%2Fpostscript-tag/lists"}