מדריכים
הטמעת אפליקציות Navo באתר לקוח
הטמיעו מעקב מכולות באתר שלכם, וגם מחירי הובלה, לוחות הפלגה ומצב AI, במותג שלכם עם תגית סקריפט אחת ומפתח נעול לדומיין.
אפשר להטמיע מעקב מכולות באתר של הלקוח עצמו, יחד עם תעריפי שילוח ולוחות הפלגה. אלו אותן אפליקציות שמופיעות באתר המשלח לדוגמה: ווידג’ט חיפוש לעמוד הבית, ועוד עמוד מלא לכל אפליקציה. כל אפליקציה מוצגת בשם הלקוח, עם הלוגו והצבעים שלו. לכל תצוגה יש קישור משלה, כך שמבקר יכול לשלוח לעמית קישור למכולה אחת, לחיפוש תעריף אחד, לתעריף אחד, להפלגה אחת, לאונייה אחת או לנמל אחד, והקישור נפתח באתר של הלקוח.
אין צורך ב-API key או בשרת בצד הלקוח. מפתח ההטמעה ציבורי, והוא עובד רק בדומיינים שאנחנו מגדירים עבורו.
מה הלקוח שולח לנו
| Item | Example | Required |
|---|---|---|
| שם החברה כפי שמבקרים אמורים לראות אותו | Acme Logistics | כן |
| הדומיינים שבהם האפליקציות ירוצו (production, staging) | acme.com, www.acme.com, staging.acme.com | כן |
| לוגו, SVG או PNG, סימן ריבועי או אופקי | https://acme.com/logo.svg | כן |
| צבע מותג, ערך hex אחד | #0e6ba8 | כן |
| צבעים נוספים, פונטים, עיגול פינות | ראו מראה ותחושה | אופציונלי |
| כתובת דואר שמקבלת בקשות הזמנה | [email protected] | עבור תעריפי שילוח |
| Webhook URL לבקשות הזמנה (אל ה-CRM/TMS שלהם) | https://acme.com/hooks/navo | אופציונלי |
| אילו אפליקציות הם רוצים | כל שילוב של tracking, freight, schedules; מצב AI פעיל או כבוי | כן |
| מגבלת שימוש לכל אפליקציה, לחודש או לשנה | tracking: 300 משלוחים ייחודיים בחודש | כן |
| העמודים שבהם כל אפליקציה תופיע | /track, /rates, /schedules | מומלץ |
| “מופעל על ידי Navo” מוצג או מוסתר | מוצג | ברירת מחדל: מוצג |
אנחנו יוצרים את המפתח ושולחים חזרה את הקטעים הבאים, כשהמפתח כבר משובץ בהם.
מה מפתח אחד יכול לכלול
מפתח פותח אפליקציה אחת או כמה אפליקציות, ומצב AI הוא מתג נפרד:
| Package | Apps on the key | What the visitor gets |
|---|---|---|
| Tracking בלבד | tracking | עמוד מעקב; ווידג’ט החיפוש מציג את תיבת המעקב בלי טאבים ובלי מתג AI |
| Tracking עם AI | tracking, ai | אותו הדבר, ובנוסף מצב AI בווידג’ט החיפוש ו-”שאל את ה-AI” במשלוחים |
| Rates and schedules | freight, schedules | שני טאבים בווידג’ט החיפוש, עמודי התעריפים ולוחות ההפלגה |
| Everything | tracking, freight, schedules, ai | כל שלושת הטאבים, מצב AI, כל העמודים |
הווידג’ט נבנה מתוך המפתח: טאב, עמוד או כפתור AI שהמפתח לא פותח לא מוצגים בכלל, והשרת שלנו מסרב לספק להם נתונים גם אם מישהו מאלץ את הבקשה.
מגבלות שימוש
לכל אפליקציה במפתח יש מגבלה משלה, לפי חודש קלנדרי או שנה קלנדרית (UTC). מה נחשב יחידה אחת:
| App | One unit | Free repeats |
|---|---|---|
tracking | משלוח ייחודי אחד (מספר מכולה, הזמנה או B/L) | אותו משלוח עד סוף התקופה |
freight | חיפוש תעריף אחד (lane וציוד) | אותו חיפוש באותו יום |
schedules | חיפוש לוח הפלגה אחד (מסלול, אונייה או נמל) | אותו חיפוש באותו יום |
ai | שאלה אחת לעוזר ה-AI | אין |
דוגמה: tracking עם 300 משלוחים ייחודיים בחודש. המבקרים של הלקוח יכולים לפתוח ולרענן את אותם 300 משלוחים כמה פעמים שירצו לאורך כל החודש; משלוח 301 יידחה עד ה-1 בחודש הבא. כאשר אפליקציה מגיעה למגבלה שלה, המבקרים רואים “השירות הזה מושהה כרגע באתר הזה. אנא צרו קשר עם
התקנה
שימו את ה-loader פעם אחת בכל עמוד שמציג אפליקציה:
<script src="https://navo24.com/embed.js" async></script>
ואז קונטיינר במקום שבו האפליקציה אמורה להופיע.
ווידג’ט חיפוש (hero בעמוד הבית, או כל עמוד אחר). תיבה אחת עם טאב לכל אפליקציה במפתח (tracking, rates, schedules), ומצב 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 הווידג’ט שולח מבקרים לעמודים של הלקוח עצמו. בלעדיו, התוצאה נפתחת ישירות בתוך המסגרת של הווידג’ט.
עמוד Tracking (/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 | גובה קבוע ב-px. כברירת מחדל המסגרת גדלה לפי התוכן שלה; tracking הוא מפה מלאה, 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 לשניהם, אחרת הדפדפן יחסום את ה-loader או את המסגרת והקונטיינר יישאר ריק:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
אם משתמשים ב-child-src במקום frame-src, הוסיפו אותו שם. לא צריך שום דבר נוסף: האפליקציות טוענות את הנתונים, הפונטים והמפות שלהן בתוך המסגרת, תחת המדיניות שלנו. קונסול הדפדפן מציין את הדירקטיבה שנחסמה אם משהו חסר.
אירועים לאנליטיקה ול-CRM
הקונטיינר משגר אירועי DOM כשמבקר עושה פעולה, כך שהאתר יכול לשלוח אותם אל Google Analytics, אל tag manager או אל ה-CRM שלו. הם עושים bubble, לכן listener אחד על 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 | כפתורים, קישורים, טאבים פעילים, מתגים, טבעת focus. גוני hover ולחיצה מחושבים ממנו | "#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 | גיליון סגנונות הפונט שלכם (https:// URL עם כללי @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"}'
ערכת נושא אחת לכל העמודים. אנחנו יכולים לשמור את ערכת הנושא גם על המפתח. כך כל קונטיינר בכל עמוד מקבל אותה בלי ה-attribute, ואנחנו יכולים לעדכן אותה מאוחר יותר בלי שינוי באתר הלקוח. data-navo-theme על קונטיינר עדיין גובר על ערכת הנושא של המפתח, מפתח אחר מפתח.
ערכת הנושא מגיעה רק לאפליקציה בתוך המסגרת: היא לעולם לא משנה את העמוד של הלקוח עצמו.
React ו-Next.js, עם אינדוקס חיפוש
השתמשו בזה כשהאתר של הלקוח בנוי עם React או Next.js, ותוכן האפליקציה צריך להיות מאונדקס כחלק מהעמוד של הלקוח (לדוגמה, עמוד לכל lane, “לוח הפלגות משנחאי להמבורג”).
זה מורכב משני חלקים:
- Snapshot. השרת של הלקוח מושך מאיתנו את נתוני ה-lane כ-HTML פשוט (טבלת לוחות הפלגה או טבלת תעריפים, כותרת, תקציר בשורה אחת וסימון schema.org) ומכניס אותם לעמוד שלו. מנועי חיפוש מאנדקסים את זה כתוכן של הלקוח, ב-URL של הלקוח.
- App. בדפדפן, האפליקציה האינטראקטיבית נטענת מעליו, עם חיפוש, פילטרים, פרטים והזמנה. ה-snapshot נשאר בעמוד כטבלה נפתחת מתחת לאפליקציה, כך ש-crawlers ומבקרים רואים את אותו תוכן.
נקודת קצה של Snapshot
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> ותיאור המטא של העמוד, וב-html עבור הגוף. אפשר לשמור את התשובה ב-cache ל-30 דקות (Cache-Control: max-age=1800). Snapshot נספר כחיפוש אחד מול מגבלת האפליקציה; אותו lane באותו יום הוא בחינם. ל-tracking אין snapshot: משלוחים הם פרטיים למבקר.
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. כך זה נראה למבקר: האפליקציה החיה, כבר פתוחה על אותו lane, עם אותן תוצאות כטבלה מקופלת מתחתיה. מבקרים בלי JavaScript רואים את הטבלה פתוחה. הטבלה מקופלת, לא מוסתרת, כך שהעמוד לא מציג ל-crawlers שום דבר שמבקר לא יכול לפתוח.
ה-HTML של ה-snapshot מגיע מהשרת שלנו כשכל ערך escaped, לכן בטוח להכניס אותו. אם הוא מוצג, עצבו אותו עם המחלקות .navo-snapshot ו-.navo-snapshot-table.
מסגרות שרת אחרות (Remix, Astro, Nuxt, PHP, WordPress) עובדות באותה דרך: מושכים את ה-snapshot בשרת, מדפיסים את html לתוך העמוד, ושמים את הקונטיינר לידו.
React רגיל (ללא server rendering)
כשאינדוקס חיפוש לא חשוב (עמוד tracking מאחורי תפריט, אינטראנט), מספיק הרכיב בלי ה-snapshot:
ה-loader עובד באותה דרך באפליקציית single-page (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 שימו אותו ב-client component ('use client').
למה מסגרת
ה-loader מצייר כל אפליקציה בתוך מסגרת מ-navo24.com. כך עובדים Stripe Checkout, הטמעות Google Maps ונגני YouTube, מאותן סיבות:
- נעילת דומיין. הדפדפן עצמו מסרב להציג את האפליקציה באתר שאינו ברשימת המפתח (
frame-ancestors). אי אפשר לנעול כך רכיב script שנטען לתוך עמוד הלקוח. - בלי התנגשויות סגנון. ה-CSS של הלקוח לא יכול לשבור את האפליקציה, וה-CSS שלנו לא יכול לגעת באתר שלו.
- עדכונים בלי הלקוח. מובילים חדשים, תיקונים ופיצ’רים מגיעים לכל אתר באותו יום; אין מה לשדרג בצד הלקוח.
- מנועי חיפוש. תוכן בתוך מסגרת לא מאונדקס כעמוד של הלקוח, בדיוק כמו בכל הטמעת מפה או וידאו. כשזה חשוב, הוסיפו את ה-snapshot המרונדר בשרת, ראו React ו-Next.js, עם אינדוקס חיפוש.
מבקרים לא מתחברים בתוך המסגרת, לכן חסימה של third-party cookies בדפדפן לא משפיעה עליה.
קישורים לתצוגה מדויקת אחת
בזמן שמבקר עובד באפליקציה, ה-URL של העמוד עוקב אחריו: ?navo_app=<app>&navo=<view>. כפתורי העתקת קישור בתוך האפליקציות מייצרים אותו סוג קישור. דוגמאות בעמוד לקוח /rates:
| View | Link |
|---|---|
| מכולה | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| חיפוש תעריף ב-lane | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| תעריף אחד | החיפוש שלמעלה בתוספת %26quote%3D<id> |
| חיפוש הפלגה ב-lane | /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 הטופס נשאר דמו ומציין זאת.
מה מבקרים רואים, ומה לא
- שמות ולוגואים של מובילים, מחירים, זמני transit, תוקף ומה התעריף כולל.
- תעריפים בלי שם מוביל מוצגים כ-”
Select”, עם הלוגו של הלקוח. - מקורות תעריפים ופלטפורמות לעולם לא מוצגים. הם מוסרים בשרת שלנו לפני שהנתונים מגיעים לדפדפן.
אבטחה
נעילת דומיין. עמודי האפליקציה עונים עם Content-Security-Policy: frame-ancestors שמפרט רק את הדומיינים של המפתח, כך שדפדפן מסרב להציג אותם בכל מקום אחר. בקשות נתונים כוללות את המפתח ואת ה-host של עמוד ההורה, ונדחות כשה-host אינו ברשימה. מפתח שהועתק לאתר אחר לא עובד שם.
מגבלות. לכל אפליקציה במפתח יש מגבלה חודשית או שנתית משלה (ראו מגבלות שימוש). נוסף על כך, לכל מפתח יש תקרת בטיחות של 50,000 בקשות בחודש, תקרה של 600 בקשות בדקה לכל האתר (כך שקפיצת תנועה באתר אחד לא תאט את האפליקציות עבור אחרים; ניתן להעלות לפי בקשה) ומגבלות קצב לכל מבקר נגד שימוש לרעה בסקריפטים; מעבר להן האפליקציה מציגה הודעת “נסה שוב” קצרה ומשגרת navo:limit.
הודעות. המסגרת וה-loader מדברים דרך postMessage, וכל צד שולח רק ל-origin המדויק של הצד השני: המסגרת לעמוד הלקוח, ה-loader אל navo24.com. פרטי חיפוש לעולם לא נשלחים אל *.
רוטציה. אם מפתח דולף או אתר מחליף בעלות, אנחנו מנפיקים מפתח חדש והישן מפסיק לעבוד מיד.
בדיקות לפני עלייה לאוויר
שלחו לנו את דומיין ה-staging יחד עם דומיין ה-production, או localhost:<port> למכונת פיתוח. שניהם יכולים לשבת על אותו מפתח.
Checklist
- הלקוח שולח שם, דומיינים, לוגו, צבע, דואר הזמנות, האפליקציות שרכש (מצב AI פעיל או כבוי) והמגבלה לכל אפליקציה (ואופציונלית webhook ונתיבי עמודים).
- אנחנו יוצרים את המפתח ושולחים את הקטעים.
- הלקוח מוסיף את
embed.jsואת הקונטיינרים, קודם ב-staging. - הלקוח בודק: חיפוש → tracking, תעריפים → פרטים → הזמנה (דואר בדיקה מגיע), קישור משותף נפתח באתר שלו. עם CSP מחמיר, בודקים בקונסול הדפדפן חסימות של
navo24.com. - הלקוח מוסיף את דומיין ה-production (אם עדיין לא ברשימה) ועולה לאוויר.