Avamartech
Implementation Guideدليل التطبيق

Offline Attribution System: How to Build Itنظام ربط المبيعات الأوفلاين: كيف تبنيه

A technical and strategic guide to mapping eligible in-store purchase records into destination-specific advertising signals—with consent, reconciliation and causal limits kept visible.دليل تقني واستراتيجي لتحويل سجلات مشتريات المتجر المؤهلة إلى إشارات إعلانية خاصة بكل وجهة، مع إظهار حدود الموافقة والتسوية والسببية بوضوح.

2026 Editionإصدار 2026
System Architectureهندسة النظام
~25 min read~25 دقيقة قراءة

The Problemالمشكلة

Digital ad platforms observe only the eligible signals they receive. Even online attribution is incomplete, privacy-constrained and model-dependent; it is not automatic proof that an ad caused a purchase.لا ترى منصات الإعلانات إلا الإشارات المؤهلة التي تصل إليها. وحتى الإسناد الأونلاين يظل ناقصًا ومقيدًا بالخصوصية ومعتمدًا على النماذج؛ وليس دليلًا تلقائيًا على أن الإعلان سبّب الشراء.

Offline retail breaks this chain. A customer sees your ad on Instagram, walks into your store three days later, and pays cash at the register. Meta has no idea that sale happened. Your POS system has no idea the customer came from an ad. The result: you're spending money on ads with no way to measure what's actually working.مبيعات التجزئة الأوفلاين تكسر هذه السلسلة. عميل يرى إعلانك على Instagram، يدخل متجرك بعد ثلاثة أيام، ويدفع نقدًا عند الكاشير. Meta لا تعلم أن هذا البيع حدث. ونظام نقاط البيع (POS) لا يعلم أن العميل جاء من إعلان. النتيجة: أنت تنفق على الإعلانات بدون أي طريقة لقياس ما ينجح فعلًا.

This guide describes a consented bridge between the completed POS ledger and destination event APIs. Eligible transactions may be matched and attributed under each platform's rules; coverage remains incomplete and platform attribution is not causal incrementality.يصف هذا الدليل جسرًا قائمًا على الموافقة بين سجل معاملات نقطة البيع المكتملة وواجهات أحداث المنصات. قد تتم مطابقة وإسناد بعض المعاملات المؤهلة وفق قواعد كل منصة؛ وتظل التغطية ناقصة ولا يساوي إسناد المنصة قياس الأثر السببي.

What This System Doesماذا يفعل هذا النظام

The completed POS transaction becomes the canonical event. With the approved lawful basis or consent, the middleware maps only destination-required fields into each current event contract. Platforms may match that event to prior exposure, but the result is reported attribution—not guaranteed identity resolution, complete coverage, or causal ROAS.تصبح معاملة نقطة البيع المكتملة هي الحدث المرجعي. ومع الأساس القانوني أو الموافقة المعتمدة، يحوّل السيرفر الوسيط الحد الأدنى المطلوب لكل منصة إلى عقد الحدث الحالي الخاص بها. قد تطابق المنصة الحدث مع تعرض سابق، لكن الناتج إسناد مُبلّغ وليس ضمانًا لمطابقة الهوية أو التغطية الكاملة أو ROAS سببي.

Section 01القسم 01

System Architectureهندسة النظام

The complete system has four layers. Data moves left to right — from the physical store to the ad platform.النظام الكامل يتكون من أربع طبقات. تتحرك البيانات من المتجر الفعلي إلى منصة الإعلانات.

Full System Data Flowتدفق البيانات الكامل في النظام
⍑
POS / ERPPOS / ERP
Transaction dataبيانات المعاملة
◈
Capture Layerطبقة الالتقاط
Gets customer onlineتجلب العميل أونلاين
♦
Processingالمعالجة
Pixel + CAPIبيكسل + CAPI
★
Ad Platformsمنصات الإعلانات
Attribution engineمحرك الإسناد

Layer 1: POS / ERP (Data Source)الطبقة 1: نظام نقاط البيع / ERP (مصدر البيانات)

The completed POS or ERP ledger is the transaction source of truth. Define a minimal canonical event—transaction ID, timestamp, currency, value, branch and completion/refund state—then add a destination-required identifier only when its purpose, authority, notice, retention and deletion path are approved.سجل نقطة البيع أو الـ ERP المكتمل هو مصدر حقيقة المعاملة. عرّف حدثًا مرجعيًا بالحد الأدنى—معرّف المعاملة والوقت والعملة والقيمة والفرع وحالة الاكتمال أو الاسترداد—ولا تضف معرّفًا شخصيًا مطلوبًا للمنصة إلا بعد اعتماد الغرض والصلاحية والإشعار والاحتفاظ والحذف.

Layer 2: Capture Layer (The Bridge)الطبقة 2: طبقة الالتقاط (الجسر)

A capture method is optional and purpose-specific. A receipt page, QR code or Wi-Fi interaction must never manufacture the purchase; the ledger already recorded it. A digital touchpoint may add an authorized platform identifier to the existing transaction or deliver a receipt without emitting any ad event.طريقة الالتقاط اختيارية ومرتبطة بغرض محدد. لا يجوز لصفحة إيصال أو QR أو اتصال Wi‑Fi أن ينشئ حدث الشراء؛ فالسجل وثّقه بالفعل. قد تضيف نقطة الاتصال الرقمية معرّف منصة مصرحًا به إلى المعاملة القائمة أو تعرض الإيصال من دون إطلاق حدث إعلاني.

The single goal is one canonical completed-transaction event, mapped separately and minimally to each approved destination with retries, reconciliation, deletion and per-destination deduplication.الهدف هو حدث مرجعي واحد لمعاملة مكتملة، يُحوّل بشكل منفصل وبالحد الأدنى لكل وجهة معتمدة مع إعادة المحاولة والتسوية والحذف ومنع التكرار الخاص بكل منصة.

Layer 3: Processing (Pixel + API)الطبقة 3: المعالجة (بيكسل + API)

Only the completed POS transaction may authorize a Purchase event. Browser and server channels are transport options selected per platform and consent design—not triggers created by opening a receipt:معاملة نقطة البيع المكتملة وحدها هي التي تسمح بحدث Purchase. المتصفح والسيرفر قناتا نقل تُختاران وفق المنصة وتصميم الموافقة، وليستا محفزًا ينشأ عند فتح الإيصال:

  • Browser-side signal — with valid consent, a browser may contribute platform identifiers to the already-recorded transaction. Do not fire Purchase merely because a receipt URL opened.إشارة المتصفح — مع موافقة صالحة، قد يضيف المتصفح معرّفات المنصة إلى المعاملة المسجلة مسبقًا. لا تطلق Purchase لمجرد فتح رابط الإيصال.
  • Server-side API — your server maps approved transaction fields and, where authorized, normalized and hashed identifiers. Hashing is pseudonymisation, not encryption or anonymisation, and matching is never guaranteed.واجهة السيرفر — يحوّل السيرفر حقول المعاملة المعتمدة، وعند التصريح، المعرّفات الموحّدة والمُهشّمة. الهاش إخفاء جزئي للهوية وليس تشفيرًا أو إخفاءً تامًا، ولا يضمن المطابقة.

Layer 4: Ad Platforms (Attribution)الطبقة 4: منصات الإعلانات (الإسناد الإعلاني)

Each destination processes eligible events under its own matching, consent, attribution-window and reporting rules. An unmatched or unattributed event is not automatically an organic sale, and a matched event does not prove causality. Reconcile destination reporting against the POS ledger and use experiments for incrementality.تعالج كل وجهة الأحداث المؤهلة وفق قواعدها للمطابقة والموافقة ونافذة الإسناد والتقارير. الحدث غير المطابق أو غير المُسند لا يصبح تلقائيًا بيعًا عضويًا، والحدث المطابق لا يثبت السببية. طابق تقارير المنصات مع سجل نقاط البيع واستخدم التجارب لقياس الأثر الإضافي.

Section 02القسم 02

Two Signal Roles: Browser Context vs Server Event APIدوران مختلفان للإشارة: سياق المتصفح وواجهة أحداث السيرفر

For an in-store sale, the completed POS ledger authorizes the Purchase event. A consented browser touchpoint may contribute a destination-supported identifier to that existing record; it must not manufacture a second Purchase when a receipt, QR, survey or Wi-Fi page opens.في بيع المتجر، سجل نقطة البيع المكتمل هو الذي يسمح بحدث Purchase. قد تضيف نقطة اتصال بالمتصفح وبموافقة معرّفًا تدعمه الوجهة إلى السجل القائم؛ لكنها لا تنشئ Purchase ثانيًا عند فتح إيصال أو QR أو استبيان أو صفحة Wi‑Fi.

Browser Pixelبيكسل المتصفح
Runs in the Customer's Browserيعمل في متصفح العميل

With valid consent, a browser touchpoint may collect platform identifiers and associate them with an already-completed transaction through an authenticated, opaque locator. Opening the page alone must never fire Purchase.مع موافقة صالحة، قد تجمع نقطة اتصال في المتصفح معرّفات المنصة وتربطها بمعاملة مكتملة مسبقًا عبر مُعرّف مبهم ومصادق عليه. فتح الصفحة وحده لا يجوز أن يطلق Purchase.

How it may help: after explicit consent, the first-party page may submit only the identifier supported by one named destination to your authenticated backend. The backend associates it with the canonical transaction; the ledger-authorized server mapper remains responsible for any Purchase event.كيف قد تساعد: بعد موافقة صريحة، قد ترسل الصفحة المباشرة فقط المعرّف الذي تدعمه وجهة واحدة محددة إلى السيرفر المصادق عليه. يربطه السيرفر بالمعاملة المرجعية؛ ويظل محوّل السيرفر المعتمد من السجل مسؤولًا عن أي حدث Purchase.

Server APIواجهة برمجة السيرفر
Runs on Your Serverيعمل على السيرفر الخاص بك

After validating the completed transaction, your server maps one eligible event into each separately approved destination contract. Identifiers are optional, destination-specific and sent only when authorized; acceptance, matching and attribution are never guaranteed.بعد التحقق من المعاملة المكتملة، يحوّل السيرفر حدثًا مؤهلًا إلى عقد كل وجهة معتمدة بشكل مستقل. المعرّفات اختيارية وخاصة بالوجهة ولا تُرسل إلا عند التصريح؛ ولا يوجد ضمان للقبول أو المطابقة أو الإسناد.

How matching may happen: when authorized, normalize and SHA-256 hash destination-supported identifiers before transport. The platform may match them under its own rules. Hashing is pseudonymisation and matching remains incomplete; cookies and other signals can still affect reporting.كيف قد تتم المطابقة: عند التصريح، وحّد المعرّفات التي تدعمها الوجهة واستخدم SHA‑256 قبل النقل. قد تطابقها المنصة وفق قواعدها. الهاش إخفاء جزئي للهوية والمطابقة تظل ناقصة؛ وقد تؤثر ملفات الارتباط وإشارات أخرى على التقارير.

Comparisonالمقارنة

Browser Pixelبيكسل المتصفحServer APIواجهة برمجة السيرفر
Where it runsأين يعملIn the customer's browserفي متصفح العميلOn your serverعلى السيرفر
Matching methodطريقة المطابقةConsented platform/browser identifiersمعرّفات منصة/متصفح بموافقةAuthorized normalized and hashed identifiersمعرّفات مصرح بها وموحّدة ومُهشّمة
Match rateنسبة المطابقةMeasure in your destinationقِسها في وجهتكMeasure in your destinationقِسها في وجهتك
Blocked by ad blockersيحجبه مانع الإعلاناتYesنعمNoلا
Affected by privacy rulesيتأثر بقواعد الخصوصيةYesنعمYesنعم
Requires customer actionيتطلب تفاعل العميلOnly for the independent page purpose and optional consentفقط لغرض الصفحة المستقل والموافقة الاختياريةNo browser action; requires an eligible completed ledger recordلا يحتاج تفاعل متصفح؛ يحتاج سجل معاملة مكتملًا ومؤهلًا
Setup complexityتعقيد الإعدادConsent, authenticated token and purpose-limited endpointموافقة ورمز مصادق عليه ونقطة نهاية محدودة الغرضSigned webhook, durable queue and destination mapperWebhook موقّع وطابور موثوق ومحوّل خاص بالوجهة
TimingالتوقيتWhen the customer chooses the page actionعندما يختار العميل إجراء الصفحةAfter ledger completion, within the destination's documented limitsبعد اكتمال السجل وضمن حدود الوجهة الموثقة
Best forالأفضل لـAuthorized browser identifiers tied to an existing transactionمعرّفات متصفح مصرح بها ومرتبطة بمعاملة قائمةEligible transactions approved for that destinationالمعاملات المؤهلة والمعتمدة لتلك الوجهة

Choose Channels Per Destinationاختر القنوات لكل وجهة

Browser and server channels can be complementary, but neither is mandatory for every design. Use only channels covered by the consent and data-flow review. When both represent the same transaction, apply that destination's current deduplication contract and verify it with test events. Details in Section 07.قد تتكامل قناتا المتصفح والسيرفر، لكن لا توجد قناة إلزامية لكل تصميم. استخدم فقط القنوات التي يغطيها اعتماد الموافقة وتدفق البيانات. وعندما تمثل القناتان المعاملة نفسها، طبّق عقد منع التكرار الحالي لكل وجهة واختبره بأحداث تجريبية. التفاصيل في القسم 07.

Keep the Receipt Touchpoint Separate from the Purchase Eventافصل نقطة اتصال الإيصال عن حدث الشراء
Optional Browser Contextسياق متصفح اختياري
1
Customer opens linkالعميل يفتح الرابط
SMS, QR, WhatsApp, etc.SMS، QR، WhatsApp، إلخ.
2
Receipt is displayed safelyيُعرض الإيصال بأمان
Opaque token; no raw order ID or PII in the URLرمز مبهم؛ لا رقم طلب خام ولا بيانات شخصية في الرابط
3
Optional consented identifierمعرّف اختياري بموافقة
Sent to one named backend mapper; no Purchase on page viewيُرسل لمحوّل سيرفر واحد محدد؛ لا Purchase عند عرض الصفحة
Server API Pathمسار واجهة برمجة السيرفر
1
POS completes transactionنقطة البيع تكمل المعاملة
Minimal ledger fields; identifiers only when approvedالحد الأدنى من حقول السجل؛ المعرّفات فقط عند اعتمادها
2
Destination mapper validates eligibilityمحوّل الوجهة يتحقق من الأهلية
Separate schema, consent rule and scoped idempotency keyمخطط وقاعدة موافقة ومفتاح عدم تكرار مستقل
3
Destination processes the eventالوجهة تعالج الحدث
May accept, match or attribute under its rules; no guaranteeقد تقبل أو تطابق أو تُسند وفق قواعدها؛ بلا ضمان
A receipt view never authorizes Purchase. Only the completed ledger record enters a destination's event mapper.عرض الإيصال لا يسمح أبدًا بحدث Purchase. سجل المعاملة المكتمل وحده يدخل محوّل أحداث الوجهة.
Section 02bالقسم 02ب

Truthful Event Source, Destination-Specific Contractمصدر حدث صادق وعقد خاص بكل وجهة

Do not infer a universal online/offline taxonomy across Meta, TikTok and Google. Describe where the transaction actually completed, then map it to the current contract and eligibility rules for one destination at a time.لا تفترض تصنيفًا موحدًا للأونلاين والأوفلاين عبر Meta وTikTok وGoogle. صف مكان اكتمال المعاملة فعليًا، ثم حوّلها إلى العقد الحالي وقواعد الأهلية لكل وجهة على حدة.

The cards below use Meta's action_source terminology as an example only. Other destinations use different resources, fields and upload workflows, and availability can vary by account and objective.تستخدم البطاقتان أدناه مصطلح action_source في Meta كمثال فقط. الوجهات الأخرى تستخدم موارد وحقولًا ومسارات رفع مختلفة، وقد تختلف الإتاحة حسب الحساب والهدف.

Online Conversionتحويل أونلاين
action_source: "website"

Use a website action source only when the documented event actually happened on the website. Do not relabel an in-store transaction as an online purchase merely because a receipt was opened in a browser.استخدم مصدر إجراء الموقع فقط عندما وقع الحدث الموثق فعليًا على الموقع. لا تعِد تصنيف معاملة متجر كشراء أونلاين لمجرد فتح الإيصال في المتصفح.

Attribution settings: select and document the current window available for the campaign objective and destination. No universal 7-day/1-day setting applies.إعدادات الإسناد: اختر ووثّق النافذة الحالية المتاحة لهدف الحملة والوجهة. لا توجد قاعدة موحدة 7 أيام/يوم واحد.

When to use: for a real website transaction captured under the site's consent and event contract—not for a physical-store purchase.متى تستخدمه: لمعاملة موقع حقيقية جُمعت وفق موافقة الموقع وعقد الحدث، وليس لشراء من متجر فعلي.

Offline Conversionتحويل أوفلاين
action_source: "physical_store"

For Meta, this truthfully identifies that the documented transaction completed in a physical store. Meta may associate an eligible event with prior ad interactions under its current reporting rules; that association does not establish that the ad caused the sale.في Meta، يحدد هذا بصدق أن المعاملة الموثقة اكتملت في متجر فعلي. قد تربط Meta الحدث المؤهل بتفاعلات إعلانية سابقة وفق قواعد تقاريرها الحالية؛ وهذا الربط لا يثبت أن الإعلان سبب البيع.

Attribution model: platform, account, objective and eligibility rules vary. Verify current documentation and available settings; do not assume an extended window or store-visit modeling.نموذج الإسناد: تختلف القواعد حسب المنصة والحساب والهدف والأهلية. تحقق من الوثائق والإعدادات الحالية ولا تفترض نافذة ممتدة أو نمذجة لزيارة المتجر.

When to use: map the real physical-store transaction into each platform's documented offline contract. Meta's fields do not imply equivalent TikTok or Google fields.متى تستخدمه: حوّل معاملة المتجر الفعلية إلى عقد الأوفلاين الموثق لكل منصة. حقول Meta لا تعني وجود حقول مكافئة في TikTok أو Google.

Key Differences in Reporting & Optimizationالفروقات الرئيسية في التقارير والتحسين

Online Conversionتحويل أونلاينOffline Conversionتحويل أوفلاين
ReportingالتقاريرCurrent website-event reporting for the eligible setupتقارير أحداث الموقع الحالية للإعداد المؤهلCurrent physical-store/offline reporting when availableتقارير المتجر الفعلي/الأوفلاين الحالية عند إتاحتها
Attribution windowنافذة الإسنادCurrent account/objective settingإعداد الحساب/الهدف الحاليCurrent offline-event settingإعداد حدث الأوفلاين الحالي
Optimization signalإشارة التحسينDepends on eligibility and campaign setupتعتمد على الأهلية وإعداد الحملةDepends on eligibility and campaign setupتعتمد على الأهلية وإعداد الحملة
Revenue metricمؤشر الإيرادPlatform-reported attributed value, if configuredقيمة مُسندة في تقارير المنصة إذا تم إعدادهاPlatform-reported attributed value, if supportedقيمة مُسندة في تقارير المنصة إذا كانت مدعومة
Meta exampleمثال Metaaction_source: "website"action_source: "physical_store"
Authoritative sourceالمصدر المرجعيCompleted website transactionمعاملة موقع مكتملةCompleted POS ledger transactionمعاملة مكتملة في سجل نقطة البيع

Which Should You Use?أيهما يجب أن تستخدم؟

Use the truthful event source. A physical-store purchase should not be duplicated as a website purchase. If one destination legitimately receives browser and server representations of the same event, use its documented deduplication keys and test results; do not assume it will keep the "better" event.استخدم مصدر الحدث الحقيقي. لا تكرر شراء المتجر كشراء موقع. إذا استقبلت وجهة واحدة تمثيلين مشروعين من المتصفح والسيرفر للحدث نفسه، فاستخدم مفاتيح منع التكرار الموثقة واختبر النتيجة؛ ولا تفترض أن المنصة ستحتفظ بالحدث "الأفضل".

Don't Confuse Delivery Method with Event Typeلا تخلط بين طريقة التوصيل ونوع الحدث

Transport does not rewrite reality. A browser opening a receipt does not turn a store sale into a website purchase, and a field name alone does not make an event eligible. Preserve the completed POS source, use the destination's current offline workflow, and keep destination reporting separate from causal measurement.وسيلة النقل لا تعيد كتابة الواقع. فتح الإيصال في المتصفح لا يحول بيع المتجر إلى شراء موقع، واسم الحقل وحده لا يجعل الحدث مؤهلًا. احتفظ بمصدر نقطة البيع المكتمل واستخدم مسار الأوفلاين الحالي للوجهة وافصل تقارير الوجهة عن القياس السببي.

Section 03القسم 03

Data Capture Layerطبقة جمع البيانات

Eight optional touchpoint patterns. None creates the purchase: the completed POS ledger does. Evaluate each pattern for customer value, consent, accessibility, security and minimization before connecting it to any destination.ثمانية أنماط اختيارية لنقاط الاتصال. لا ينشئ أي منها الشراء؛ سجل نقطة البيع المكتمل هو المصدر. قيّم كل نمط لقيمة العميل والموافقة وإمكانية الوصول والأمن وتقليل البيانات قبل ربطه بأي وجهة.

A platform may use approved browser or hashed identifiers for matching, but collection must serve a disclosed purpose and remain optional where required. Never coerce a receipt, refund, Wi-Fi access or service benefit to manufacture tracking consent.قد تستخدم المنصة معرّفات متصفح أو معرّفات مُهشّمة معتمدة للمطابقة، لكن الجمع يجب أن يخدم غرضًا معلنًا ويظل اختياريًا حيث يلزم. لا تربط الإيصال أو الاسترداد أو Wi‑Fi أو منفعة خدمة بإجبار موافقة التتبع.

1
SMS Digital Receiptالإيصال الرقمي عبر SMS
Measure locallyقِس محليًا
1POS captures phone + completes saleنظام نقاط البيع يلتقط الهاتف + يُتم البيع
2System sends SMS: "Your receipt from [Store]"النظام يرسل SMS: "إيصالك من [المتجر]"
3Customer opens an authenticated receipt; no Purchase is createdالعميل يفتح إيصالًا مصادقًا عليه؛ لا يتم إنشاء Purchase

Send a short-lived opaque receipt URL—never a raw order ID. The page returns only authorized receipt fields. Any platform identifier is added to the existing transaction only under a separate approved consent flow; a phone number is not a "backup" permission to transmit PII.أرسل رابط إيصال مبهمًا وقصير العمر، وليس رقم طلب خامًا. تعرض الصفحة حقول الإيصال المصرح بها فقط. لا يُضاف أي معرّف منصة إلى المعاملة القائمة إلا ضمن موافقة مستقلة ومعتمدة؛ ورقم الهاتف ليس تصريحًا احتياطيًا لنقل البيانات الشخصية.

Conversion Tipsنصائح لزيادة التحويل
  • Use a truthful cashier script: explain what will be sent, why the number is needed, whether the receipt is available another way, and that statutory return or warranty rights do not depend on tracking consent.استخدم نصًا صادقًا للكاشير: وضّح ما سيُرسل ولماذا يلزم الرقم وهل يوجد بديل للإيصال، وأن حقوق الاسترجاع أو الضمان القانونية لا تعتمد على موافقة التتبع.
  • No artificial urgency: never use a countdown or false deadline to obtain consent or activate rights.لا تستخدم إلحاحًا مصطنعًا: لا تستخدم عدادًا أو مهلة زائفة للحصول على الموافقة أو لتفعيل الحقوق.
  • Minimize previews: avoid exposing sensitive order details on lock screens; use a generic store receipt message.قلّل تفاصيل المعاينة: تجنب كشف بيانات طلب حساسة على شاشة القفل؛ استخدم رسالة إيصال عامة باسم المتجر.
  • Send promptly and idempotently after the completed transaction, with delivery failure, suppression, opt-out and deletion handling.أرسل بسرعة ومن دون تكرار بعد اكتمال المعاملة، مع معالجة فشل التسليم وقوائم المنع وإلغاء الاشتراك والحذف.
2
QR Code at CheckoutQR Code عند الكاشير
Measure locallyقِس محليًا
1QR code printed on receipt or counter displayQR code مطبوع على الإيصال أو على شاشة الكاونتر
2Customer scans → lands on page with order contextالعميل يمسح ← يصل لصفحة ببيانات الطلب
3Page delivers customer value; tracking remains separate and optionalالصفحة تقدم قيمة للعميل؛ والتتبع منفصل واختياري

Use a dynamic, short-lived opaque token that reveals no order data in the URL. Scanning may open a receipt or genuine offer. Do not fire Purchase on scan or make the benefit conditional on unrelated advertising consent.استخدم رمزًا ديناميكيًا مبهمًا وقصير العمر لا يكشف بيانات الطلب في الرابط. قد يفتح المسح إيصالًا أو عرضًا حقيقيًا. لا تطلق Purchase عند المسح ولا تربط المنفعة بموافقة إعلانية غير مرتبطة.

Conversion Tipsنصائح لزيادة التحويل
  • Place the QR at eye level on the counter, not on a flat receipt the customer folds away. Use a branded acrylic stand.ضع الـ QR على مستوى النظر على الكاونتر، وليس على إيصال مسطح يطويه العميل. استخدم حامل أكريليك يحمل هوية العلامة التجارية.
  • Cashier script: "Scan this before you leave — you'll get 10% off your next visit. It expires in 48 hours."نص الكاشير: "امسح هذا قبل ما تمشي — هتاخد خصم 10% على زيارتك الجاية. ينتهي خلال 48 ساعة."
  • Use a unique opaque QR token with expiry, authentication, rate limiting and no PII or raw order identifier.استخدم رمز QR مبهمًا وفريدًا مع انتهاء صلاحية ومصادقة وحدود طلب، ومن دون بيانات شخصية أو رقم طلب خام.
  • State real offer terms plainly: no fake countdowns or pressure to share unnecessary information.اعرض شروط العرض الحقيقية بوضوح: لا عدادات زائفة ولا ضغط لمشاركة معلومات غير لازمة.
3
Store WiFi Captive Portalبوابة WiFi المتجر
Privacy review requiredتتطلب مراجعة خصوصية
1Customer connects to store WiFiالعميل يتصل بـ WiFi المتجر
2Portal explains terms and offers the minimum-access pathالبوابة تشرح الشروط وتوفر مسار الوصول بالحد الأدنى
3Optional marketing consent stays separate from WiFi accessموافقة التسويق الاختيارية تبقى منفصلة عن الوصول للـ WiFi

Do not use a WiFi login to infer a purchase or join a phone number to the latest transaction. Provide network access under clear terms; any marketing identifier or transaction association requires a separate, specific and valid basis.لا تستخدم دخول WiFi لاستنتاج شراء أو ربط رقم هاتف بآخر معاملة. وفّر الوصول للشبكة بشروط واضحة؛ وأي معرّف تسويقي أو ربط بمعاملة يحتاج أساسًا منفصلًا ومحددًا وصالحًا.

Conversion Tipsنصائح لزيادة التحويل
  • Name the WiFi network after the store (e.g., "MallOfArabia-Free") so customers actively seek it — don't use generic names like "FreeWiFi".سمّ شبكة WiFi باسم المتجر (مثل "MallOfArabia-Free") حتى يبحث العملاء عنها — لا تستخدم أسماء عامة مثل "FreeWiFi".
  • Never degrade alternatives to force WiFi dependency or consent. Accessibility and an honest choice matter more than capture rate.لا تعطل البدائل أبدًا لإجبار الاعتماد على WiFi أو الموافقة. إمكانية الوصول والاختيار الصادق أهم من معدل الجمع.
  • After connecting, offer a useful welcome page without hidden advertising tags. Load any optional marketing technology only after a separate valid choice.بعد الاتصال، قدّم صفحة ترحيب مفيدة من دون وسوم إعلانية خفية. لا تحمّل تقنية تسويقية اختيارية إلا بعد اختيار مستقل وصالح.
  • Do not collect a phone number by default. If a separate service genuinely needs one, explain that purpose, minimize retention and never auto-match it to a POS transaction.لا تجمع رقم الهاتف افتراضيًا. إذا احتاجت خدمة منفصلة الرقم فعلًا، فاشرح الغرض وقلّل مدة الاحتفاظ ولا تربطه تلقائيًا بمعاملة نقطة بيع.
4
Loyalty Program Registrationتسجيل برنامج الولاء
Separate purposeغرض منفصل
1Tablet at checkout: "Join & earn points on this purchase"تابلت عند الكاشير: "سجّل واكسب نقاط على مشترياتك"
2Customer joins through a purpose-limited loyalty formالعميل ينضم عبر نموذج ولاء محدود الغرض
3Loyalty ledger records points; no ad event is createdسجل الولاء يوثّق النقاط؛ ولا يُنشأ حدث إعلاني

A loyalty program has its own terms, customer value, retention and opt-out path. Link points to the completed transaction only for the disclosed loyalty purpose. Advertising use requires a separate approved basis and should not create a second Purchase event.برنامج الولاء له شروطه وقيمته للعميل وسياسة الاحتفاظ وإلغاء الاشتراك. اربط النقاط بالمعاملة المكتملة فقط لغرض الولاء المعلن. الاستخدام الإعلاني يحتاج أساسًا منفصلًا ومعتمدًا ولا ينبغي أن ينشئ حدث Purchase ثانيًا.

Conversion Tipsنصائح لزيادة التحويل
  • Use a neutral invitation: explain the loyalty benefit, terms, required fields, retention and opt-out without a speed claim or pressure.استخدم دعوة محايدة: اشرح منفعة الولاء والشروط والحقول المطلوبة والاحتفاظ وإلغاء الاشتراك من دون ادعاء سرعة أو ضغط.
  • Show verified value clearly: display points actually earned and current redemption terms; do not use lock-in as a design goal.اعرض القيمة المتحققة بوضوح: أظهر النقاط المكتسبة فعلًا وشروط الاستبدال الحالية؛ ولا تجعل حبس العميل هدفًا للتصميم.
  • Test a genuine enrollment offer only when its terms, expiry, eligibility and economics are approved and easy to understand.اختبر عرض تسجيل حقيقيًا فقط عندما تكون شروطه وانتهاؤه وأهليته واقتصادياته معتمدة وسهلة الفهم.
  • Collect the minimum identifier the program actually needs. Let the customer choose among supported contact methods where feasible; do not add email or phone merely for future marketing.اجمع أقل معرّف يحتاجه البرنامج فعلًا. دع العميل يختار من وسائل الاتصال المدعومة حيث أمكن؛ ولا تضف البريد أو الهاتف لمجرد تسويق مستقبلي.
5
WhatsApp Business Receiptإيصال WhatsApp Business
Verify eligibilityتحقق من الأهلية
1POS triggers WhatsApp message via Business APIنظام نقاط البيع يُرسل رسالة WhatsApp عبر Business API
2Customer receives receipt with "View details" linkالعميل يستقبل إيصالًا برابط "عرض التفاصيل"
3Opens authenticated receipt; no Purchase is createdيفتح إيصالًا مصادقًا عليه؛ ولا يُنشأ Purchase

Use an approved utility template, recipient eligibility, suppression and a short-lived opaque link. Measure delivery and open behavior in your own program; do not publish universal regional rates or turn receipt access into an ad event.استخدم قالب خدمة معتمدًا وأهلية مستلم وقوائم منع ورابطًا مبهمًا قصير العمر. قِس التسليم والفتح في برنامجك؛ ولا تنشر نسبًا إقليمية عامة أو تحول فتح الإيصال إلى حدث إعلاني.

Conversion Tipsنصائح لزيادة التحويل
  • Use an approved utility template with a clear CTA such as “View receipt,” then measure delivery and tap behavior in your own program instead of assuming a benchmark.استخدم قالب خدمة معتمدًا وزرًا واضحًا مثل «عرض الإيصال»، ثم قِس التسليم والنقر في برنامجك بدل افتراض معيار عام.
  • Minimize the notification preview: expose no amount, branch or product on a locked screen unless the privacy review explicitly permits it. Use a generic service notice and require authentication to view the receipt.قلل معاينة الإشعار: لا تعرض المبلغ أو الفرع أو المنتج على شاشة مقفلة إلا إذا سمحت مراجعة الخصوصية صراحة. استخدم إشعار خدمة عامًا واطلب المصادقة لعرض الإيصال.
  • Do not condition legal rights on opening. Send a reminder only when allowed, useful and within the stated service purpose.لا تربط الحقوق القانونية بالفتح. أرسل تذكيرًا فقط عندما يكون مسموحًا ومفيدًا وضمن غرض الخدمة المعلن.
  • Send only through an approved business identity whose current eligibility, template category and recipient rules have been verified; do not infer a universal response rate.أرسل فقط عبر هوية أعمال معتمدة تم التحقق من أهليتها الحالية وفئة القالب وقواعد المستلم؛ ولا تفترض معدل استجابة عامًا.
6
Post-Purchase Surveyاستبيان ما بعد الشراء
Measure locallyقِس محليًا
1At an approved time after purchase, invite feedbackفي توقيت معتمد بعد الشراء، اطلب التقييم
2Customer opens link to feedback pageالعميل يفتح رابط صفحة التقييم
3Survey records feedback only; no Purchase is createdالاستبيان يسجل التقييم فقط؛ ولا يُنشأ Purchase

Use an opaque survey token and collect only feedback needed for the stated research purpose. Page load and survey completion must not manufacture or duplicate a Purchase event.استخدم رمز استبيان مبهمًا واجمع فقط التقييم اللازم لغرض البحث المعلن. تحميل الصفحة أو إكمال الاستبيان لا يجوز أن ينشئ أو يكرر حدث Purchase.

Conversion Tipsنصائح لزيادة التحويل
  • Test timing locally: choose a service-appropriate window, honor messaging rules and quiet hours, and compare response and complaint rates without inventing a universal “sweet spot.”اختبر التوقيت محليًا: اختر نافذة مناسبة للخدمة واحترم قواعد الرسائل وساعات الهدوء وقارن الاستجابة والشكاوى من دون اختراع «وقت مثالي» عام.
  • State incentive terms clearly and provide the promised value regardless of sentiment; keep research consent separate from marketing.اعرض شروط الحافز بوضوح وقدّم القيمة الموعودة بغض النظر عن الرأي؛ وافصل موافقة البحث عن التسويق.
  • Keep the survey short because that respects attention—not because an unrelated pixel runs in the background.اجعل الاستبيان قصيرًا احترامًا لوقت العميل، وليس لأن بيكسلًا غير مرتبط يعمل في الخلفية.
  • Review feedback representatively: share permissioned, minimized themes—including criticism—with responsible teams. Do not incentivize selective solicitation of positive reviews.راجع التقييمات بشكل ممثل: شارك الموضوعات المصرح بها والمحدودة—بما فيها النقد—مع الفرق المسؤولة. لا تحفّز طلب التقييمات الإيجابية بشكل انتقائي.
7
Digital Warranty Registrationتسجيل الضمان الرقمي
Legal review requiredتتطلب مراجعة قانونية
1Product includes card: "Register warranty at [URL]"المنتج يتضمن بطاقة: "سجّل الضمان على [الرابط]"
2Customer enters phone + product serial onlineالعميل يدخل هاتفه + الرقم التسلسلي أونلاين
3Warranty record links to transaction for service onlyسجل الضمان يرتبط بالمعاملة لغرض الخدمة فقط

Collect the minimum service fields and link the serial to the transaction for warranty administration. Do not reuse warranty data for advertising or emit Purchase without a separate valid basis and explicit data-flow review.اجمع الحد الأدنى من حقول الخدمة واربط الرقم التسلسلي بالمعاملة لإدارة الضمان. لا تُعد استخدام بيانات الضمان للإعلانات ولا تطلق Purchase من دون أساس منفصل وصالح ومراجعة صريحة لتدفق البيانات.

Conversion Tipsنصائح لزيادة التحويل
  • Present service registration accessibly without implying that registration creates or limits statutory rights. State only reviewed warranty terms for the product and market.اعرض تسجيل الخدمة بطريقة سهلة الوصول من دون الإيحاء بأن التسجيل ينشئ الحقوق القانونية أو يحدها. اذكر فقط شروط الضمان التي تمت مراجعتها للمنتج والسوق.
  • Do not invent a registration deadline. State the actual warranty terms and statutory rights reviewed for the market.لا تخترع مهلة للتسجيل. اعرض شروط الضمان والحقوق القانونية الفعلية التي تمت مراجعتها للسوق.
  • Use an opaque product token in the QR code, then resolve the serial on the authenticated backend. Do not expose a serial, phone number or purchase reference in the URL.استخدم رمز منتج مبهمًا داخل QR ثم استخرج الرقم التسلسلي في السيرفر المصادق عليه. لا تكشف رقمًا تسلسليًا أو هاتفًا أو مرجع شراء في الرابط.
  • Confirm the recorded service details through an eligible channel. Show a coverage date only when calculated from verified purchase and policy data, with a correction route.أكد بيانات الخدمة المسجلة عبر قناة مؤهلة. لا تعرض تاريخ التغطية إلا إذا حُسب من بيانات شراء وسياسة متحققة، مع مسار للتصحيح.
8
In-Store Tablet at Checkoutتابلت داخل المتجر عند الكاشير
Explicit choice requiredيتطلب اختيارًا صريحًا
1Customer enters phone on tablet as part of checkoutالعميل يدخل رقمه على التابلت كجزء من الدفع
2Tablet records the selected receipt or loyalty purposeالتابلت يسجل غرض الإيصال أو الولاء المختار
3Backend isolates each session and creates no duplicate Purchaseالسيرفر يعزل كل جلسة ولا ينشئ Purchase مكررًا

A shared tablet can offer a receipt or loyalty choice, but it creates shoulder-surfing, session-isolation and device-security risk. Do not fire an advertising pixel from a shared store device and attribute its browser identity to the customer.قد يوفر التابلت المشترك اختيار الإيصال أو الولاء، لكنه يخلق مخاطر مشاهدة الشاشة وعزل الجلسات وأمن الجهاز. لا تطلق بيكسلًا إعلانيًا من جهاز متجر مشترك ثم تنسب هوية متصفحه للعميل.

Conversion Tipsنصائح لزيادة التحويل
  • Make the choice explicit and optional where required. Offer a paper or non-tracking receipt path and never disguise consent as a mandatory checkout step.اجعل الاختيار صريحًا واختياريًا حيث يلزم. وفّر مسار إيصال ورقي أو من دون تتبع ولا تخفِ الموافقة كخطوة دفع إلزامية.
  • Position the tablet facing the customer at waist height, like a payment terminal. It should feel like part of the checkout infrastructure, not a separate device.ضع التابلت مواجهًا للعميل على ارتفاع الخصر، مثل جهاز الدفع. يجب أن يبدو كجزء من بنية الكاشير، وليس جهازًا منفصلًا.
  • Clear every session deterministically. Remove prior data after submit, cancel and a risk-tested idle period; verify reset behavior on network and power failures rather than relying on one universal timeout.امسح كل جلسة بشكل حتمي. أزل البيانات السابقة بعد الإرسال أو الإلغاء وبعد مهلة خمول مختبرة حسب المخاطر؛ واختبر إعادة الضبط عند فشل الشبكة أو الكهرباء بدل الاعتماد على مهلة عامة.
  • Display "Your receipt has been sent" confirmation screen after submission. This closes the interaction loop and prevents the customer from asking "did it work?"اعرض شاشة تأكيد "تم إرسال إيصالك" بعد الإرسال. هذا يغلق حلقة التفاعل ويمنع العميل من السؤال "هل نجح؟"
  • Keep payment and optional data choices distinct. A single interface may be convenient, but it must clearly separate payment, receipt delivery, loyalty and marketing consent.افصل الدفع عن اختيارات البيانات الاختيارية. قد تكون الواجهة الواحدة مريحة، لكنها يجب أن تميز بوضوح بين الدفع وتسليم الإيصال والولاء والموافقة التسويقية.

Start Hereابدأ من هنا

Start with the completed POS ledger and one destination. Add a customer touchpoint only when it delivers independent value and passes consent, accessibility, security and minimization review. Measure your own opt-in and failure rates; do not rely on the illustrative percentages removed from this guide.ابدأ بسجل نقطة البيع المكتمل ووجهة واحدة. أضف نقطة اتصال بالعميل فقط عندما تقدم قيمة مستقلة وتجتاز مراجعة الموافقة وإمكانية الوصول والأمن وتقليل البيانات. قِس الاشتراك والفشل لديك ولا تعتمد على نسب توضيحية حُذفت من هذا الدليل.

Section 04القسم 04

Data Processing Pipelineخط معالجة البيانات

How a completed transaction becomes separate, auditable destination events without exposing receipt data or inventing browser purchases.كيف تتحول المعاملة المكتملة إلى أحداث مستقلة وقابلة للتدقيق لكل وجهة من دون كشف بيانات الإيصال أو اختراع مشتريات من المتصفح.

Canonical Ledger → Destination Mappers → Reconciliationالسجل المرجعي ← محولات الوجهات ← التسوية
1
POS reaches the defined completed stateنقطة البيع تصل إلى حالة الاكتمال المحددة
Internal reference · event time · value · currency · branch; no identifier unless approvedمرجع داخلي · وقت الحدث · القيمة · العملة · الفرع؛ بلا معرّف شخصي إلا عند اعتماده
2
Signed webhook is verified and persistedيتم التحقق من الـ webhook الموقّع وحفظه
Reject replays; validate totals and state transitions; record one canonical transactionارفض الإعادات؛ تحقق من الإجماليات وانتقالات الحالة؛ احفظ معاملة مرجعية واحدة
3
Create a separate delivery record per destinationأنشئ سجل تسليم مستقلًا لكل وجهة
Meta key: meta_7f… · TikTok key: tt_b3… · Google transaction ID: gads_91…مفتاح Meta: meta_7f… · مفتاح TikTok: tt_b3… · معرّف Google: gads_91…
4
Each mapper applies its own current contractكل محوّل يطبق عقده الحالي
Destination fields · approved identifiers · version · retry policy · retention · deletionحقول الوجهة · المعرّفات المعتمدة · الإصدار · سياسة المحاولة · الاحتفاظ · الحذف
5
Reconcile delivery and platform reportingسوِّ التسليم وتقارير المنصة
Accepted is not matched; matched is not attributed; attributed is not causalالقبول ليس مطابقة؛ والمطابقة ليست إسنادًا؛ والإسناد ليس سببية

The critical design decision is step 3: namespace every external identifier by destination. Keep the raw POS reference internal. Generate opaque, stable keys for retries within one destination, and never reuse a cross-platform customer or transaction identifier merely for convenience.القرار التصميمي الحاسم هو الخطوة 3: تخصيص نطاق كل معرّف خارجي حسب الوجهة. احتفظ بمرجع نقطة البيع الخام داخليًا. أنشئ مفاتيح مبهمة وثابتة للمحاولات داخل وجهة واحدة، ولا تعِد استخدام معرّف عميل أو معاملة عبر المنصات لمجرد السهولة.

Event Time Is Not Delivery Timeوقت الحدث ليس وقت التسليم

Record the actual completed-purchase time from the POS and send or retry within each destination's current acceptance limits. A delayed queue must preserve that event time. Do not use receipt-open time, a universal seven-day window or the moment of retry as the purchase time.سجّل وقت اكتمال الشراء الفعلي من نقطة البيع وأرسل أو أعد المحاولة ضمن حدود القبول الحالية لكل وجهة. يجب أن يحافظ الطابور المتأخر على وقت الحدث. لا تستخدم وقت فتح الإيصال أو نافذة سبعة أيام عامة أو لحظة إعادة المحاولة كوقت للشراء.

Section 05القسم 05

Safe Receipt-Page Implementationتطبيق آمن لصفحة الإيصال

A receipt page displays authorized receipt data. It does not create, replay or reclassify the completed in-store Purchase event.صفحة الإيصال تعرض بيانات إيصال مصرحًا بها. ولا تنشئ أو تعيد أو تعيد تصنيف حدث Purchase المكتمل في المتجر.

Opaque, Short-Lived Locatorمُعرّف مبهم وقصير العمر

Put only a random, scoped receipt token in the URL. Never include a POS order number, phone, email, name or other personal data. Resolve the token on your authenticated backend, expire it, rate-limit it and return the minimum receipt view.ضع في الرابط رمز إيصال عشوائيًا ومحدود النطاق فقط. لا تضع رقم طلب نقطة البيع أو الهاتف أو البريد أو الاسم أو أي بيانات شخصية. استخرج الرمز في السيرفر المصادق عليه وحدد صلاحيته وطلبات استخدامه وأعد الحد الأدنى من عرض الإيصال.

Receipt URL — no order ID or PIIرابط الإيصال — بلا رقم طلب أو بيانات شخصية
https://receipts.yourbrand.example/r?token=rt_7Kp9mQ2x...
Browser — fetch the receipt, never fire Purchaseالمتصفح — اجلب الإيصال ولا تطلق Purchase
// The token is opaque, scoped, short-lived and contains no business identifier. const token = new URL(location.href).searchParams.get('token'); if (!token) throw new Error('Missing receipt token'); const response = await fetch('/api/receipts/view', { method: 'POST', credentials: 'same-origin', headers: { 'Content-Type': 'application/json', 'X-CSRF-Token': csrfToken }, body: JSON.stringify({ token: token }) }); // Render only the authorized receipt fields returned by your backend. // Do not call fbq('track', 'Purchase'), ttq.track(), or gtag('event', 'purchase').

Optional Advertising Consent Is a Separate Flowالموافقة الإعلانية الاختيارية مسار منفصل

If a reviewed design allows a browser identifier to enrich the canonical transaction, obtain the required consent first and POST to a destination-named backend endpoint. Send no order value or PII from the page, do not load unrelated destination tags, and never make receipt access depend on advertising consent.إذا سمح التصميم المُراجع لمعرّف متصفح بإثراء المعاملة المرجعية، فاحصل على الموافقة المطلوبة أولًا وأرسل إلى نقطة سيرفر باسم الوجهة. لا ترسل قيمة الطلب أو بيانات شخصية من الصفحة ولا تحمّل وسوم وجهات غير مرتبطة ولا تجعل الوصول للإيصال معتمدًا على الموافقة الإعلانية.

Section 06القسم 06

Server-Side Implementationالتطبيق من جانب السيرفر

Map eligible completed transactions from your server into separately reviewed destination contracts. Delivery can be reliable without promising acceptance, identity matching, attribution or all-customer coverage.حوّل المعاملات المكتملة والمؤهلة من السيرفر إلى عقود وجهات تمت مراجعتها بشكل مستقل. قد يكون التسليم موثوقًا من دون وعد بالقبول أو مطابقة الهوية أو الإسناد أو تغطية كل العملاء.

Why the Ledger-to-Server Path Mattersلماذا يهم مسار السجل إلى السيرفر

The completed POS record is independent of whether anyone opens an SMS or scans a QR code. A signed, replay-protected webhook lets your system validate state, queue eligible deliveries and reconcile failures without using a receipt view as the transaction trigger.سجل نقطة البيع المكتمل مستقل عن فتح رسالة أو مسح QR. يتيح webhook موقّع ومحمي من الإعادة للنظام التحقق من الحالة ووضع عمليات التسليم المؤهلة في طابور وتسوية الأعطال من دون استخدام عرض الإيصال كمحفز للمعاملة.

When an approved destination supports normalized and hashed identifiers, it may use them as matching signals. They are pseudonymous—not deterministic proof of identity—and privacy controls, account eligibility, data quality and destination models still limit results.عندما تدعم وجهة معتمدة معرّفات موحّدة ومُهشّمة، قد تستخدمها كإشارات للمطابقة. هي بيانات مستعارة وليست إثباتًا حتميًا للهوية؛ وتظل ضوابط الخصوصية وأهلية الحساب وجودة البيانات ونماذج الوجهة عوامل تحد النتائج.

The Three APIsالواجهات البرمجية الثلاث

Meta Conversions API

Use Meta's current dataset event contract. Send only approved fields, normalize and hash supported identifiers exactly as documented, and use a Meta-scoped event_id for retries or legitimate Meta-only deduplication.استخدم عقد أحداث مجموعة البيانات الحالي في Meta. أرسل الحقول المعتمدة فقط ووحّد واهشم المعرّفات المدعومة كما هو موثق واستخدم event_id خاصًا بـ Meta للمحاولات أو منع التكرار المشروع داخل Meta فقط.

POST graph.facebook.com /v26.0/{dataset_id}/events // Re-check the current supported version before deployment.
TikTok Events API

Use TikTok's current Events API resource and offline-event rules for your account. Build a TikTok-specific payload and key; do not copy Meta field names, action sources or identifiers.استخدم مورد TikTok Events API الحالي وقواعد أحداث الأوفلاين لحسابك. ابنِ حمولة ومفتاحًا خاصين بـ TikTok ولا تنسخ أسماء حقول Meta أو مصادرها أو معرّفاتها.

Follow the current TikTok Events API documentation for the approved account and event source.
Google Enhanced Conversions

Choose the Google workflow that matches the real source—such as an eligible click conversion, enhanced conversions for leads, or store-sales upload. Each uses different prerequisites and services; none is a renamed Meta event.اختر مسار Google المطابق للمصدر الحقيقي، مثل تحويل نقرة مؤهل أو Enhanced Conversions for Leads أو رفع مبيعات المتجر. لكل منها متطلبات وخدمات مختلفة؛ ولا يُعد أي منها حدث Meta باسم جديد.

Select and implement one current Google Ads offline-conversion workflow from official documentation.

What You Send (Meta CAPI Example)ماذا ترسل (مثال Meta CAPI)

Meta CAPI — Server-Side Purchase Event
{ "data": [{ "event_name": "Purchase", "event_time": 1711640520, "event_id": "meta_7f4b0c...", "action_source": "physical_store", "user_data": { "ph": ["a1b2c3...approved_sha256_phone"] }, "custom_data": { "value": 1240.00, "currency": "EGP", "content_ids": ["SKU-POLO-001", "SKU-SNKR-042"], "content_type": "product", "order_id": "meta_txn_91d2..." } }] }

action_source: "physical_store"

In this Meta example, the field truthfully identifies the physical-store source. The opaque event_id and order_id are scoped to Meta and do not expose the raw POS reference. Do not translate these fields mechanically into TikTok or Google; implement and test each destination's current contract independently.في مثال Meta هذا، يحدد الحقل مصدر المتجر الفعلي بصدق. معرّفا event_id وorder_id مبهمان وخاصان بـ Meta ولا يكشفان مرجع نقطة البيع الخام. لا تحول هذه الحقول آليًا إلى TikTok أو Google؛ طبّق واختبر عقد كل وجهة الحالي بشكل مستقل.

Section 07القسم 07

Idempotency & Destination-Specific Deduplicationمنع التكرار ومفاتيح مستقلة لكل وجهة

The completed POS transaction is the one source record. Prevent replay and retry duplicates inside your ledger first, then derive a different opaque idempotency key for every approved destination. A receipt-page view never creates a second Purchase event.معاملة نقطة البيع المكتملة هي سجل المصدر الوحيد. امنع تكرار الإرسال والمحاولات داخل سجلك أولًا، ثم أنشئ مفتاحًا مبهمًا مختلفًا لكل وجهة معتمدة. عرض صفحة الإيصال لا ينشئ حدث Purchase ثانيًا.

One Ledger Record, Separate Delivery Keysسجل واحد ومفاتيح إرسال منفصلة
Completed POS Ledgerسجل نقطة البيع المكتمل
Internal reference stays privateالمرجع الداخلي يبقى خاصًا
🔑
Namespace Mapperمحول النطاقات
HMAC or random opaque mappingHMAC أو ربط عشوائي مبهم
Destination Keysمفاتيح الوجهات
meta_7f… · tt_b3… · gads_91…

How It Worksكيف يعمل

Enforce uniqueness on the canonical transaction and store one delivery record per destination. Reuse a destination's own key only for a legitimate retry to that same destination. Never put a raw order ID, phone, email, or timestamp-derived POS reference in an external key.افرض التفرد على المعاملة المرجعية واحفظ سجل إرسال لكل وجهة. أعد استخدام مفتاح الوجهة نفسها فقط عند محاولة مشروعة لنفس الوجهة. لا تضع رقم طلب خامًا أو هاتفًا أو بريدًا أو مرجع نقطة بيع مشتقًا من الوقت في مفتاح خارجي.

// Server-side pseudocode; keep the secret in a managed secret store meta_event_id = HMAC(scope_secret, "meta:" + canonical_ref) tiktok_event_id = HMAC(scope_secret, "tiktok:" + canonical_ref) google_transaction_id = HMAC(scope_secret, "google-ads:" + canonical_ref) // Persist the mapping; never export canonical_ref or reuse a key cross-platform.

Three Retry Scenariosثلاثة سيناريوهات للمحاولة

ScenarioالسيناريوWhat Happensماذا يحدثResultالنتيجة
POS webhook replayإعادة webhook نقطة البيعSignature, replay window, and canonical uniqueness are checked before enqueueingيتم فحص التوقيع ونافذة الإعادة وتفرد السجل المرجعي قبل الإدراجDuplicate rejectedرفض التكرار
Meta delivery times outانتهاء مهلة إرسال MetaRetry only after inspecting the response state, using the persisted Meta-scoped keyأعد المحاولة بعد فحص حالة الاستجابة وبمفتاح Meta المحفوظ فقطReconcile statusسوِّ الحالة
TikTok or Google deliveryإرسال TikTok أو GoogleUse that destination's current schema, eligibility rules, and independent keyاستخدم مخطط الوجهة وقواعد أهليتها الحالية ومفتاحها المستقلNo cross-platform reuseلا إعادة استخدام بين المنصات

Deduplication Reduces Risk; It Is Not a Guaranteeمنع التكرار يقلل الخطر ولا يضمن النتيجة

Confirm behavior in each destination's current diagnostics and reconcile it to the ledger. If a genuine website purchase is intentionally sent to Meta through both Pixel and Conversions API, follow Meta's current same-event deduplication contract inside Meta only. This physical-store design uses the server ledger event; the receipt view is never its browser duplicate.تحقق من السلوك في تشخيصات كل وجهة الحالية وسوّه مع السجل. إذا أُرسل شراء موقع حقيقي عمدًا إلى Meta عبر Pixel وConversions API، فاتبع عقد Meta الحالي لمنع تكرار الحدث نفسه داخل Meta فقط. تصميم المتجر الفعلي هذا يستخدم حدث السجل من السيرفر؛ عرض الإيصال ليس نسخة متصفح منه.

Section 08القسم 08

Data Schema Referenceمرجع هيكل البيانات

The exact fields sent in every Purchase event — across all platforms and both channels.الحقول المحددة المرسلة في كل حدث شراء — عبر جميع المنصات وكلتا القناتين.

Purchase Event Payloadحمولة حدث الشراء

FieldالحقلTypeالنوعDescriptionالوصفExampleمثال
event_namestringAlways "Purchase"دائمًا "Purchase"Purchase
event_idstringUnique ID for deduplicationمعرّف فريد لمنع التكرارevt_28401_1711640520
event_timeintegerUnix timestamp of purchaseالطابع الزمني Unix للشراء1711640520
action_sourcestring"physical_store" for offline"physical_store" للأوفلاينphysical_store
valuefloatTotal order valueإجمالي قيمة الطلب1240.00
currencystringISO 4217 currency codeكود العملة ISO 4217EGP
order_idstringYour POS order referenceمرجع طلب نظام نقاط البيعORD-28401
content_idsarrayProduct SKUs in the orderأكواد المنتجات في الطلب["SKU-POLO-001"]
content_typestringType of contentنوع المحتوىproduct

Destination-approved identifiersالمعرّفات المعتمدة للوجهة

Send only identifiers required by the current destination contract and approved for the stated purpose. Normalize exactly as documented before SHA-256 hashing. Hashing is pseudonymisation—not encryption, anonymisation, consent, or a substitute for data-protection controls.أرسل فقط المعرّفات المطلوبة في عقد الوجهة الحالي والمعتمدة للغرض المحدد. وحّدها كما تنص الوثائق قبل استخدام SHA‑256. الهاش إخفاء جزئي للهوية وليس تشفيرًا أو إخفاءً تامًا أو موافقة أو بديلًا لضوابط حماية البيانات.

FieldالحقلTypeالنوعDescriptionالوصفDestination hashing ruleقاعدة الهاش الخاصة بالوجهة
phstringPhone number (E.164 format)رقم الهاتف (صيغة E.164)SHA-256
emstringEmail address (lowercase)البريد الإلكتروني (أحرف صغيرة)SHA-256
fnstringFirst name (lowercase)الاسم الأول (أحرف صغيرة)SHA-256
lnstringLast name (lowercase)اسم العائلة (أحرف صغيرة)SHA-256
countrystringISO country codeكود الدولة ISOSHA-256

Minimum Necessary Dataالحد الأدنى اللازم من البيانات

Do not maximize identifiers to chase an unsupported benchmark. Start from purpose and data minimization, send only approved fields, measure destination diagnostics, and document the tradeoff before requesting any additional identifier.لا تزد عدد المعرّفات لملاحقة معيار غير موثّق. ابدأ بالغرض وتقليل البيانات، وأرسل الحقول المعتمدة فقط، وقِس تشخيصات الوجهة، ووثّق المفاضلة قبل طلب أي معرّف إضافي.

Section 09القسم 09

Multi-Branch Considerationsاعتبارات تعدد الفروع

If you operate more than one store location, the system needs to track which branch each purchase came from — so you can measure performance per location.إذا كنت تدير أكثر من موقع متجر، النظام يحتاج لتتبع من أي فرع جاء كل شراء — حتى تتمكن من قياس الأداء لكل موقع.

Why Branch-Level Tracking Mattersلماذا تتبع مستوى الفرع مهم

A governed branch identifier can support location-level reconciliation and reporting. Platform attribution does not prove which campaign caused store revenue, and branch comparison may be confounded by inventory, hours, catchment, staffing, promotions and measurement coverage. The examples below are synthetic teaching values.يمكن لمعرّف فرع محكوم دعم التسوية والتقارير حسب الموقع. إسناد المنصة لا يثبت أي حملة سببت إيراد المتجر، وقد تتأثر مقارنة الفروع بالمخزون والساعات والنطاق الجغرافي والفريق والعروض وتغطية القياس. القيم أدناه أمثلة تعليمية افتراضية.

How to Implement Branch Taggingكيف تطبّق وسم الفروع

1. POS-Level: Tag Every Transaction with a Branch ID1. مستوى نظام نقاط البيع: وسم كل معاملة بمعرّف الفرع

Your POS system should include a branch_id or store_location field in every transaction record. Most multi-location POS systems do this natively. If yours doesn't, configure it — this is the foundation everything else is built on.نظام نقاط البيع يجب أن يتضمن حقل branch_id أو store_location في كل سجل معاملة. معظم أنظمة نقاط البيع متعددة المواقع تفعل ذلك أساسًا. إذا لم يكن كذلك، اضبطه — هذا هو الأساس الذي يُبنى عليه كل شيء.

2. Destination Mapping: Map Branch Only Where Supported2. تحويل الوجهة: أرسل الفرع فقط حيث تدعمه الوجهة

The completed POS ledger emits one canonical server-side transaction. A destination mapper includes a branch or store field only if the current official contract supports it and the purpose is approved. Do not invent a browser Purchase or overload an unrelated field such as product category.يرسل سجل نقطة البيع المكتمل معاملة مرجعية واحدة من السيرفر. يضم محول الوجهة حقل الفرع أو المتجر فقط إذا كان العقد الرسمي الحالي يدعمه والغرض معتمدًا. لا تنشئ Purchase من المتصفح ولا تستخدم حقلًا غير متعلق مثل فئة المنتج.

Server-side destination mapper (pseudocode)محول وجهة من السيرفر (كود توضيحي)
// Never emitted by opening a receipt page. canonical = ledger.getCompletedTransaction(verified_webhook_ref) mapping = currentDestinationContract.validate({ destination_event_id: deriveScopedId(destination, canonical.ref), store_field: approvedStoreMapping(canonical.branch_id) }) deliveryJournal.enqueue(mapping) // stable key, retry + reconciliation

3. Campaign-Level: Geo-Target Each Branch3. مستوى الحملة: استهداف جغرافي لكل فرع

If a branch-specific campaign structure is justified, draft it as a proposal and check platform policy, geographic eligibility, audience size, incrementality, economics and operational capacity. An authorized owner approves the exact account, targeting, budget and immutable diff before a controlled executor creates anything.إذا كان هيكل حملة خاص بفرع مبررًا، اكتبه كاقتراح وافحص سياسة المنصة وأهلية الموقع وحجم الجمهور والأثر الإضافي والاقتصاديات والقدرة التشغيلية. يوافق مالك مخول على الحساب والاستهداف والميزانية والفرق الثابت بدقة قبل أن ينشئ المنفذ المحكوم أي شيء.

utm_term=branch_[OPAQUE_APPROVED_CODE_A] utm_term=branch_[OPAQUE_APPROVED_CODE_B]

4. Reporting: Branch-Level ROAS4. التقارير: ROAS على مستوى الفرع

With branch tagging in place, you can build reporting that shows per-branch metrics:مع وسم الفروع في مكانه، يمكنك بناء تقارير تعرض مؤشرات كل فرع:

BranchالفرعAd Spendالإنفاق الإعلانيAttributed Revenueالإيرادات المُسندةROASActionالإجراء
Branch Aالفرع أVerified ledger inputمدخل متحقق من السجلPlatform-attributed fieldحقل إسناد المنصةDescriptive onlyInvestigate incrementality, margin and capacity; draft a bounded proposalافحص الأثر الإضافي والهامش والقدرة؛ واكتب اقتراحًا محدودًا
Branch Bالفرع بVerified ledger inputمدخل متحقق من السجلPlatform-attributed fieldحقل إسناد المنصةDescriptive onlyDocument hypotheses and propose a controlled testوثّق الفرضيات واقترح اختبارًا محكومًا
Branch Cالفرع جVerified ledger inputمدخل متحقق من السجلPlatform-attributed fieldحقل إسناد المنصةInvestigateCheck measurement and operational confounders; no automatic reductionافحص القياس والعوامل التشغيلية؛ لا خفض تلقائيًا

5. Scaling: What Changes with More Branches5. التوسع: ما يتغير مع فروع أكثر

1–3 Branches1–3 فروع

Choose account, server, tagging and reporting boundaries from the POS architecture, legal entities, access model, load and recovery needs. A small branch count does not prove one shared account or server is safe.اختر حدود الحساب والسيرفر والوسم والتقارير حسب بنية نقطة البيع والكيانات القانونية ونموذج الوصول والحمل والتعافي. قلة عدد الفروع لا تثبت أن حسابًا أو سيرفرًا مشتركًا آمن.

4–10 Branches4–10 فروع

Validate branch tagging, isolate access and standardize reporting. A model may propose a budget change, but an authorized owner must review the complete immutable diff, incrementality, unit economics, account binding, caps, stop and rollback before a deterministic executor acts.تحقق من وسم الفروع وافصل الوصول ووحّد التقارير. قد يقترح النموذج تغيير الميزانية، لكن يجب أن يراجع مالك مخول الفرق الكامل الثابت والأثر الإضافي واقتصاديات الوحدة وربط الحساب والحدود والإيقاف والرجوع قبل تنفيذ خدمة حتمية.

10–50 Branches10–50 فرع

Evaluate maintainable middleware, tenant and region isolation, destination reconciliation and account-calibrated alerts. Keep budget changes proposal-only until exact preapproval; use idempotency, caps, audit, stop and rollback in the executor.قيّم سيرفرًا وسيطًا قابلًا للصيانة، وفصل المستأجر والمنطقة، وتسوية الوجهات، وتنبيهات معايرة للحساب. اجعل تغييرات الميزانية اقتراحات فقط حتى الموافقة الدقيقة؛ واستخدم منع التكرار والحدود والتدقيق والإيقاف والرجوع في المنفذ.

50+ Branches (Franchise/Chain)50+ فرع (امتياز/سلسلة)

Larger estates need architecture based on measured load and risk—not a branch-count slogan. Separate tenant and regional access, minimize retained POS data, test isolation and recovery, and require exact approval before any campaign is created.تحتاج الشبكات الأكبر بنية مبنية على الحمل والمخاطر المقاسة لا شعار عدد الفروع. افصل الوصول حسب المستأجر والمنطقة، وقلل بيانات نقاط البيع المحتفظ بها، واختبر العزل والتعافي، واطلب موافقة دقيقة قبل إنشاء أي حملة.

Section 10القسم 10

For Business Owners: Your Role vs Your Technical Team's Roleلأصحاب الأعمال: دورك مقابل دور فريقك التقني

You don't need to write code. But you do need to make decisions, provide access, and manage the operational side. Here's the split.لا تحتاج لكتابة كود. لكنك تحتاج لاتخاذ قرارات، وتوفير الصلاحيات، وإدارة الجانب التشغيلي. إليك التقسيم.

What You (the Business Owner) Handleما تتولاه أنت (صاحب العمل)

1. Decide Which Capture Methods to Use1. حدد طرق جمع البيانات المناسبة

Start from the completed ledger. Add at most one justified customer touchpoint at a time after purpose, eligibility, accessibility, security, consent and support review; expand only from measured customer value and acceptable harm.ابدأ من السجل المكتمل. أضف نقطة اتصال واحدة مبررة في كل مرة بعد مراجعة الغرض والأهلية وسهولة الوصول والأمن والموافقة والدعم؛ ووسّع فقط بناءً على قيمة عميل مقاسة وضرر مقبول.

2. Train Your Store Staff2. درّب موظفي المتجر

Train staff to separate receipt delivery, loyalty, research and marketing choices; explain alternatives and never improvise consent or offer terms. Test comprehension and provide an escalation route.درّب الموظفين على فصل اختيارات تسليم الإيصال والولاء والبحث والتسويق؛ وشرح البدائل وعدم ارتجال الموافقة أو شروط العرض. اختبر الفهم ووفر مسار تصعيد.

3. Provide Access to POS & Ad Accounts3. وفّر الصلاحيات لنظام نقاط البيع وحسابات الإعلانات

Approve named service identities with the minimum tenant-, account- and operation-specific permissions. Separate configuration, read and write access; set review dates, log use and revoke access after the work.اعتمد هويات خدمة مسماة بأقل صلاحيات خاصة بالمستأجر والحساب والعملية. افصل صلاحيات الإعداد والقراءة والكتابة؛ وحدد مراجعة وسجل الاستخدام واسحب الوصول بعد العمل.

4. Set a Tracking Domain4. حدد نطاق التتبع

Approve a purpose-specific domain only after ownership, DNS change control, TLS, authentication, logging, incident response and decommissioning are assigned. Effort depends on the existing environment.اعتمد نطاقًا مخصصًا للغرض فقط بعد تحديد ملكية DNS وضبط التغييرات وTLS والمصادقة والسجلات والاستجابة للحوادث والإيقاف. الجهد يعتمد على البيئة القائمة.

5. Review Weekly Reports5. راجع التقارير الأسبوعية

Your technical team builds the reports; you read them. Key questions: Which branches are performing? Which capture methods have the best rates? Is ROAS above target? Where should we spend more?فريقك التقني يبني التقارير؛ أنت تقرأها. الأسئلة الرئيسية: أي فروع تؤدي جيدًا؟ أي طرق التقاط لديها أفضل المعدلات؟ هل ROAS فوق المستهدف؟ أين يجب أن ننفق أكثر؟

6. Make Budget Decisions6. اتخذ قرارات الميزانية

Review attribution alongside incrementality, margin, inventory and service capacity. Approve only a complete, account-bound proposal with caps, freshness check, stop condition and rollback; attribution numbers alone do not justify reallocation.راجع الإسناد مع الأثر الإضافي والهامش والمخزون وقدرة الخدمة. وافق فقط على اقتراح كامل مربوط بالحساب مع حدود وفحص حداثة وشرط إيقاف ورجوع؛ أرقام الإسناد وحدها لا تبرر إعادة التوزيع.

What Your Technical Team Handlesما يتولاه فريقك التقني

1. POS Integration & Webhooks1. تكامل نظام نقاط البيع و Webhooks

Configure the POS to send transaction data to the middleware server via webhooks. This is platform-specific and requires API access.ضبط نظام نقاط البيع لإرسال بيانات المعاملات إلى السيرفر الوسيط عبر webhooks. هذا خاص بكل منصة ويتطلب صلاحية API.

2. Build Landing Pages2. بناء صفحات الهبوط

Build only approved touchpoints. Each page gets the minimum authorized fields, strong authentication where needed, accessibility, consent-aware tags, security headers, expiry and deletion; no advertising pixel is installed by default.ابنِ فقط نقاط الاتصال المعتمدة. تحصل كل صفحة على أقل حقول مصرح بها ومصادقة قوية عند الحاجة وسهولة وصول ووسوم تراعي الموافقة ورؤوس أمان وانتهاء وحذف؛ ولا يُثبت بيكسل إعلاني افتراضيًا.

3. Middleware Server3. السيرفر الوسيط

Build and maintain the server that receives POS webhooks, triggers capture methods (SMS, WhatsApp), and sends server-side API events to ad platforms.بناء وصيانة السيرفر الذي يستقبل webhooks نظام نقاط البيع، ويُشغّل طرق الالتقاط (SMS، WhatsApp)، ويرسل أحداث API من جانب السيرفر لمنصات الإعلانات.

4. Pixel & API Configuration4. ضبط البيكسل و API

Configure only approved destination integrations. Keep tokens in a managed secret store, apply current destination schemas, pseudonymize with SHA-256 only where the contract requires it, and implement destination-specific idempotency and reconciliation. Hashed personal data remains protected data.اضبط فقط تكاملات الوجهات المعتمدة. احتفظ بالرموز في مخزن أسرار مُدار، وطبق مخططات الوجهات الحالية، واستخدم SHA-256 للإخفاء الجزئي فقط حيث يتطلبه العقد، ونفّذ منع التكرار والتسوية بشكل مستقل لكل وجهة. تظل البيانات الشخصية بعد الهاش بيانات محمية.

5. SMS/WhatsApp Gateway5. بوابة SMS/WhatsApp

Evaluate eligible providers against current official channel rules, security, regional support, consent, recipient verification, suppression, opt-out, quiet hours, retention, delivery failure and deletion. Keep service and marketing purposes separate.قيّم المزودين المؤهلين وفق قواعد القناة الرسمية الحالية والأمن والدعم الإقليمي والموافقة والتحقق من المستلم والاستبعاد وإلغاء الاشتراك وساعات الهدوء والاحتفاظ وفشل التسليم والحذف. افصل غرض الخدمة عن التسويق.

6. Monitoring & Debugging6. المراقبة وإصلاح الأخطاء

Monitor ledger reconciliation, acceptance, duplicates, retries, match diagnostics, consent and deletion. Alerts trigger investigation and an owned incident path; platform attribution remains an estimate, not “accuracy.”راقب تسوية السجل والقبول والتكرار والمحاولات وتشخيصات المطابقة والموافقة والحذف. التنبيهات تبدأ التحقيق ومسار حادث بمسؤول؛ ويظل إسناد المنصة تقديرًا لا «دقة» مؤكدة.

Don't Try to Do the Technical Work Yourselfلا تحاول القيام بالعمل التقني بنفسك

This system involves server infrastructure, API integrations, pseudonymization, consent and lawful-basis controls, destination-specific reconciliation and incident response. Assign qualified technical, privacy, security and business owners; no vendor selection removes the organization's accountability.يتضمن النظام بنية سيرفرات وتكاملات API وإخفاءً جزئيًا للهوية وضوابط الموافقة أو الأساس القانوني وتسوية خاصة بكل وجهة واستجابة للحوادث. عيّن مسؤولين مؤهلين للتقنية والخصوصية والأمن والعمل؛ واختيار مزود لا يلغي مسؤولية المؤسسة.

Important Disclaimerإخلاء مسؤولية مهم

All code snippets, API endpoints, and technical examples in this document are illustrative only. They show the structure and logic of the implementation — not production-ready code. API versions, field names, and authentication methods change frequently.جميع مقتطفات الكود ونقاط الـ API والأمثلة التقنية في هذا المستند هي توضيحية فقط. تعرض هيكل ومنطق التطبيق — وليست كودًا جاهزًا للإنتاج. إصدارات API وأسماء الحقول وطرق المصادقة تتغير باستمرار.

The technical implementation should only be done by a qualified developer, agency, or technical partner who can verify current API documentation, handle authentication, error handling, data security, and compliance requirements (including GDPR/data privacy if applicable).التطبيق التقني يجب أن يتم فقط بواسطة مطور مؤهل أو وكالة أو شريك تقني يستطيع التحقق من وثائق API الحالية، والتعامل مع المصادقة، ومعالجة الأخطاء، وأمن البيانات، ومتطلبات الامتثال (بما في ذلك GDPR/خصوصية البيانات إن وُجدت).

Always refer to the official documentation for the latest API versions: Meta for Developers, TikTok for Business Developers, and Google Ads API documentation.ارجع دائمًا للوثائق الرسمية لأحدث إصدارات API: Meta for Developers وTikTok for Business Developers وGoogle Ads API documentation.

Section 11القسم 11

Implementation Checklistقائمة التنفيذ

Follow these steps in order. Each step depends on the previous one being complete.اتبع هذه الخطوات بالترتيب. كل خطوة تعتمد على اكتمال الخطوة السابقة.

Approve the architecture and data contractاعتمد البنية وعقد البيانات

Name controller/processor roles, purpose, lawful basis, allowed fields, systems, tenant boundaries, retention, deletion, recipients, owners, incident path and decommission plan before provisioning infrastructure.حدد أدوار المتحكم/المعالج والغرض والأساس القانوني والحقول والأنظمة وحدود المستأجر والاحتفاظ والحذف والمستلمين والمسؤولين ومسار الحوادث وخطة الإيقاف قبل تجهيز البنية.

Inventory browser tags by purposeاحصر وسوم المتصفح حسب الغرض

Document every existing tag, field, trigger, recipient and consent condition. Add no destination merely because it appears in this guide; use supported test modes and verify suppression before an approved release.وثّق كل وسم وحقل ومحفز ومستلم وشرط موافقة قائم. لا تضف وجهة لمجرد ظهورها في الدليل؛ استخدم أوضاع الاختبار المدعومة وتحقق من المنع قبل إطلاق معتمد.

Build an authenticated receipt pageابنِ صفحة إيصال مصادقًا عليها

Use a short-lived opaque receipt locator—not a raw order ID or PII in the URL. Fetch only authorized receipt fields. Opening the page may display the receipt or add a consented platform identifier to the existing transaction; it must not create the Purchase event.استخدم مُعرّف إيصال مبهمًا وقصير العمر، وليس رقم طلب خامًا أو بيانات شخصية في الرابط. اجلب حقول الإيصال المصرح بها فقط. فتح الصفحة قد يعرض الإيصال أو يضيف معرّف منصة بموافقة إلى المعاملة القائمة، لكنه لا ينشئ حدث Purchase.

Configure and verify the POS webhookاضبط وتحقق من webhook نقطة البيع

Emit once when the transaction reaches the defined completed state. Sign and verify the webhook, reject replays, and send the minimal canonical event. Phone, name, line items or other personal data are optional only when approved and destination-required.أرسل الحدث مرة واحدة عند وصول المعاملة إلى حالة الاكتمال المحددة. وقّع الـ webhook وتحقق منه وارفض إعادة الإرسال وأرسل الحدث المرجعي بالحد الأدنى. الهاتف والاسم والبنود أو أي بيانات شخصية اختيارية فقط عند اعتمادها وطلب الوجهة لها.

Build destination-aware middlewareابنِ سيرفرًا وسيطًا واعيًا بكل وجهة

Validate and persist the canonical transaction first. Map it separately to each approved destination with its own field contract, identifier, idempotency key, consent rule, retry queue, reconciliation log, retention and deletion workflow.تحقق من المعاملة المرجعية واحفظها أولًا. حوّلها بشكل منفصل لكل وجهة معتمدة وفق عقد الحقول والمعرّف ومفتاح منع التكرار وقاعدة الموافقة وطابور المحاولة وسجل التسوية وسياسة الاحتفاظ والحذف الخاصة بها.

Add controlled receipt messaging only if justifiedأضف رسائل إيصال محكومة فقط إذا كان لها مبرر

Use a verified recipient and a documented service-message basis or consent as applicable. Apply approved templates, suppression and opt-out rules, quiet hours, frequency caps, minimal content, delivery-failure handling and retention. Do not message every transaction by default.استخدم مستلمًا متحققًا منه وأساسًا موثقًا لرسالة الخدمة أو موافقة حسب الحالة. طبق القوالب المعتمدة والاستبعاد وإلغاء الاشتراك وساعات الهدوء وحدود التكرار والحد الأدنى من المحتوى ومعالجة فشل التسليم والاحتفاظ. لا ترسل لكل معاملة افتراضيًا.

Configure an approved Meta server mapperاضبط محول Meta معتمدًا من السيرفر

Keep credentials in a managed broker outside page and model contexts. Follow the current official event contract and data terms; send only approved destination-required fields, pseudonymize where required, and persist a Meta-scoped idempotency key and reconciliation record.احتفظ ببيانات الاعتماد في وسيط أسرار مُدار خارج الصفحة وسياق النموذج. اتبع عقد الحدث وشروط البيانات الرسمية الحالية؛ أرسل فقط الحقول المعتمدة المطلوبة للوجهة، واستخدم الإخفاء الجزئي حيث يلزم، واحفظ مفتاح منع تكرار خاصًا بـ Meta وسجل تسوية.

Map TikTok and Google separatelyحوّل TikTok وGoogle بشكل منفصل

Follow each destination's current event contract and data terms. Map the canonical transaction ID to Meta event_id, TikTok event_id, and Google's transactionId independently; do not assume one identifier or deduplication window works everywhere.اتبع عقد الحدث وشروط البيانات الحالية لكل وجهة. اربط معرّف المعاملة المرجعي بشكل مستقل مع event_id في Meta وTikTok ومع transactionId في Google؛ ولا تفترض أن معرّفًا أو نافذة منع تكرار واحدة تصلح للجميع.

Test and reconcile end-to-endاختبر وسوِّ المسار من البداية للنهاية

In each destination's supported test mode, verify the signed POS webhook, canonical uniqueness, optional eligible receipt message, authenticated page, independent destination mapping and delivery record. Confirm retries reuse only that destination's key and reconcile accepted/rejected/refunded states against the ledger without a browser-created duplicate.في وضع الاختبار المدعوم لكل وجهة، تحقق من webhook نقطة البيع الموقّع وتفرد السجل المرجعي ورسالة الإيصال الاختيارية المؤهلة والصفحة المصادق عليها والتحويل المستقل للوجهة وسجل الإرسال. أكد أن المحاولات تعيد استخدام مفتاح الوجهة نفسها فقط وسوِّ حالات القبول/الرفض/الاسترداد مع السجل من دون تكرار ينشئه المتصفح.

Evaluate optional touchpoints separatelyقيّم نقاط الاتصال الاختيارية بشكل مستقل

Assess QR, WhatsApp or tablet flows for purpose, accessibility, consent, security and customer value. They may reference the authenticated receipt or add an approved identifier; none creates a Purchase. Derive and persist a separate opaque delivery key for every destination.قيّم مسارات QR وWhatsApp والتابلت من حيث الغرض وسهولة الوصول والموافقة والأمن وقيمة العميل. قد تشير للإيصال المصادق عليه أو تضيف معرّفًا معتمدًا؛ ولا ينشئ أي منها Purchase. اشتق واحفظ مفتاح إرسال مبهمًا مستقلًا لكل وجهة.

Configure measurement before optimizationاضبط القياس قبل التحسين

Choose eligible events, attribution settings and optimization only after enough test volume and reconciliation. Attribution windows are platform- and objective-specific; document the selected setting rather than imposing a universal seven-day rule.اختر الأحداث المؤهلة وإعدادات الإسناد والتحسين بعد حجم اختبار وتسوية كافيين. نوافذ الإسناد تختلف حسب المنصة والهدف؛ وثّق الإعداد المختار بدل فرض قاعدة سبعة أيام للجميع.

Monitor quality and minimize dataراقب الجودة وقلّل البيانات

Track acceptance, duplicate, retry, match and attribution diagnostics alongside ledger reconciliation. A low match rate is not permission to send more PII: investigate normalization, consent, source quality and destination eligibility, then approve any new field through the data review.راقب قبول الأحداث والتكرار والمحاولات والمطابقة والإسناد مع تسوية سجل المعاملات. انخفاض المطابقة لا يبرر إرسال بيانات شخصية أكثر: افحص التوحيد والموافقة وجودة المصدر وأهلية الوجهة، واعتمد أي حقل جديد عبر مراجعة البيانات.