تتبع التحويلات

تحصل كل نقرة مسجّلة على معرّف نقرة قصير وفريد. مرّره إلى موقعك، وأبلغ عنه عندما يُكمل أحدهم التحويل، وسينسب Letlink العميل المحتمل أو البيع أو التسجيل إلى الرابط والحملة والبلد والجهاز بالضبط.

1. أرسل معرّف النقرة إلى موقعك

فعّل إلحاق معرّف النقرة على الرابط. سيصل الزوار حينها مع ?lk_click=… على الوجهة. يمكنك إعادة تسمية المعامل في إعدادات التحويل — تتوقع كثير من شبكات التسويق بالعمولة subid أو clickid.

أو ضع الرموز في رابط الوجهة بنفسك. يُستبدل {click_id} بمعرّف النقرة (ولا يُلحق شيء)، وتعمل هذه أيضًا: {slug}، {country}، {device}، {utm_source}، {utm_medium}، {utm_campaign}، {utm_term}، {utm_content}.

https://shop.example.com/offer?subid={click_id}&src={utm_source}&geo={country}

2أ. أبلغ عن التحويلات من المتصفح

أضف المقتطف البرمجي إلى كل صفحة من موقعك. يحفظ معرّف النقرة في ملف تعريف ارتباط من الطرف الأول وفي التخزين المحلي، ثم يبلغ عن التحويلات عند استدعائك letlink().

<script>window.letlink=window.letlink||function(){(letlink.q=letlink.q||[]).push(arguments)};</script>
<script async src="https://letl.ink/t.js" data-param="lk_click"></script>

<!-- on the thank-you page -->
<script>
  letlink('sale', { value: 49.90, currency: 'USD', order_id: 'ORDER-123' });
</script>

الأحداث هي lead وsale وsignup وcustom (مع event_name). الحقول الاختيارية: value وcurrency (رمز ISO) وorder_id وemail (يستخدمه تكاملا SendGrid وMailchimp) وmetadata (كائن صغير من الحقول الإضافية).

2ب. أبلغ عن التحويلات من خادم إلى خادم

يمكن للمتاجر وأنظمة CRM وشبكات التسويق بالعمولة استدعاء رابط Postback بطريقة GET أو POST:

https://letl.ink/postback?click_id={click_id}&event=sale&amount=49.90&currency=USD&txid=ORDER-123

• معرّف النقرة: click_id، clickid، cid، subid، sub_id، aff_sub.
• المبلغ: amount، payout، value، revenue. المبلغ السالب يعني استردادًا.
• المعاملة: txid، transaction_id، order_id.
• الحالة: approved (الافتراضي)، pending، declined أو refunded. أبلغ عن عملية البيع المعلّقة أولًا ثم اعتمدها لاحقًا بمعرّف المعاملة نفسه.
• مفتاح Postback: عيّن مفتاحًا في إعدادات التحويل وأضف key=… إلى كل Postback؛ تُرفض طلبات Postback التي لا تتضمنه.

أو استدعِ POST /api/v1/conversions برمز API الخاص بك (Growth وUltimate).

الردود

يرد Postback وAPI دائمًا بـ 200 مع ترويسة X-Letlink-Result: created، updated (حالة جديدة لمعاملة معروفة)، duplicate، unknown_click، bad_key، outside_window، not_allowed (الخطة) أو invalid. إعادة المحاولة لا تفيد أبدًا، لذا ينبغي ألا تعيدها الشبكات.

إزالة التكرار والإسناد

• يُحتسب التحويل مرة واحدة لكل معرّف نقرة وحدث ومعرّف معاملة، أيًا كانت القناة التي تبلغ عنه أولًا.
• الإسناد للنقرة الأخيرة: يحتفظ المقتطف دائمًا بأحدث معرّف نقرة.
• لا يُحتسب التحويل إلا ضمن نافذة الإسناد بعد نقرته — 30 يومًا افتراضيًا، قابلة للتعديل من 1 إلى 365 يومًا.

أرسل التحويلات إلى منصاتك الإعلانية

في Growth وUltimate، فعّل تمرير التحويلات المعتمدة لإرسالها كأحداث شراء وعميل محتمل وتسجيل إلى واجهات Conversions API لدى Meta وTikTok وLinkedIn وPinterest وSnapchat وReddit وإلى تكاملات التحليلات لديك، مطابَقةً مع النقرة الإعلانية الأصلية. يتلقاها Google Tag Manager وAdobe Analytics وSendGrid وMailchimp دائمًا.