{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
استخدم نقطة الوصول هذه للإبلاغ عن تحويل واحد يقع في الخادم. ولإرسال عدة أحداث في طلب واحد، استخدم POST /server-events/batch.أنشئ قيمة X-API-Key المطلوبة من موقع التتبع لديك: التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات، ثم إعداد التتبع ← تتبع عبر API في موقعك.راجع إرسال أحداث الخادم للاطلاع على أمثلة برمجية بلغات Node.js وPython وPHP وcURL.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scanova API Documentation","colors":{"primary":"#6938ef","light":"#6938ef","dark":"#6938ef"},"logo":{"light":"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/PrimaryColor-Full.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=edc08604efcf06d6dd5d00e9e2c50f20","dark":"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/WhiteColor-Full2.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=84e81cd9168db3d3ca3949b427e2d6c6"},"favicon":{"light":"https://mintcdn.com/scanova-api/aXUnnYg-8s3nt2o_/images/favicon-64x64.png?fit=max\u0026auto=format\u0026n=aXUnnYg-8s3nt2o_\u0026q=85\u0026s=b59720ad14aa6f2f474ea4380bf15d23","dark":"https://mintcdn.com/scanova-api/aXUnnYg-8s3nt2o_/images/favicon-64x64.png?fit=max\u0026auto=format\u0026n=aXUnnYg-8s3nt2o_\u0026q=85\u0026s=b59720ad14aa6f2f474ea4380bf15d23"},"background":{"color":{"dark":"#05060f"}},"navbar":{"links":[{"href":"https://scanova.io/contact-support/","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.scanova.io"}},"footer":{"socials":{"website":"https://scanova.io","youtube":"https://www.youtube.com/channel/UCHSrteaenPuxL0WjLFmhaEA/featured","x":"https://twitter.com/scanovatech","linkedin":"https://www.linkedin.com/products/scanova-qr-code-generator"}},"integrations":{"ga4":{"measurementId":"G-GWMY0DDJWB"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"languages":[{"language":"en","default":true,"href":"getting-started/what-is-scanova"},{"language":"de","href":"de/getting-started/what-is-scanova"},{"language":"es","href":"es/getting-started/what-is-scanova"},{"language":"fr","href":"fr/getting-started/what-is-scanova"},{"language":"zh","href":"zh/getting-started/what-is-scanova"},{"language":"ar","href":"ar/getting-started/what-is-scanova"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scanova-api","hasAudioNarration":false,"actualSubdomain":"scanova-api","customDomains":["docs.scanova.io"],"gitSource":{"type":"github","owner":"trycon","repo":"qcg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeae5422d1fe1dfc0da7326","collectionId":"be1f7f57-9002-4484-8744-623fd9e88bd2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeae5422d1fe1dfc0da7326"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6aeae5422d1fe1dfc0da7326","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"en","tag":"API Reference","count":271},{"language":"de","tag":"API-Referenz","count":197},{"language":"es","tag":"Referencia de API","count":197},{"language":"fr","tag":"Référence API","count":197},{"language":"ar","tag":"مرجع واجهة البرمجة","count":189},{"language":"zh","tag":"API 参考","count":189},{"language":"en","tag":"Guides","count":115},{"language":"ar","tag":"الأدلة","count":96},{"language":"de","tag":"Anleitungen","count":96},{"language":"es","tag":"Guías","count":96},{"language":"fr","tag":"Guides","count":96},{"language":"zh","tag":"指南","count":93},{"language":"default","tag":"Guides (Legacy)","count":61},{"language":"en","tag":"QR Codes","count":49},{"language":"default","tag":"API reference (Legacy)","count":46},{"language":"en","tag":"Integrations","count":30},{"language":"default","tag":"Category Components","count":30},{"language":"en","tag":"Leads \u0026 Forms","count":28},{"language":"ar","tag":"العملاء المحتملون والنماذج","count":28},{"language":"default","tag":"Categories","count":28},{"language":"de","tag":"Leads \u0026 Formulare","count":28},{"language":"es","tag":"Clientes potenciales y formularios","count":28},{"language":"fr","tag":"Prospects et formulaires","count":28},{"language":"zh","tag":"潜在客户与表单","count":28},{"language":"ar","tag":"Conversion Tracking","count":27},{"language":"default","tag":"Conversion Tracking","count":27},{"language":"de","tag":"Conversion Tracking","count":27},{"language":"es","tag":"Conversion Tracking","count":27},{"language":"fr","tag":"Conversion Tracking","count":27},{"language":"en","tag":"QR Assets","count":26},{"language":"ar","tag":"أصول QR","count":26},{"language":"de","tag":"QR-Assets","count":26},{"language":"es","tag":"Recursos de QR","count":26},{"language":"fr","tag":"Ressources QR","count":26},{"language":"zh","tag":"QR 资源","count":26},{"language":"en","tag":"QR Codes — Create","count":25},{"language":"ar","tag":"رموز QR — إنشاء","count":23},{"language":"de","tag":"QR-Codes — Erstellen","count":23},{"language":"es","tag":"Códigos QR — Crear","count":23},{"language":"fr","tag":"Codes QR — Créer","count":23},{"language":"zh","tag":"二维码 — 创建","count":23},{"language":"en","tag":"QR Codes — Manage","count":18},{"language":"en","tag":"Analytics \u0026 Plans","count":17},{"language":"ar","tag":"التحليلات والخطط","count":17},{"language":"de","tag":"Analysen \u0026 Tarife","count":17},{"language":"es","tag":"Analítica y planes","count":17},{"language":"fr","tag":"Analytique et forfaits","count":17},{"language":"zh","tag":"分析与套餐","count":17},{"language":"en","tag":"Bulk Operations","count":16},{"language":"ar","tag":"العمليات بالجملة","count":16},{"language":"de","tag":"Massenvorgänge","count":16},{"language":"es","tag":"Operaciones en masa","count":16},{"language":"fr","tag":"Opérations en masse","count":16},{"language":"zh","tag":"批量操作","count":16},{"language":"ar","tag":"النطاقات المخصصة","count":14},{"language":"ar","tag":"المستخدمون المشتركون والأدوار","count":14},{"language":"de","tag":"Benutzerdefinierte Domains","count":14},{"language":"de","tag":"Geteilte Nutzer \u0026 Rollen","count":14},{"language":"es","tag":"Dominios personalizados","count":14},{"language":"es","tag":"Usuarios compartidos y roles","count":14},{"language":"fr","tag":"Domaines personnalisés","count":14},{"language":"fr","tag":"Utilisateurs partagés et rôles","count":14},{"language":"zh","tag":"自定义域名","count":14},{"language":"zh","tag":"共享用户与角色","count":14},{"language":"zh","tag":"主题与页面模板","count":14},{"language":"default","tag":"QR Code Management","count":9},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Browser SDK","count":7},{"language":"default","tag":"Folder Management","count":6},{"language":"default","tag":"Form Management","count":6}],"searchSettings":{"maxResults":10,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ar/conversion-tracking/api/events-collect","slug":"/ar/conversion-tracking/api/events-collect","pageMetadata":{"title":"واجهة أحداث الخادم — POST /server-events","openapi":"POST /server-events","description":"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.","href":"/ar/conversion-tracking/api/events-collect"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`استخدم نقطة الوصول هذه للإبلاغ عن تحويل واحد يقع في الخادم. ولإرسال عدة أحداث في طلب واحد، استخدم `,_jsx(_components.a,{href:`/ar/conversion-tracking/api/events-batch`,children:`POST /server-events/batch`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`أنشئ قيمة `,_jsx(_components.code,{children:`X-API-Key`}),` المطلوبة من موقع التتبع لديك: `,_jsx(_components.strong,{children:`التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات`}),`، ثم `,_jsx(_components.strong,{children:`إعداد التتبع ← تتبع عبر API`}),` في موقعك.`]}),`\n`,_jsxs(_components.p,{children:[`راجع `,_jsx(_components.a,{href:`/ar/conversion-tracking/server/send-events`,children:`إرسال أحداث الخادم`}),` للاطلاع على أمثلة برمجية بلغات Node.js وPython وPHP وcURL.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"واجهة أحداث الخادم — POST /server-events","openapi":"POST /server-events","description":"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.","href":"/ar/conversion-tracking/api/events-collect"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Server Events"],"summary":"Send server-side event","description":"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.","operationId":"serverEvent","security":["c71a1371-e068-4c50-8e7c-4f19fe77ef58"],"requestBody":"029c8c63-9a6b-42b4-9e8b-467bfc3c8230","responses":{"200":"62b642a5-33cb-48e6-b8d1-3aff0a973488","400":"e588c2df-240c-4870-a1b5-bccc5f0eaf66","401":"d96a043a-485d-43b0-b6c6-1b28d7e15059","403":"bd5d7919-06c3-4f99-8fd6-fcff59334ae0","422":"4c6a8342-a299-4dc2-b828-5cb682075269","429":"00c7a16f-2b9c-41fe-9c6d-45a6230dfc31"},"method":"post","type":"path","servers":["02a82243-44ee-4c64-8f37-21d34489c5e5"],"path":"/server-events","baseUrlOptions":["https://track.scanova.io"],"title":"Send server-side event","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["site_id","event_name"],"properties":{"site_id":{"type":"string","minLength":1,"maxLength":64,"description":"Tracking site ID","isRequired":true,"uniqueKey":"site_id","typeLabel":"string"},"event_name":{"type":"string","minLength":1,"maxLength":64,"description":"Event name (normalized to lowercase/underscore by API)","isRequired":true,"uniqueKey":"event_name","typeLabel":"string"},"scan_session_id":{"type":"string","format":"uuid","description":"QR scan session id from scnv redirect","uniqueKey":"scan_session_id","typeLabel":"string\u003cuuid>"},"event_id":{"type":"string","format":"uuid","description":"Unique event ID for deduplication","uniqueKey":"event_id","typeLabel":"string\u003cuuid>"},"event_time":{"type":"string","format":"date-time","description":"Event occurrence time","uniqueKey":"event_time","typeLabel":"string\u003cdate-time>"},"user_identifiers":{"type":"object","properties":{"email_hash":{"type":"string","minLength":64,"maxLength":64,"description":"SHA-256 hash of normalized lowercase email","uniqueKey":"user_identifiers.email_hash","typeLabel":"string"},"phone_hash":{"type":"string","minLength":64,"maxLength":64,"description":"SHA-256 hash of normalized E.164 phone number","uniqueKey":"user_identifiers.phone_hash","typeLabel":"string"},"external_id":{"type":"string","maxLength":128,"description":"Your internal user ID","uniqueKey":"user_identifiers.external_id","typeLabel":"string"}},"uniqueKey":"user_identifiers","typeLabel":"object"},"conversion_value":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","minimum":0,"description":"Conversion amount","isRequired":true,"uniqueKey":"conversion_value.amount","typeLabel":"number"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD","description":"ISO 4217 currency code","uniqueKey":"conversion_value.currency","typeLabel":"string"}},"uniqueKey":"conversion_value","typeLabel":"object"},"properties":{"type":"object","additionalProperties":true,"description":"Custom properties. Max serialized size 10KB. Do not include raw email addresses.","uniqueKey":"properties","typeLabel":"object"},"consent":{"oneOf":[{"type":"string","enum":["granted","denied","pending"],"description":"Consent signal propagated from browser-side tracking","uniqueKey":"consent.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["granted","denied","pending"],"description":"Consent signal propagated from browser-side tracking","uniqueKey":"consent.oneOf.1","typeLabel":"null"}],"uniqueKey":"consent","typeLabel":"enum\u003cstring> | null"}},"example":{"site_id":"site_abc123","event_name":"purchase","scan_session_id":"550e8400-e29b-41d4-a716-446655440000","conversion_value":{"amount":99.99,"currency":"USD"},"user_identifiers":{"email_hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","external_id":"user_12345"},"properties":{"order_id":"order_789","product_ids":["prod_1","prod_2"]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"site_id":"site_abc123","event_name":"purchase","scan_session_id":"550e8400-e29b-41d4-a716-446655440000","conversion_value":{"amount":99.99,"currency":"USD"},"user_identifiers":{"email_hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","external_id":"user_12345"},"properties":{"order_id":"order_789","product_ids":["prod_1","prod_2"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"62b642a5-33cb-48e6-b8d1-3aff0a973488":{"description":"Event accepted","content":{"application/json":{"schema":{"type":"object","required":["success","event_id","message"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"event_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"event_id","typeLabel":"string\u003cuuid>"},"message":{"type":"string","example":"Event received","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"event_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","message":"Event received"}}},"exampleType":"generated"}},"exampleType":"generated"},"e588c2df-240c-4870-a1b5-bccc5f0eaf66":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"d96a043a-485d-43b0-b6c6-1b28d7e15059":{"description":"Missing API key","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"bd5d7919-06c3-4f99-8fd6-fcff59334ae0":{"description":"Invalid API key or unauthorized site_id","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"4c6a8342-a299-4dc2-b828-5cb682075269":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"00c7a16f-2b9c-41fe-9c6d-45a6230dfc31":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c71a1371-e068-4c50-8e7c-4f19fe77ef58":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","scopes":[]}}},"servers":{"02a82243-44ee-4c64-8f37-21d34489c5e5":{"url":"https://track.scanova.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"conversion-tracking/openapi/conversion-tracking.json"},"subdomain":"scanova-api","siteName":"Scanova API Documentation","title":"واجهة أحداث الخادم — POST /server-events - Scanova API Documentation","navMaps":{"firstHrefInVersion":{"v2":{"href":"/ar/conversion-tracking/api/events-collect","matchLevel":0},"v1":{"href":"/v1/index","matchLevel":4}},"firstHrefInLanguage":{"en":{"href":"/conversion-tracking/api/events-collect","matchLevel":1},"de":{"href":"/de/conversion-tracking/api/events-collect","matchLevel":1},"es":{"href":"/es/conversion-tracking/api/events-collect","matchLevel":1},"fr":{"href":"/fr/conversion-tracking/api/events-collect","matchLevel":1},"zh":{"href":"/conversion-tracking/api/events-collect","matchLevel":1},"ar":{"href":"/ar/conversion-tracking/api/events-collect","matchLevel":0}}},"lastModified":"2026-09-17T15:36:07.143Z","originalFileLocation":"ar/conversion-tracking/api/events-collect.mdx","locale":"ar"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"واجهة أحداث الخادم — POST /server-events - Scanova API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scanova-api.mintlify.app/_mintlify/api/og/v2?division=%D9%85%D8%B1%D8%AC%D8%B9+%D8%A7%D9%84%D9%88%D8%A7%D8%AC%D9%87%D8%A9\u0026amp;title=%D9%88%D8%A7%D8%AC%D9%87%D8%A9+%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB+%D8%A7%D9%84%D8%AE%D8%A7%D8%AF%D9%85+%E2%80%94+POST+%2Fserver-events\u0026amp;description=%D8%A3%D8%B1%D8%B3%D9%84+%D8%AD%D8%AF%D8%AB+%D8%AA%D8%AD%D9%88%D9%8A%D9%84+%D9%88%D8%A7%D8%AD%D8%AF%D9%8B%D8%A7+%D9%85%D9%88%D8%AB%D9%91%D9%82%D9%8B%D8%A7+%D9%85%D9%86+%D8%A7%D9%84%D8%AE%D8%A7%D8%AF%D9%85+%D9%84%D8%AF%D9%8A%D9%83+%E2%80%94+%D8%B9%D9%85%D9%84%D9%8A%D8%A9+%D8%B4%D8%B1%D8%A7%D8%A1+%D8%A3%D9%88+%D8%AA%D8%B3%D8%AC%D9%8A%D9%84+%D8%A3%D9%88+%D8%B9%D9%85%D9%8A%D9%84%D9%8B%D8%A7+%D9%85%D8%AD%D8%AA%D9%85%D9%84%D9%8B%D8%A7+%D8%A3%D9%88+%D8%A3%D9%8A+%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1+%D8%AE%D9%84%D9%81%D9%8A+%D8%A2%D8%AE%D8%B1+%E2%80%94+%D9%85%D9%86%D8%B3%D9%88%D8%A8%D9%8B%D8%A7+%D8%A5%D9%84%D9%89+%D9%85%D8%B3%D8%AD+%D8%B1%D9%85%D8%B2+QR+%D8%A7%D9%84%D8%B0%D9%8A+%D8%AC%D8%A7%D8%A1+%D8%A8%D8%A7%D9%84%D8%B2%D8%A7%D8%A6%D8%B1.\u0026amp;theme=f9ed38a6e1c8b99666344abf\u0026amp;signature=4e3655304817fcfab0f533931a6941049859bd99f24f26fffb7caaac945fa110\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"واجهة أحداث الخادم — POST /server-events - Scanova API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scanova-api.mintlify.app/_mintlify/api/og/v2?division=%D9%85%D8%B1%D8%AC%D8%B9+%D8%A7%D9%84%D9%88%D8%A7%D8%AC%D9%87%D8%A9\u0026amp;title=%D9%88%D8%A7%D8%AC%D9%87%D8%A9+%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB+%D8%A7%D9%84%D8%AE%D8%A7%D8%AF%D9%85+%E2%80%94+POST+%2Fserver-events\u0026amp;description=%D8%A3%D8%B1%D8%B3%D9%84+%D8%AD%D8%AF%D8%AB+%D8%AA%D8%AD%D9%88%D9%8A%D9%84+%D9%88%D8%A7%D8%AD%D8%AF%D9%8B%D8%A7+%D9%85%D9%88%D8%AB%D9%91%D9%82%D9%8B%D8%A7+%D9%85%D9%86+%D8%A7%D9%84%D8%AE%D8%A7%D8%AF%D9%85+%D9%84%D8%AF%D9%8A%D9%83+%E2%80%94+%D8%B9%D9%85%D9%84%D9%8A%D8%A9+%D8%B4%D8%B1%D8%A7%D8%A1+%D8%A3%D9%88+%D8%AA%D8%B3%D8%AC%D9%8A%D9%84+%D8%A3%D9%88+%D8%B9%D9%85%D9%8A%D9%84%D9%8B%D8%A7+%D9%85%D8%AD%D8%AA%D9%85%D9%84%D9%8B%D8%A7+%D8%A3%D9%88+%D8%A3%D9%8A+%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1+%D8%AE%D9%84%D9%81%D9%8A+%D8%A2%D8%AE%D8%B1+%E2%80%94+%D9%85%D9%86%D8%B3%D9%88%D8%A8%D9%8B%D8%A7+%D8%A5%D9%84%D9%89+%D9%85%D8%B3%D8%AD+%D8%B1%D9%85%D8%B2+QR+%D8%A7%D9%84%D8%B0%D9%8A+%D8%AC%D8%A7%D8%A1+%D8%A8%D8%A7%D9%84%D8%B2%D8%A7%D8%A6%D8%B1.\u0026amp;theme=f9ed38a6e1c8b99666344abf\u0026amp;signature=4e3655304817fcfab0f533931a6941049859bd99f24f26fffb7caaac945fa110\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6938ef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ar/conversion-tracking/api/events-collect.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.scanova.io/de/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.scanova.io/fr/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.scanova.io/#organization\",\"name\":\"Scanova API Documentation\",\"url\":\"https://docs.scanova.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/PrimaryColor-Full.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=edc08604efcf06d6dd5d00e9e2c50f20\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.scanova.io#website\",\"name\":\"Scanova API Documentation\",\"url\":\"https://docs.scanova.io\",\"publisher\":{\"@id\":\"https://docs.scanova.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect#webpage\",\"url\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\",\"name\":\"واجهة أحداث الخادم — POST /server-events\",\"description\":\"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\",\"dateModified\":\"2026-09-17T15:36:07.143Z\",\"isPartOf\":{\"@id\":\"https://docs.scanova.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"مرجع الواجهة\",\"item\":\"https://docs.scanova.io/ar/conversion-tracking/api/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"واجهة أحداث الخادم — POST /server-events\",\"item\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect#apireference\",\"headline\":\"واجهة أحداث الخادم — POST /server-events\",\"name\":\"واجهة أحداث الخادم — POST /server-events\",\"description\":\"أرسل حدث تحويل واحدًا موثّقًا من الخادم لديك — عملية شراء أو تسجيل أو عميلًا محتملًا أو أي إجراء خلفي آخر — منسوبًا إلى مسح رمز QR الذي جاء بالزائر.\",\"url\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\",\"mainEntityOfPage\":{\"@id\":\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect#webpage\"},\"dateModified\":\"2026-09-17T15:36:07.143Z\",\"publisher\":{\"@id\":\"https://docs.scanova.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.scanova.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Scanova API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Scanova API Documentation","nav":{"global":{},"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/conversion-tracking/api/events-collect"}]},{"language":"de","pages":[{"title":"de","href":"/de/conversion-tracking/api/events-collect"}]},{"language":"es","pages":[{"title":"es","href":"/es/conversion-tracking/api/events-collect"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/conversion-tracking/api/events-collect"}]},{"language":"zh","pages":[{"title":"zh","href":"/conversion-tracking/api/events-collect"}]},{"language":"ar","versions":[{"version":"v2","default":true,"tag":"Latest","tabs":[{"tab":"الأدلة","pages":[{"title":"الأدلة","href":"/ar/getting-started/what-is-scanova"}]},{"tab":"مرجع واجهة البرمجة","pages":[{"title":"مرجع واجهة البرمجة","href":"/ar/api-reference/getting-started/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/ar/mcp/overview"}]},{"tab":"Conversion Tracking","groups":[{"group":"نظرة عامة","pages":[{"title":"ما هو تتبع التحويلات؟","href":"/ar/conversion-tracking/introduction"},{"title":"كيف يعمل تتبع التحويلات","href":"/ar/conversion-tracking/how-it-works"},{"title":"بداية سريعة — انطلق في 5 خطوات","href":"/ar/conversion-tracking/setup-guide"},{"title":"مرجع نموذج الأحداث","href":"/ar/conversion-tracking/event-model"}]},{"group":"SDK المتصفح","pages":[{"title":"نظرة عامة على SDK المتصفح","href":"/ar/conversion-tracking/browser/overview"},{"title":"تثبيت SDK المتصفح","href":"/ar/conversion-tracking/browser/install"},{"title":"مرجع إعداد SDK","href":"/ar/conversion-tracking/browser/sdk-configuration"},{"title":"الأحداث المتتبَّعة تلقائيًا","href":"/ar/conversion-tracking/browser/auto-tracking"},{"title":"الأحداث المخصصة","href":"/ar/conversion-tracking/browser/custom-events"},{"title":"إعداد تطبيقات SPA وأطر العمل","href":"/ar/conversion-tracking/browser/spa-frameworks"},{"title":"التحقق من SDK المتصفح وتصحيح أخطائه","href":"/ar/conversion-tracking/browser/verify"}]},{"group":"جهة الخادم","pages":[{"title":"نظرة عامة على أحداث الخادم","href":"/ar/conversion-tracking/server/overview"},{"title":"إنشاء مفتاح API","href":"/ar/conversion-tracking/server/generate-api-key-dashboard"},{"title":"إرسال أحداث الخادم","href":"/ar/conversion-tracking/server/send-events"},{"title":"تكرار الطلبات والإرسال مرة أخرى","href":"/ar/conversion-tracking/server/idempotency-retries"},{"title":"التحقق من أحداث الخادم وتصحيحها","href":"/ar/conversion-tracking/server/verify"}]},{"group":"مرجع الواجهة","pages":[{"title":"المصادقة في الواجهة البرمجية","href":"/ar/conversion-tracking/api/authentication"},{"title":"واجهة أحداث المتصفح — POST /ct","description":"مرجع نقطة وصول جمع أحداث المتصفح، وهي التي يستخدمها SDK المتصفح من Scanova لإرسال مشاهدات الصفحة والنقرات والأحداث المخصصة من متصفحات الزوار.","href":"/ar/conversion-tracking/api/browser-events"},{"title":"واجهة أحداث الخادم — POST /server-events","openapi":"POST /server-events","href":"/ar/conversion-tracking/api/events-collect"},{"title":"واجهة أحداث الخادم بالدفعات — POST /server-events/batch","openapi":"POST /server-events/batch","description":"أرسل ما يصل إلى 100 حدث تحويل من الخادم لديك في طلب موثّق واحد. ويُنصح بهذه الطريقة مع الإرسال عبر الطوابير ومع الخوادم ذات الحجم الكبير.","href":"/ar/conversion-tracking/api/events-batch"},{"title":"الأخطاء وحدود المعدل","href":"/ar/conversion-tracking/api/errors-rate-limits"},{"title":"تحليلات التحويلات","openapi":"POST /analytics/ct/","href":"/ar/conversion-tracking/api/ct-analytics"},{"title":"تصدير تحليلات التحويلات","openapi":"POST /analytics/ct/export/","href":"/ar/conversion-tracking/api/ct-export"},{"title":"تصدير أحداث التحويل الخام","openapi":"POST /analytics/ct/raw/","href":"/ar/conversion-tracking/api/ct-raw"}]},{"group":"الموارد","pages":[{"title":"حل المشكلات","href":"/ar/conversion-tracking/troubleshooting"},{"title":"الأسئلة الشائعة","href":"/ar/conversion-tracking/faq"},{"title":"سجل التغييرات","href":"/ar/conversion-tracking/changelog"}]}]}]},{"version":"v1","tag":"Legacy","pages":[{"title":"v1","href":"/v1"}]}]}]},"basePath":"","title":"واجهة أحداث الخادم — POST /server-events - Scanova API Documentation","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}