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.دليل تقني واستراتيجي لتحويل سجلات مشتريات المتجر المؤهلة إلى إشارات إعلانية خاصة بكل وجهة، مع إظهار حدود الموافقة والتسوية والسببية بوضوح.
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.يصف هذا الدليل جسرًا قائمًا على الموافقة بين سجل معاملات نقطة البيع المكتملة وواجهات أحداث المنصات. قد تتم مطابقة وإسناد بعض المعاملات المؤهلة وفق قواعد كل منصة؛ وتظل التغطية ناقصة ولا يساوي إسناد المنصة قياس الأثر السببي.
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 سببي.
The complete system has four layers. Data moves left to right — from the physical store to the ad platform.النظام الكامل يتكون من أربع طبقات. تتحرك البيانات من المتجر الفعلي إلى منصة الإعلانات.
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 المكتمل هو مصدر حقيقة المعاملة. عرّف حدثًا مرجعيًا بالحد الأدنى—معرّف المعاملة والوقت والعملة والقيمة والفرع وحالة الاكتمال أو الاسترداد—ولا تضف معرّفًا شخصيًا مطلوبًا للمنصة إلا بعد اعتماد الغرض والصلاحية والإشعار والاحتفاظ والحذف.
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.الهدف هو حدث مرجعي واحد لمعاملة مكتملة، يُحوّل بشكل منفصل وبالحد الأدنى لكل وجهة معتمدة مع إعادة المحاولة والتسوية والحذف ومنع التكرار الخاص بكل منصة.
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. المتصفح والسيرفر قناتا نقل تُختاران وفق المنصة وتصميم الموافقة، وليستا محفزًا ينشأ عند فتح الإيصال:
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.تعالج كل وجهة الأحداث المؤهلة وفق قواعدها للمطابقة والموافقة ونافذة الإسناد والتقارير. الحدث غير المطابق أو غير المُسند لا يصبح تلقائيًا بيعًا عضويًا، والحدث المطابق لا يثبت السببية. طابق تقارير المنصات مع سجل نقاط البيع واستخدم التجارب لقياس الأثر الإضافي.
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.
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.
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 قبل النقل. قد تطابقها المنصة وفق قواعدها. الهاش إخفاء جزئي للهوية والمطابقة تظل ناقصة؛ وقد تؤثر ملفات الارتباط وإشارات أخرى على التقارير.
| 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المعاملات المؤهلة والمعتمدة لتلك الوجهة |
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.
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 كمثال فقط. الوجهات الأخرى تستخدم موارد وحقولًا ومسارات رفع مختلفة، وقد تختلف الإتاحة حسب الحساب والهدف.
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.متى تستخدمه: لمعاملة موقع حقيقية جُمعت وفق موافقة الموقع وعقد الحدث، وليس لشراء من متجر فعلي.
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.
| 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مثال Meta | action_source: "website" | action_source: "physical_store" |
| Authoritative sourceالمصدر المرجعي | Completed website transactionمعاملة موقع مكتملة | Completed POS ledger transactionمعاملة مكتملة في سجل نقطة البيع |
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.استخدم مصدر الحدث الحقيقي. لا تكرر شراء المتجر كشراء موقع. إذا استقبلت وجهة واحدة تمثيلين مشروعين من المتصفح والسيرفر للحدث نفسه، فاستخدم مفاتيح منع التكرار الموثقة واختبر النتيجة؛ ولا تفترض أن المنصة ستحتفظ بالحدث "الأفضل".
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.وسيلة النقل لا تعيد كتابة الواقع. فتح الإيصال في المتصفح لا يحول بيع المتجر إلى شراء موقع، واسم الحقل وحده لا يجعل الحدث مؤهلًا. احتفظ بمصدر نقطة البيع المكتمل واستخدم مسار الأوفلاين الحالي للوجهة وافصل تقارير الوجهة عن القياس السببي.
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 أو منفعة خدمة بإجبار موافقة التتبع.
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.أرسل رابط إيصال مبهمًا وقصير العمر، وليس رقم طلب خامًا. تعرض الصفحة حقول الإيصال المصرح بها فقط. لا يُضاف أي معرّف منصة إلى المعاملة القائمة إلا ضمن موافقة مستقلة ومعتمدة؛ ورقم الهاتف ليس تصريحًا احتياطيًا لنقل البيانات الشخصية.
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 عند المسح ولا تربط المنفعة بموافقة إعلانية غير مرتبطة.
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 لاستنتاج شراء أو ربط رقم هاتف بآخر معاملة. وفّر الوصول للشبكة بشروط واضحة؛ وأي معرّف تسويقي أو ربط بمعاملة يحتاج أساسًا منفصلًا ومحددًا وصالحًا.
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 ثانيًا.
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.استخدم قالب خدمة معتمدًا وأهلية مستلم وقوائم منع ورابطًا مبهمًا قصير العمر. قِس التسليم والفتح في برنامجك؛ ولا تنشر نسبًا إقليمية عامة أو تحول فتح الإيصال إلى حدث إعلاني.
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.
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 من دون أساس منفصل وصالح ومراجعة صريحة لتدفق البيانات.
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.قد يوفر التابلت المشترك اختيار الإيصال أو الولاء، لكنه يخلق مخاطر مشاهدة الشاشة وعزل الجلسات وأمن الجهاز. لا تطلق بيكسلًا إعلانيًا من جهاز متجر مشترك ثم تنسب هوية متصفحه للعميل.
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.ابدأ بسجل نقطة البيع المكتمل ووجهة واحدة. أضف نقطة اتصال بالعميل فقط عندما تقدم قيمة مستقلة وتجتاز مراجعة الموافقة وإمكانية الوصول والأمن وتقليل البيانات. قِس الاشتراك والفشل لديك ولا تعتمد على نسب توضيحية حُذفت من هذا الدليل.
How a completed transaction becomes separate, auditable destination events without exposing receipt data or inventing browser purchases.كيف تتحول المعاملة المكتملة إلى أحداث مستقلة وقابلة للتدقيق لكل وجهة من دون كشف بيانات الإيصال أو اختراع مشتريات من المتصفح.
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: تخصيص نطاق كل معرّف خارجي حسب الوجهة. احتفظ بمرجع نقطة البيع الخام داخليًا. أنشئ مفاتيح مبهمة وثابتة للمحاولات داخل وجهة واحدة، ولا تعِد استخدام معرّف عميل أو معاملة عبر المنصات لمجرد السهولة.
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.سجّل وقت اكتمال الشراء الفعلي من نقطة البيع وأرسل أو أعد المحاولة ضمن حدود القبول الحالية لكل وجهة. يجب أن يحافظ الطابور المتأخر على وقت الحدث. لا تستخدم وقت فتح الإيصال أو نافذة سبعة أيام عامة أو لحظة إعادة المحاولة كوقت للشراء.
A receipt page displays authorized receipt data. It does not create, replay or reclassify the completed in-store Purchase event.صفحة الإيصال تعرض بيانات إيصال مصرحًا بها. ولا تنشئ أو تعيد أو تعيد تصنيف حدث Purchase المكتمل في المتجر.
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.ضع في الرابط رمز إيصال عشوائيًا ومحدود النطاق فقط. لا تضع رقم طلب نقطة البيع أو الهاتف أو البريد أو الاسم أو أي بيانات شخصية. استخرج الرمز في السيرفر المصادق عليه وحدد صلاحيته وطلبات استخدامه وأعد الحد الأدنى من عرض الإيصال.
https://receipts.yourbrand.example/r?token=rt_7Kp9mQ2x...
// 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').
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.إذا سمح التصميم المُراجع لمعرّف متصفح بإثراء المعاملة المرجعية، فاحصل على الموافقة المطلوبة أولًا وأرسل إلى نقطة سيرفر باسم الوجهة. لا ترسل قيمة الطلب أو بيانات شخصية من الصفحة ولا تحمّل وسوم وجهات غير مرتبطة ولا تجعل الوصول للإيصال معتمدًا على الموافقة الإعلانية.
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.حوّل المعاملات المكتملة والمؤهلة من السيرفر إلى عقود وجهات تمت مراجعتها بشكل مستقل. قد يكون التسليم موثوقًا من دون وعد بالقبول أو مطابقة الهوية أو الإسناد أو تغطية كل العملاء.
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.عندما تدعم وجهة معتمدة معرّفات موحّدة ومُهشّمة، قد تستخدمها كإشارات للمطابقة. هي بيانات مستعارة وليست إثباتًا حتميًا للهوية؛ وتظل ضوابط الخصوصية وأهلية الحساب وجودة البيانات ونماذج الوجهة عوامل تحد النتائج.
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.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.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.{
"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..."
}
}]
}
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؛ طبّق واختبر عقد كل وجهة الحالي بشكل مستقل.
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 ثانيًا.
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.| Scenarioالسيناريو | What Happensماذا يحدث | Resultالنتيجة |
|---|---|---|
| POS webhook replayإعادة webhook نقطة البيع | Signature, replay window, and canonical uniqueness are checked before enqueueingيتم فحص التوقيع ونافذة الإعادة وتفرد السجل المرجعي قبل الإدراج | Duplicate rejectedرفض التكرار |
| Meta delivery times outانتهاء مهلة إرسال Meta | Retry only after inspecting the response state, using the persisted Meta-scoped keyأعد المحاولة بعد فحص حالة الاستجابة وبمفتاح Meta المحفوظ فقط | Reconcile statusسوِّ الحالة |
| TikTok or Google deliveryإرسال TikTok أو Google | Use that destination's current schema, eligibility rules, and independent keyاستخدم مخطط الوجهة وقواعد أهليتها الحالية ومفتاحها المستقل | No cross-platform reuseلا إعادة استخدام بين المنصات |
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 فقط. تصميم المتجر الفعلي هذا يستخدم حدث السجل من السيرفر؛ عرض الإيصال ليس نسخة متصفح منه.
The exact fields sent in every Purchase event — across all platforms and both channels.الحقول المحددة المرسلة في كل حدث شراء — عبر جميع المنصات وكلتا القناتين.
| Fieldالحقل | Typeالنوع | Descriptionالوصف | Exampleمثال |
|---|---|---|---|
| event_name | string | Always "Purchase"دائمًا "Purchase" | Purchase |
| event_id | string | Unique ID for deduplicationمعرّف فريد لمنع التكرار | evt_28401_1711640520 |
| event_time | integer | Unix timestamp of purchaseالطابع الزمني Unix للشراء | 1711640520 |
| action_source | string | "physical_store" for offline"physical_store" للأوفلاين | physical_store |
| value | float | Total order valueإجمالي قيمة الطلب | 1240.00 |
| currency | string | ISO 4217 currency codeكود العملة ISO 4217 | EGP |
| order_id | string | Your POS order referenceمرجع طلب نظام نقاط البيع | ORD-28401 |
| content_ids | array | Product SKUs in the orderأكواد المنتجات في الطلب | ["SKU-POLO-001"] |
| content_type | string | Type of contentنوع المحتوى | product |
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قاعدة الهاش الخاصة بالوجهة |
|---|---|---|---|
| ph | string | Phone number (E.164 format)رقم الهاتف (صيغة E.164) | SHA-256 |
| em | string | Email address (lowercase)البريد الإلكتروني (أحرف صغيرة) | SHA-256 |
| fn | string | First name (lowercase)الاسم الأول (أحرف صغيرة) | SHA-256 |
| ln | string | Last name (lowercase)اسم العائلة (أحرف صغيرة) | SHA-256 |
| country | string | ISO country codeكود الدولة ISO | SHA-256 |
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.لا تزد عدد المعرّفات لملاحقة معيار غير موثّق. ابدأ بالغرض وتقليل البيانات، وأرسل الحقول المعتمدة فقط، وقِس تشخيصات الوجهة، ووثّق المفاضلة قبل طلب أي معرّف إضافي.
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.إذا كنت تدير أكثر من موقع متجر، النظام يحتاج لتتبع من أي فرع جاء كل شراء — حتى تتمكن من قياس الأداء لكل موقع.
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.يمكن لمعرّف فرع محكوم دعم التسوية والتقارير حسب الموقع. إسناد المنصة لا يثبت أي حملة سببت إيراد المتجر، وقد تتأثر مقارنة الفروع بالمخزون والساعات والنطاق الجغرافي والفريق والعروض وتغطية القياس. القيم أدناه أمثلة تعليمية افتراضية.
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 في كل سجل معاملة. معظم أنظمة نقاط البيع متعددة المواقع تفعل ذلك أساسًا. إذا لم يكن كذلك، اضبطه — هذا هو الأساس الذي يُبنى عليه كل شيء.
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 من المتصفح ولا تستخدم حقلًا غير متعلق مثل فئة المنتج.
// 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
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]With branch tagging in place, you can build reporting that shows per-branch metrics:مع وسم الفروع في مكانه، يمكنك بناء تقارير تعرض مؤشرات كل فرع:
| Branchالفرع | Ad Spendالإنفاق الإعلاني | Attributed Revenueالإيرادات المُسندة | ROAS | Actionالإجراء |
|---|---|---|---|---|
| Branch Aالفرع أ | Verified ledger inputمدخل متحقق من السجل | Platform-attributed fieldحقل إسناد المنصة | Descriptive only | Investigate incrementality, margin and capacity; draft a bounded proposalافحص الأثر الإضافي والهامش والقدرة؛ واكتب اقتراحًا محدودًا |
| Branch Bالفرع ب | Verified ledger inputمدخل متحقق من السجل | Platform-attributed fieldحقل إسناد المنصة | Descriptive only | Document hypotheses and propose a controlled testوثّق الفرضيات واقترح اختبارًا محكومًا |
| Branch Cالفرع ج | Verified ledger inputمدخل متحقق من السجل | Platform-attributed fieldحقل إسناد المنصة | Investigate | Check measurement and operational confounders; no automatic reductionافحص القياس والعوامل التشغيلية؛ لا خفض تلقائيًا |
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.اختر حدود الحساب والسيرفر والوسم والتقارير حسب بنية نقطة البيع والكيانات القانونية ونموذج الوصول والحمل والتعافي. قلة عدد الفروع لا تثبت أن حسابًا أو سيرفرًا مشتركًا آمن.
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.تحقق من وسم الفروع وافصل الوصول ووحّد التقارير. قد يقترح النموذج تغيير الميزانية، لكن يجب أن يراجع مالك مخول الفرق الكامل الثابت والأثر الإضافي واقتصاديات الوحدة وربط الحساب والحدود والإيقاف والرجوع قبل تنفيذ خدمة حتمية.
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.قيّم سيرفرًا وسيطًا قابلًا للصيانة، وفصل المستأجر والمنطقة، وتسوية الوجهات، وتنبيهات معايرة للحساب. اجعل تغييرات الميزانية اقتراحات فقط حتى الموافقة الدقيقة؛ واستخدم منع التكرار والحدود والتدقيق والإيقاف والرجوع في المنفذ.
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.تحتاج الشبكات الأكبر بنية مبنية على الحمل والمخاطر المقاسة لا شعار عدد الفروع. افصل الوصول حسب المستأجر والمنطقة، وقلل بيانات نقاط البيع المحتفظ بها، واختبر العزل والتعافي، واطلب موافقة دقيقة قبل إنشاء أي حملة.
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.لا تحتاج لكتابة كود. لكنك تحتاج لاتخاذ قرارات، وتوفير الصلاحيات، وإدارة الجانب التشغيلي. إليك التقسيم.
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.ابدأ من السجل المكتمل. أضف نقطة اتصال واحدة مبررة في كل مرة بعد مراجعة الغرض والأهلية وسهولة الوصول والأمن والموافقة والدعم؛ ووسّع فقط بناءً على قيمة عميل مقاسة وضرر مقبول.
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.درّب الموظفين على فصل اختيارات تسليم الإيصال والولاء والبحث والتسويق؛ وشرح البدائل وعدم ارتجال الموافقة أو شروط العرض. اختبر الفهم ووفر مسار تصعيد.
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.اعتمد هويات خدمة مسماة بأقل صلاحيات خاصة بالمستأجر والحساب والعملية. افصل صلاحيات الإعداد والقراءة والكتابة؛ وحدد مراجعة وسجل الاستخدام واسحب الوصول بعد العمل.
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 والمصادقة والسجلات والاستجابة للحوادث والإيقاف. الجهد يعتمد على البيئة القائمة.
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 فوق المستهدف؟ أين يجب أن ننفق أكثر؟
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.راجع الإسناد مع الأثر الإضافي والهامش والمخزون وقدرة الخدمة. وافق فقط على اقتراح كامل مربوط بالحساب مع حدود وفحص حداثة وشرط إيقاف ورجوع؛ أرقام الإسناد وحدها لا تبرر إعادة التوزيع.
Configure the POS to send transaction data to the middleware server via webhooks. This is platform-specific and requires API access.ضبط نظام نقاط البيع لإرسال بيانات المعاملات إلى السيرفر الوسيط عبر webhooks. هذا خاص بكل منصة ويتطلب صلاحية API.
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.ابنِ فقط نقاط الاتصال المعتمدة. تحصل كل صفحة على أقل حقول مصرح بها ومصادقة قوية عند الحاجة وسهولة وصول ووسوم تراعي الموافقة ورؤوس أمان وانتهاء وحذف؛ ولا يُثبت بيكسل إعلاني افتراضيًا.
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 من جانب السيرفر لمنصات الإعلانات.
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 للإخفاء الجزئي فقط حيث يتطلبه العقد، ونفّذ منع التكرار والتسوية بشكل مستقل لكل وجهة. تظل البيانات الشخصية بعد الهاش بيانات محمية.
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.قيّم المزودين المؤهلين وفق قواعد القناة الرسمية الحالية والأمن والدعم الإقليمي والموافقة والتحقق من المستلم والاستبعاد وإلغاء الاشتراك وساعات الهدوء والاحتفاظ وفشل التسليم والحذف. افصل غرض الخدمة عن التسويق.
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.”راقب تسوية السجل والقبول والتكرار والمحاولات وتشخيصات المطابقة والموافقة والحذف. التنبيهات تبدأ التحقيق ومسار حادث بمسؤول؛ ويظل إسناد المنصة تقديرًا لا «دقة» مؤكدة.
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 وإخفاءً جزئيًا للهوية وضوابط الموافقة أو الأساس القانوني وتسوية خاصة بكل وجهة واستجابة للحوادث. عيّن مسؤولين مؤهلين للتقنية والخصوصية والأمن والعمل؛ واختيار مزود لا يلغي مسؤولية المؤسسة.
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.
Follow these steps in order. Each step depends on the previous one being complete.اتبع هذه الخطوات بالترتيب. كل خطوة تعتمد على اكتمال الخطوة السابقة.
Name controller/processor roles, purpose, lawful basis, allowed fields, systems, tenant boundaries, retention, deletion, recipients, owners, incident path and decommission plan before provisioning infrastructure.حدد أدوار المتحكم/المعالج والغرض والأساس القانوني والحقول والأنظمة وحدود المستأجر والاحتفاظ والحذف والمستلمين والمسؤولين ومسار الحوادث وخطة الإيقاف قبل تجهيز البنية.
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.وثّق كل وسم وحقل ومحفز ومستلم وشرط موافقة قائم. لا تضف وجهة لمجرد ظهورها في الدليل؛ استخدم أوضاع الاختبار المدعومة وتحقق من المنع قبل إطلاق معتمد.
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.
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 وتحقق منه وارفض إعادة الإرسال وأرسل الحدث المرجعي بالحد الأدنى. الهاتف والاسم والبنود أو أي بيانات شخصية اختيارية فقط عند اعتمادها وطلب الوجهة لها.
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.تحقق من المعاملة المرجعية واحفظها أولًا. حوّلها بشكل منفصل لكل وجهة معتمدة وفق عقد الحقول والمعرّف ومفتاح منع التكرار وقاعدة الموافقة وطابور المحاولة وسجل التسوية وسياسة الاحتفاظ والحذف الخاصة بها.
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.استخدم مستلمًا متحققًا منه وأساسًا موثقًا لرسالة الخدمة أو موافقة حسب الحالة. طبق القوالب المعتمدة والاستبعاد وإلغاء الاشتراك وساعات الهدوء وحدود التكرار والحد الأدنى من المحتوى ومعالجة فشل التسليم والاحتفاظ. لا ترسل لكل معاملة افتراضيًا.
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 وسجل تسوية.
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؛ ولا تفترض أن معرّفًا أو نافذة منع تكرار واحدة تصلح للجميع.
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 نقطة البيع الموقّع وتفرد السجل المرجعي ورسالة الإيصال الاختيارية المؤهلة والصفحة المصادق عليها والتحويل المستقل للوجهة وسجل الإرسال. أكد أن المحاولات تعيد استخدام مفتاح الوجهة نفسها فقط وسوِّ حالات القبول/الرفض/الاسترداد مع السجل من دون تكرار ينشئه المتصفح.
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. اشتق واحفظ مفتاح إرسال مبهمًا مستقلًا لكل وجهة.
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.اختر الأحداث المؤهلة وإعدادات الإسناد والتحسين بعد حجم اختبار وتسوية كافيين. نوافذ الإسناد تختلف حسب المنصة والهدف؛ وثّق الإعداد المختار بدل فرض قاعدة سبعة أيام للجميع.
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.راقب قبول الأحداث والتكرار والمحاولات والمطابقة والإسناد مع تسوية سجل المعاملات. انخفاض المطابقة لا يبرر إرسال بيانات شخصية أكثر: افحص التوحيد والموافقة وجودة المصدر وأهلية الوجهة، واعتمد أي حقل جديد عبر مراجعة البيانات.