الأدلة
تضمين تطبيقات Navo في موقع العميل
ضمّن تتبع الحاويات في موقعك، مع أسعار الشحن، جداول الإبحار ووضع AI، بعلامتك التجارية عبر وسم script واحد ومفتاح مقيد بالنطاق.
يمكنك تضمين تتبّع الحاويات على موقع العميل نفسه، إلى جانب أسعار الشحن وجداول الإبحار. هذه هي التطبيقات نفسها التي تراها على موقع وكيل الشحن التجريبي: ويدجت بحث للصفحة الرئيسية، وصفحة كاملة لكل تطبيق. يظهر كل تطبيق باسم العميل وشعاره ولونه. لكل عرض رابط خاص به، بحيث يستطيع الزائر إرسال حاوية واحدة، أو بحث سعر واحد، أو سعر واحد، أو رحلة إبحار واحدة، أو سفينة واحدة، أو ميناء واحد إلى زميل، ويفتح الرابط على موقع العميل.
لا يحتاج جانب العميل إلى API key أو خادم. مفتاح التضمين علني، ولا يعمل إلا على النطاقات التي ندرجها له.
ما يرسله العميل إلينا
| Item | Example | Required |
|---|---|---|
| اسم الشركة كما ينبغي أن يراه الزوار | Acme Logistics | Yes |
| النطاقات التي ستعمل عليها التطبيقات، الإنتاج والاختبار | acme.com, www.acme.com, staging.acme.com | Yes |
| الشعار، SVG أو PNG، علامة مربعة أو أفقية | https://acme.com/logo.svg | Yes |
| لون العلامة التجارية، قيمة hex واحدة | #0e6ba8 | Yes |
| ألوان إضافية، خطوط، تدوير الزوايا | راجع الشكل والإحساس | Optional |
| البريد الإلكتروني الذي يستقبل طلبات الحجز | [email protected] | For freight rates |
| Webhook URL لطلبات الحجز، إلى CRM/TMS لديهم | https://acme.com/hooks/navo | Optional |
| التطبيقات التي يريدونها | أي من التتبّع، الشحن، الجداول، مع تشغيل وضع AI أو إيقافه | Yes |
| حد الاستخدام لكل تطبيق، شهرياً أو سنوياً | التتبّع: 300 شحنة فريدة شهرياً | Yes |
| الصفحات التي سيظهر فيها كل تطبيق | /track, /rates, /schedules | Recommended |
| عرض “مدعوم من Navo” أو إخفاؤه | ظاهر | Default: shown |
ننشيء المفتاح ونرسل المقاطع أدناه بعد تعبئة المفتاح فيها.
ما يمكن أن يحمله مفتاح واحد
يفتح المفتاح تطبيقاً واحداً أو عدة تطبيقات، ووضع AI مفتاح تشغيل منفصل:
| Package | Apps on the key | What the visitor gets |
|---|---|---|
| التتبّع فقط | tracking | صفحة التتبّع، ويعرض ويدجت البحث مربع التتبّع دون تبويبات ودون مفتاح AI |
| التتبّع مع AI | tracking, ai | الشيء نفسه، بالإضافة إلى وضع AI في ويدجت البحث و”اسأل AI” على الشحنات |
| الأسعار والجداول | freight, schedules | تبويبان في ويدجت البحث، وصفحتا الأسعار والجداول |
| كل شيء | tracking, freight, schedules, ai | التبويبات الثلاثة كلها، وضع AI، كل الصفحات |
يتم بناء الويدجت من المفتاح: أي تبويب أو صفحة أو زر AI لا يفتحه المفتاح لا يتم رسمه أصلاً، ويرفض خادمنا بياناته حتى لو حاول شخص فرض الطلب.
حدود الاستخدام
لكل تطبيق على المفتاح حد خاص به، لكل شهر تقويمي أو لكل سنة تقويمية (UTC). ما يُحسب كوحدة واحدة:
| App | One unit | Free repeats |
|---|---|---|
tracking | شحنة فريدة واحدة، رقم حاوية أو حجز أو B/L | الشحنة نفسها لبقية الفترة |
freight | بحث سعر واحد، المسار والمعدة | البحث نفسه في اليوم نفسه |
schedules | بحث جدول واحد، مسار أو سفينة أو ميناء | البحث نفسه في اليوم نفسه |
ai | سؤال واحد إلى مساعد AI | لا يوجد |
مثال: التتبّع عند 300 شحنة فريدة شهرياً. يستطيع زوار العميل فتح تلك الشحنات الـ 300 وتحديثها كما يشاؤون طوال الشهر، وتُرفض الشحنة 301 حتى اليوم 1 من الشهر التالي. عندما يصل تطبيق إلى حده، يرى الزوار “هذه الخدمة متوقفة مؤقتاً على هذا الموقع حالياً. يرجى التواصل مع <اسم العميل>.” وتستمر التطبيقات الأخرى على المفتاح بالعمل. نرى الاستخدام لكل تطبيق ويمكننا رفع الحد في أي لحظة، من دون أي تغيير على موقع العميل.
التثبيت
ضع المحمّل مرة واحدة على كل صفحة تعرض تطبيقاً:
<script src="https://navo24.com/embed.js" async></script>
ثم ضع حاوية في المكان الذي ينبغي أن يظهر فيه التطبيق.
ويدجت البحث، في واجهة الصفحة الرئيسية أو أي صفحة. مربع واحد مع تبويب لكل تطبيق على المفتاح، التتبّع والأسعار والجداول، ووضع AI إذا كان المفتاح يتضمنه. مع تطبيق واحد لا توجد تبويبات:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
مع data-navo-pages يرسل الويدجت الزوار إلى صفحات العميل نفسها. ومن دونه، تفتح النتيجة داخل إطار الويدجت مباشرة.
صفحة التتبّع (/track):
<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>
صفحة أسعار الشحن (/rates):
<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>
صفحة جداول الإبحار (/schedules)، مع ثلاثة تبويبات: حسب المسار، حسب السفينة، حسب الميناء:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
استخدم قيمة data-navo-pages نفسها على كل تطبيق حتى تصل الروابط المتقاطعة، مثل “عرض الأسعار” على رحلة إبحار، أو “جدول السفينة” على شحنة، إلى الصفحة الصحيحة على موقع العميل.
الخيارات
| Attribute | What it does |
|---|---|
data-navo-app | search, tracking, freight أو schedules. |
data-navo-key | مفتاح التضمين الخاص بالموقع. |
data-navo-pages | خريطة JSON من التطبيق إلى مسار الصفحة على موقع العميل. |
data-navo-height | ارتفاع ثابت بالبكسل. افتراضياً يكبر الإطار مع محتواه، والتتبّع خريطة كاملة، 680 px. |
data-navo-sync | off يبقي URL الصفحة من دون تغيير أثناء تنقّل الزائر. |
data-navo-theme | JSON للألوان والخطوط والزوايا، راجع الشكل والإحساس. |
المواقع التي تستخدم Content Security Policy
إذا كان الموقع يرسل ترويسة Content-Security-Policy، أو ترويسة <meta http-equiv>، مع script-src أو frame-src، أضف navo24.com إلى كليهما، وإلا فسيحظر المتصفح المحمّل أو الإطار وتبقى الحاوية فارغة:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
إذا كان الموقع يستخدم child-src بدلاً من frame-src، فأضفه هناك. لا يلزم أي شيء آخر: تحمّل التطبيقات بياناتها وخطوطها وخرائطها داخل الإطار، وفق سياستنا الخاصة. تعرض وحدة تحكم المتصفح اسم التوجيه المحظور إذا كان أحدها ناقصاً.
أحداث التحليلات و CRM
تطلق الحاوية أحداث DOM عندما يفعل الزائر شيئاً، حتى يتمكن الموقع من إرسالها إلى Google Analytics أو مدير وسوم أو CRM لديه. تتصاعد الأحداث، لذلك يلتقط مستمع واحد على document كل تطبيق على الصفحة.
| Event | When | event.detail |
|---|---|---|
navo:search | أعاد بحث نتائج | app (tracking, freight, schedules) والاستعلام: ref، أو origin, destination, container |
navo:booking | أُرسل طلب حجز | reference, origin, destination, container, quantity, carrier, price, currency |
navo:limit | أوقف حد استخدام بحثاً | app, code، مثلاً site_busy, rate_limited |
<script>
document.addEventListener('navo:search', (e) => gtag('event', 'navo_search', e.detail));
document.addEventListener('navo:booking', (e) => gtag('event', 'generate_lead', { value: e.detail.price, currency: e.detail.currency, transaction_id: e.detail.reference }));
</script>
تفاصيل اتصال الزائر ليست ضمن الأحداث: تذهب فقط إلى بريد الحجز الإلكتروني و webhook.
الشكل والإحساس
افتراضياً تأخذ التطبيقات لون علامة العميل التجارية من المفتاح. لمطابقة الموقع بشكل أدق، أضف data-navo-theme إلى الحاوية: الألوان، الخطوط، تدوير الزوايا، والوضع الداكن.
<div
data-navo-app="freight"
data-navo-key="nve_YOUR_KEY"
data-navo-theme='{"accent":"#e4002b","text":"#1a1a1a","heading":"#002f6c","font":"Inter","radius":6,"buttonRadius":6}'
></div>
كل مفتاح اختياري. إذا كانت قيمة غير صالحة، يتم تجاهلها ويستمر تطبيق الباقي.
| Key | What it changes | Example |
|---|---|---|
accent | الأزرار، الروابط، التبويبات النشطة، المفاتيح، حلقة التركيز. يتم حساب ظلال التحويم والضغط منه | "#e4002b" |
text | النص الرئيسي | "#1a1a1a" |
muted | النص الثانوي: التسميات، التلميحات، التواريخ | "#6b7280" |
heading | العناوين، أسماء الناقلين والسفن، خطوط الخريطة | "#002f6c" |
background | خلفية صفحة التطبيق. "transparent" يسمح بظهور خلفية العميل نفسها | "#ffffff" |
surface | البطاقات، المدخلات، خطوط الجداول المتناوبة | "#f5f7fa" |
border | الحدود والفواصل | "#e5e7eb" |
success | الحالات الإيجابية: تم التسليم، في الموعد، الأرخص | "#15803d" |
radius | تدوير زوايا البطاقات واللوحات، px (0 إلى 40) | 8 |
buttonRadius | تدوير زوايا الأزرار والمدخلات، px. 999 يعطي شكلاً كبسولياً، وهو الافتراضي | 6 |
font | خط النص الأساسي. يتم تحميل أي عائلة من Google Fonts لك، و "system" يستخدم خط نظام الزائر | "Inter" |
headingFont | خط العناوين، بالقواعد نفسها. من دونه تستخدم العناوين font | "Playfair Display" |
fontCss | ملف تنسيق الخط الخاص بك، URL يبدأ بـ https:// ويحتوي قواعد @font-face، للخطوط غير الموجودة على Google Fonts. بعدها تسمي font و headingFont العائلات من ذلك الملف | "https://acme.com/fonts/brand.css" |
mode | "dark" للمواقع ذات التصميم الداكن | "dark" |
الألوان هي hex: #rgb أو #rrggbb أو #rrggbbaa.
نقاط بداية جاهزة:
<!-- Corporate: square corners, navy headings -->
data-navo-theme='{"accent":"#003a70","heading":"#003a70","font":"Source Sans 3","radius":2,"buttonRadius":2}'
<!-- Soft: rounded, light grey cards -->
data-navo-theme='{"accent":"#0f766e","surface":"#f3f4f6","font":"Nunito","radius":16,"buttonRadius":999}'
<!-- Dark site -->
data-navo-theme='{"mode":"dark","accent":"#f59e0b","background":"#0b1220","surface":"#111a2e","border":"#1f2a44","text":"#e5e7eb","muted":"#94a3b8"}'
<!-- Blend into the page: the app draws no background of its own -->
data-navo-theme='{"background":"transparent","font":"system"}'
سمة واحدة لكل الصفحات. يمكننا أيضاً تخزين السمة على المفتاح. عندها تحصل كل حاوية على كل صفحة عليها من دون السمة، ويمكننا تعديلها لاحقاً من دون أي تغيير على موقع العميل. تظل data-navo-theme على الحاوية أعلى أولوية من سمة المفتاح، مفتاحاً بمفتاح.
تصل السمة فقط إلى التطبيق داخل الإطار: لا تغيّر صفحة العميل نفسها أبداً.
React و Next.js، مع فهرسة البحث
استخدم هذا عندما يكون موقع العميل مبنياً باستخدام React أو Next.js وينبغي فهرسة محتوى التطبيق كصفحة للعميل، مثلاً صفحة لكل مسار، “Shanghai to Hamburg sailing schedule”.
يتكوّن من جزأين:
- لقطة. يجلب خادم العميل بيانات المسار منا بصيغة HTML عادية، جدول جداول إبحار أو جدول أسعار، عنوان، ملخص من سطر واحد، وترميز schema.org، ثم يضعها داخل صفحته. تفهرسها محركات البحث كمحتوى للعميل، على URL الخاص بالعميل.
- التطبيق. في المتصفح يتم تركيب التطبيق التفاعلي فوقها، مع البحث والفلاتر والتفاصيل والحجز. تبقى اللقطة على الصفحة كجدول قابل للطي تحت التطبيق، بحيث يرى الزواحف والزوار المحتوى نفسه.
نقطة نهاية اللقطة
GET https://api.navo24.com/v1/demo/embed/snapshot
?key=nve_YOUR_KEY
&app=schedules schedules | freight
&origin=CNSHA UN/LOCODE
&destination=DEHAM UN/LOCODE
&container=40HC freight only: 20GP | 40GP | 40HC
&host=acme.com the client's domain, must be on the key
&format=html optional: the HTML block only
من دون format=html تكون الإجابة JSON:
{
"data": {
"app": "schedules",
"title": "Sailing schedule Shanghai to Hamburg",
"description": "153 sailings from Shanghai (CNSHA) to Hamburg (DEHAM) in the next 6 weeks, 10 carriers, transit from 34 days.",
"items": [{ "carrier": "Yang Ming", "vessel": "MSC OLIVIA", "voyage": "GL642W", "etd": "2026-10-24T00:00:00", "eta": "2026-12-03T00:00:00", "transit_days": 40, "direct": true }],
"html": "<section class=\"navo-snapshot\">…</section>",
"as_of": "2026-10-22T08:52:51Z"
}
}
استخدم title و description من أجل <title> ووصف meta للصفحة، و html للنص. يمكن تخزين الإجابة مؤقتاً لمدة 30 دقيقة (Cache-Control: max-age=1800). تُحسب اللقطة كبحث واحد من حد التطبيق، والمسار نفسه في اليوم نفسه مجاني. لا يملك التتبّع لقطة: الشحنات خاصة بالزائر.
Next.js (App Router)
// app/schedules/[lane]/page.tsx e.g. /schedules/cnsha-deham
import NavoApp from './NavoApp';
const KEY = 'nve_YOUR_KEY';
const API = 'https://api.navo24.com/v1/demo/embed/snapshot';
async function snapshot(lane: string) {
const [origin, destination] = lane.toUpperCase().split('-');
const q = new URLSearchParams({ key: KEY, app: 'schedules', origin, destination, host: 'acme.com' });
const r = await fetch(`${API}?${q}`, { next: { revalidate: 1800 } });
return r.ok ? (await r.json()).data : null;
}
export async function generateMetadata({ params }: { params: { lane: string } }) {
const s = await snapshot(params.lane);
return s ? { title: `${s.title} | Acme Logistics`, description: s.description } : {};
}
export default async function Page({ params }: { params: { lane: string } }) {
const s = await snapshot(params.lane);
const [origin, destination] = params.lane.toUpperCase().split('-');
return (
<main>
<NavoApp
app="schedules"
embedKey={KEY}
view={{ origin, destination }}
snapshotHtml={s?.html}
theme={{ accent: '#e4002b', font: 'Inter' }}
/>
</main>
);
}
// app/schedules/[lane]/NavoApp.tsx
'use client';
import { useEffect, useRef, useState } from 'react';
const SRC = 'https://navo24.com/embed.js';
function loadNavo(): Promise<void> {
const w = window as any;
if (w.NavoEmbed) return Promise.resolve();
return new Promise((ok) => {
let s = document.querySelector<HTMLScriptElement>(`script[src="${SRC}"]`);
if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
s.addEventListener('load', () => ok(), { once: true });
});
}
type Props = {
app: 'search' | 'tracking' | 'freight' | 'schedules';
embedKey: string;
view?: Record<string, string>; // opens this lane right away
pages?: Record<string, string>;
theme?: Record<string, string | number>;
snapshotHtml?: string; // server-rendered data for search engines
};
export default function NavoApp({ app, embedKey, view, pages, theme, snapshotHtml }: Props) {
const box = useRef<HTMLDivElement>(null);
const [live, setLive] = useState(false); // until the app is up, the table is open
useEffect(() => {
if (view && !new URLSearchParams(location.search).get('navo')) {
const u = new URL(location.href);
u.searchParams.set('navo_app', app);
u.searchParams.set('navo', new URLSearchParams(view).toString());
history.replaceState(history.state, '', u);
}
loadNavo().then(() => { (window as any).NavoEmbed.mount(); setLive(true); });
}, [app, embedKey]);
return (
<>
<div
ref={box}
data-navo-app={app}
data-navo-key={embedKey}
data-navo-pages={pages ? JSON.stringify(pages) : undefined}
data-navo-theme={theme ? JSON.stringify(theme) : undefined}
/>
{snapshotHtml && (
<details open={!live}>
<summary>All results as a table</summary>
<div dangerouslySetInnerHTML={{ __html: snapshotHtml }} />
</details>
)}
</>
);
}
كيف يبدو ذلك لمحرك بحث: عنوان الصفحة ووصفها الخاصان، عنوان وجدول كامل لرحلات الإبحار، أو الأسعار، في HTML، مع ترميز Dataset. وكيف يبدو للزائر: التطبيق الحي، مفتوح مسبقاً على ذلك المسار، مع النتائج نفسها كجدول مطوي تحته. يرى الزوار الذين أوقفوا JavaScript الجدول مفتوحاً. الجدول مطوي وليس مخفياً، لذلك لا تعرض الصفحة للزواحف شيئاً لا يستطيع الزائر فتحه.
تأتي HTML اللقطة من خادمنا وكل قيمة فيها escaped، لذلك فهي آمنة للإدراج. نسقها باستخدام الصنفين .navo-snapshot و .navo-snapshot-table إذا ظهرت في أي وقت.
تعمل أطر الخادم الأخرى، مثل Remix و Astro و Nuxt و PHP و WordPress، بالطريقة نفسها: اجلب اللقطة على الخادم، اطبع html داخل الصفحة، وضع الحاوية بجانبها.
React عادي، من دون تصيير خادمي
عندما لا تهم فهرسة البحث، مثل صفحة تتبّع خلف قائمة أو intranet، يكفي المكوّن من دون اللقطة:
يعمل المحمّل بالطريقة نفسها في تطبيق أحادي الصفحة، React أو Vue أو Svelte: اعرض الحاوية، ثم استدع window.NavoEmbed.mount().
import { useEffect } from 'react';
const SRC = 'https://navo24.com/embed.js';
function loadNavo() {
if (window.NavoEmbed) return Promise.resolve();
return new Promise((ok) => {
let s = document.querySelector(`script[src="${SRC}"]`);
if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
s.addEventListener('load', ok, { once: true });
});
}
export function NavoApp({ app, embedKey, pages }) {
useEffect(() => { loadNavo().then(() => window.NavoEmbed.mount()); }, [app, embedKey]);
return (
<div
data-navo-app={app}
data-navo-key={embedKey}
data-navo-pages={pages ? JSON.stringify(pages) : undefined}
/>
);
}
// <NavoApp app="tracking" embedKey="nve_YOUR_KEY" pages={{ tracking: '/track' }} />
في Next.js ضعه في مكوّن عميل ('use client').
لماذا نستخدم إطاراً
يرسم المحمّل كل تطبيق داخل إطار من navo24.com. هذه هي طريقة عمل Stripe Checkout وتضمينات Google Maps ومشغلات YouTube، للأسباب نفسها:
- قفل النطاق. يرفض المتصفح نفسه عرض التطبيق على موقع غير موجود في قائمة المفتاح (
frame-ancestors). لا يمكن قفل مكوّن script محمّل داخل صفحة العميل بهذه الطريقة. - لا تضارب في التنسيقات. لا يمكن لـ CSS الخاص بالعميل أن يكسر التطبيق، ولا يمكن لـ CSS الخاص بنا أن يمس موقعهم.
- تحديثات من دون العميل. تصل الناقلات الجديدة والإصلاحات والميزات إلى كل موقع في اليوم نفسه، ولا يوجد شيء يرقّيه العميل من جهته.
- محركات البحث. لا تتم فهرسة المحتوى داخل إطار كصفحة للعميل، كما هو الحال مع أي تضمين خريطة أو فيديو. عندما يكون ذلك مهماً، أضف اللقطة المصيّرة على الخادم، راجع React و Next.js، مع فهرسة البحث.
لا يسجل الزوار الدخول داخل الإطار، لذلك لا يؤثر حظر المتصفح لملفات تعريف ارتباط الطرف الثالث عليه.
روابط إلى عرض محدد تماماً
بينما يعمل الزائر داخل تطبيق، يتبعه URL الصفحة: ?navo_app=<app>&navo=<view>. تنتج أزرار نسخ الرابط داخل التطبيقات النوع نفسه من الروابط. أمثلة على صفحة عميل /rates:
| View | Link |
|---|---|
| حاوية | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| بحث سعر على مسار | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| سعر واحد | البحث أعلاه مع %26quote%3D<id> |
| بحث إبحار على مسار | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| رحلة إبحار واحدة | البحث أعلاه مع %26sailing%3D<id> |
| سفينة | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| ميناء | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
يستمر فتح سعر أو رحلة إبحار تمت مشاركتها حتى بعد خروجها من النتائج الحية، وتُعرض مع تاريخ أخذ بياناتها.
طلبات الحجز
يفتح احجز على السعر نموذج طلب، بيانات الاتصال، الشركة، البريد الإلكتروني، الهاتف، عدد الحاويات، تاريخ جاهزية البضاعة، البضاعة، الملاحظات. عند الإرسال:
- يذهب بريد إلكتروني إلى عنوان الحجز لدى العميل، مع المسار، والمعدة، والناقل، والسعر الذي رآه الزائر، وتفاصيل اتصال الزائر. Reply-To هو الزائر، لذلك يرد العميل مباشرة من صندوق بريده;
- إذا تم إعداد webhook، يتم إرسال الطلب نفسه إليه عبر POST بصيغة JSON:
{
"type": "booking.requested",
"data": {
"reference": "BR-261020-4F2A1",
"received_at": "2026-10-20T14:05:11Z",
"site": "acme.com",
"contact": { "name": "…", "company": "…", "email": "…", "phone": "…" },
"shipment": { "origin": "Shanghai (CNSHA)", "destination": "Hamburg (DEHAM)", "container": "40ft HC", "quantity": "2", "ready_date": "2026-11-03", "cargo": "…", "notes": "…" },
"rate": { "id": "…", "carrier": "…", "price": 2140, "currency": "USD", "transit_days": 34, "departure": "2026-11-06", "valid_until": "2026-11-15" }
}
}
يرى الزائر تأكيداً مع المرجع. لا يتم تحصيل أي مبلغ ولا يتم إنشاء حجز لدى الناقل: يؤكد العميل المساحة ويرد.
من دون بريد حجز إلكتروني أو webhook يبقى النموذج عرضاً تجريبياً ويقول ذلك.
ما يراه الزوار وما لا يرونه
- أسماء الناقلين وشعاراتهم، الأسعار، أزمنة العبور، الصلاحية وما يشمله السعر.
- الأسعار التي لا يظهر معها اسم ناقل تُعرض باسم “اختيار <اسم العميل>”، مع شعار العميل.
- مصادر الأسعار والمنصات لا تُعرض أبداً. تتم إزالتها على خادمنا قبل أن تصل البيانات إلى المتصفح.
الأمان
قفل النطاق. ترد صفحات التطبيق مع Content-Security-Policy: frame-ancestors التي تدرج نطاقات المفتاح فقط، لذلك يرفض المتصفح عرضها في أي مكان آخر. تحمل طلبات البيانات المفتاح ومضيف الصفحة الأب، ويتم رفضها عندما لا يكون المضيف في القائمة. إذا نُسخ مفتاح إلى موقع آخر فلن يعمل هناك.
الحدود. لكل تطبيق على المفتاح حد شهري أو سنوي خاص به، راجع حدود الاستخدام. بالإضافة إلى ذلك، لكل مفتاح سقف أمان قدره 50,000 طلب شهرياً، وسقف قدره 600 طلب في الدقيقة للموقع كله، حتى لا تؤدي طفرة حركة في موقع واحد إلى إبطاء التطبيقات للآخرين، ويمكن رفعه عند الطلب، وحدود معدل لكل زائر ضد إساءة الاستخدام البرمجية. عند تجاوزها يعرض التطبيق رسالة “حاول مرة أخرى” قصيرة ويطلق navo:limit.
الرسائل. يتواصل الإطار والمحمّل عبر postMessage، ويرسل كل طرف فقط إلى الأصل الدقيق للطرف الآخر: الإطار إلى صفحة العميل، والمحمّل إلى navo24.com. لا تذهب تفاصيل البحث أبداً إلى *.
التدوير. إذا تسرّب مفتاح أو تغيّرت ملكية موقع، نصدر مفتاحاً جديداً ويتوقف القديم فوراً عن العمل.
الاختبار قبل الإطلاق
أرسل إلينا نطاق الاختبار مع نطاق الإنتاج، أو localhost:<port> لجهاز المطوّر. يمكن أن يكون كلاهما على المفتاح نفسه.
قائمة التحقق
- يرسل العميل الاسم، النطاقات، الشعار، اللون، بريد الحجز الإلكتروني، التطبيقات التي اشتراها، مع تشغيل وضع AI أو إيقافه، والحد لكل تطبيق، واختيارياً webhook ومسارات الصفحات.
- ننشيء المفتاح ونرسل المقاطع.
- يضيف العميل
embed.jsوالحاويات، أولاً على بيئة الاختبار. - يتحقق العميل: البحث ← التتبّع، الأسعار ← التفاصيل ← الحجز، يصل بريد اختبار، ويفتح رابط مشترك على موقعه. مع CSP صارمة، تحقق من وحدة تحكم المتصفح بحثاً عن
navo24.comالمحظور. - يضيف العميل نطاق الإنتاج، إذا لم يكن موجوداً في القائمة بعد، وينتقل إلى التشغيل الفعلي.