docs: clarify PHP acquisition-context boundary

README.de.md

@@ -4,7 +4,9 @@
 
 **clicktrail/php-sdk**
 
-Deterministische Kampagnen-Attribution für PHP — derselbe Engine-Vertrag hinter ClickTrails WordPress-, GTM- und CMS-Integrationen.
+Deterministische Engine für Akquisitionskontext in PHP. Sie verarbeitet
+beobachtete Request-Daten, wendet First-Touch- und Last-Touch-Regeln an und
+erstellt kanonische Events.
 
 </div>
 
@@ -24,7 +26,10 @@ Deterministische Kampagnen-Attribution für PHP — derselbe Engine-Vertrag hint
 
 ## Warum
 
-Die meisten Tracking-Pakete speichern, was eine Seite angezeigt hat. ClickTrail beweist, welche Kampagne den Lead oder Verkauf erzeugt hat: deterministische First-Touch-/Last-Touch-Merge-Regeln, Feld für Feld gegen dieselben Golden Fixtures validiert, die auch unser WordPress-Plugin und unsere GTM-Templates steuern.
+ClickTrail bewahrt den in einem Request beobachteten Kampagnenkontext. Es
+beweist nicht, welche Kampagne einen Lead oder Verkauf verursacht hat. Dieses
+SDK bündelt die deterministischen First-Touch- und Last-Touch-Regeln und prüft
+sie mit denselben Golden Fixtures wie die WordPress- und GTM-Integrationen.
 
 ## Installation
 
@@ -53,7 +58,7 @@ $session['ct'] = $merged->toJson();
 // und genau dieses Ergebnis läuft in WordPress, GTM und Shopware identisch nach.
 ```
 
-Ein direkter Besuch danach ändert nichts — der First Touch bleibt, der gespeicherte Last Touch besteht fort. Das ist die Merge-Regel: getestet, nicht versprochen.
+Ein direkter Besuch danach ändert nichts; der First Touch bleibt, der gespeicherte Last Touch besteht fort. Das ist die Merge-Regel: getestet, nicht versprochen.
 
 ## Consent-Gating
 

README.md

@@ -4,7 +4,9 @@
 
 **clicktrail/php-sdk**
 
-Deterministic campaign attribution for PHP — the same engine contract behind ClickTrail's WordPress, GTM and CMS integrations.
+Deterministic acquisition-context engine for PHP. It parses observed request
+data, applies first-touch and last-touch merge rules, and builds canonical
+events.
 
 </div>
 
@@ -24,7 +26,10 @@ Deterministic campaign attribution for PHP — the same engine contract behind C
 
 ## Why
 
-Most tracking packages store what a page showed. ClickTrail proves which campaign created the lead or sale: deterministic first-touch / last-touch merge laws, validated field-by-field against the same golden fixtures that govern our WordPress plugin and GTM templates.
+ClickTrail preserves the campaign context observed on a request. It does not
+prove which campaign caused a lead or sale. This SDK centralizes the
+deterministic first-touch and last-touch merge rules and validates them against
+the same golden fixtures used by the WordPress and GTM integrations.
 
 ## Installation
 
@@ -53,7 +58,7 @@ $session['ct'] = $merged->toJson();
 // and this exact result replays identically in WordPress, GTM and Shopware.
 ```
 
-A direct visit afterwards changes nothing — first touch stays, stored last touch persists. That is the merge law, tested, not promised.
+A direct visit afterwards changes nothing; first touch stays, stored last touch persists. That is the merge law, tested, not promised.
 
 ## Consent gating
 

README.pt-BR.md

@@ -4,7 +4,9 @@
 
 **clicktrail/php-sdk**
 
-Atribuição determinística de campanhas para PHP — o mesmo contrato de engine por trás das integrações WordPress, GTM e CMS da ClickTrail.
+Motor determinístico de contexto de aquisição para PHP. Ele interpreta dados
+observados na requisição, aplica regras de primeiro e último toque e cria
+eventos canônicos.
 
 </div>
 
@@ -24,7 +26,10 @@ Atribuição determinística de campanhas para PHP — o mesmo contrato de engin
 
 ## Por quê
 
-A maioria dos pacotes de rastreamento guarda o que a página mostrou. A ClickTrail prova qual campanha criou o lead ou a venda: leis determinísticas de mesclagem first-touch / last-touch, validadas campo a campo contra os mesmos golden fixtures que governam nosso plugin WordPress e nossos templates GTM.
+O ClickTrail preserva o contexto de campanha observado em uma requisição. Ele
+não prova qual campanha causou um lead ou uma venda. Este SDK centraliza as
+regras determinísticas de primeiro e último toque e as valida com os mesmos
+golden fixtures usados pelas integrações WordPress e GTM.
 
 ## Instalação
 
@@ -53,7 +58,7 @@ $session['ct'] = $merged->toJson();
 // e esse resultado exato se reproduz identicamente no WordPress, no GTM e na Shopware.
 ```
 
-Uma visita direta depois disso não muda nada — o primeiro toque permanece e o último toque armazenado persiste. Essa é a lei de mesclagem: testada, não prometida.
+Uma visita direta depois disso não muda nada; o primeiro toque permanece e o último toque armazenado persiste. Essa é a lei de mesclagem: testada, não prometida.
 
 ## Controle de consentimento
 

README.zh-CN.md

@@ -4,7 +4,7 @@
 
 **clicktrail/php-sdk**
 
-面向 PHP 的确定性营销活动归因——ClickTrail 的 WordPress、GTM 和 CMS 集成背后使用的是同一套引擎契约。
+面向 PHP 的确定性获客上下文引擎。它解析请求中观测到的数据，应用首次触点和末次触点规则，并构建规范事件。
 
 </div>
 
@@ -24,7 +24,7 @@
 
 ## 为什么
 
-大多数跟踪包只记录页面展示了什么。ClickTrail 证明是哪次营销活动带来了线索或成交：确定性的首次触点 / 末次触点合并规则，并逐字段对照与我们的 WordPress 插件和 GTM 模板相同的黄金 fixtures 进行验证。
+ClickTrail 保留请求中观测到的营销活动上下文，但不证明是哪次营销活动导致了线索或成交。此 SDK 集中实现确定性的首次触点和末次触点规则，并使用与 WordPress 和 GTM 集成相同的黄金 fixtures 进行验证。
 
 ## 安装
 
@@ -53,7 +53,7 @@ $session['ct'] = $merged->toJson();
 // 且这一结果在 WordPress、GTM 和 Shopware 中重放完全一致。
 ```
 
-之后再来的直接访问不会改变任何东西——首触保留，已存储的末触持续存在。这就是合并规则：经过测试，而非口头承诺。
+之后再来的直接访问不会改变任何东西；首触保留，已存储的末触持续存在。这就是合并规则：经过测试，而非口头承诺。
 
 ## 同意控制
 

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "clicktrail/php-sdk",
-    "description": "ClickTrail deterministic attribution core and PHP SDK - parse, classify and merge first/last-touch attribution; event ingestion contracts.",
+    "description": "Deterministic acquisition-context core for PHP: parse observed inputs, apply first/last-touch rules, and build canonical events.",
     "type": "library",
     "license": "MIT",
     "require": {
@@ -46,4 +46,4 @@
         "guzzlehttp/guzzle": "PSR-18 client implementation for the batch transport",
         "symfony/http-client": "Alternative PSR-18 client implementation"
     }
-}
+}