ΟΔΗΓΙΕΣ ΕΝΣΩΜΑΤΩΣΗΣ ΣΥΣΤΗΜΑΤΟΣ TRACKING

Γρήγορη Πλοήγηση

• Επισκόπηση
• Προαπαιτούμενα
• Γρήγορη Εκκίνηση (5 λεπτά)
• Βήμα-προς-βήμα Ενσωμάτωση
• Οδηγοί ανά Πλατφόρμα
• Δοκιμή της Ενσωμάτωσης
• Αντιμετώπιση Προβλημάτων
• Συχνές Ερωτήσεις
• Υποστήριξη

Επισκόπηση

Καλώς ήρθατε! Αυτός ο οδηγός θα σας βοηθήσει να ενσωματώσετε το σύστημα παρακολούθησης παραπομπών της Agnes Home στον ιστότοπό σας. Η ενσωμάτωση παρακολουθεί παραγγελίες από πελάτες που επισκέπτονται τον ιστότοπό σας μέσω της Agnes Home, επιτρέποντας αυτόματους υπολογισμούς προμήθειας.

Τι θα Ενσωματώσετε

Referral Script - Ανιχνεύει επισκέπτες από την Agnes Home (σε όλες τις σελίδες)
Order Tracking Script - Παρακολουθεί ολοκληρωμένες παραγγελίες (μόνο στη σελίδα ευχαριστιών)

Χρόνος που Απαιτείται

15-30 λεπτά για τις περισσότερες πλατφόρμες
5 λεπτά εάν χρησιμοποιείτε plugins WooCommerce ή Shopify

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε:

Το μοναδικό σας Company ID (που παρέχεται από την ομάδα της Agnes Home)
Πρόσβαση για επεξεργασία των αρχείων HTML/template του ιστότοπού σας
Πρόσβαση στη σελίδα “Ευχαριστώ” ή “Επιβεβαίωση Παραγγελίας” σας
Βασικές γνώσεις HTML/JavaScript (ή υποστήριξη προγραμματιστή)

Δεν έχετε το Company ID σας; Επικοινωνήστε με το info@agneshome.com

Γρήγορη Εκκίνηση (5 λεπτά)

Βήμα 1: Προσθήκη Referral Script (Όλες οι Σελίδες)

Προσθέστε αυτό το σενάριο σε κάθε σελίδα του ιστότοπού σας (συνήθως στο header ή footer):

<!-- Αντικαταστήστε το {YOUR_COMPANY_ID} με το πραγματικό σας Αναγνωριστικό Εταιρείας -->
<script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>

Παράδειγμα με Company ID 3:

<script src="https://mama-api.agneshome.com/order-tracking/referral/3"></script>

Βήμα 2: Προσθήκη Order Tracking Script (Thank you page)

Στη σελίδα Επιβεβαίωσης Παραγγελίας / Ευχαριστιών σας, προσθέστε αυτά τα στοιχεία:

<!-- Κρυφά στοιχεία παρακολούθησης -->
<div style="display: none;" agnes-track-order-id="ORDER-12345"></div>
<div style="display: none;" agnes-track-order-value="299.99"></div>
<div style="display: none;" agnes-track-order-value-vat="359.99"></div>

<!-- Σενάριο παρακολούθησης -->
<script src="https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}"></script>

⚠️ Σημαντικό: Αντικαταστήστε τις τιμές placeholder (`ORDER-12345`, `299.99`) με τα πραγματικά δεδομένα παραγγελίας σας χρησιμοποιώντας τις μεταβλητές template της πλατφόρμας σας.

Βήμα 3: Δοκιμή

Κάντε κλικ σε έναν σύνδεσμο από τον ιστότοπο της Agnes Home στον ιστότοπό σας
Ολοκληρώστε μια δοκιμαστική αγορά
Επαληθεύστε ότι η παραγγελία εμφανίζεται στο Dashboard Συνεργατών της Agnes

Αυτό είναι όλο!

Βήμα-προς-βήμα Ενσωμάτωση

Μέρος 1: Κατανόηση του Τρόπου Λειτουργίας

Πελάτης στην Agnes Home

↓ Κάνει κλικ σε σύνδεσμο προϊόντος συνεργάτη

Ιστότοπός σας

↓ Referral Script τρέχει, cookie ορίζεται ✓

Thank you page

↓ Order Tracking Script τρέχει, δεδομένα παραγγελίας αποστέλλονται ✓

Μέρος 2: Ενσωμάτωση του Referral Script

Τι κάνει:

Ανιχνεύει όταν οι επισκέπτες έρχονται από την Agnes Home
Ορίζει ένα cookie που διαρκεί 24 ώρες
Τρέχει αυτόματα, δεν χρειάζεται διαμόρφωση

Πού να το προσθέσετε:

Προσθέστε στο global header ή footer του ιστότοπού σας ώστε να φορτώνει σε κάθε σελίδα.

Κώδικας:

<script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>

Συνηθισμένες τοποθεσίες ανά πλατφόρμα:

Πλατφόρμα	Τοποθεσία Αρχείου
WordPress	`header.php` ή `footer.php`
Shopify	`theme.liquid` (στο `<head>` ή πριν το `</body>`)
Custom HTML	Πριν το `</head>` ή πριν το `</body>`
React/Vue	Στο κύριο `index.html` ή στο component App

Επαλήθευση:

Μετά την προσθήκη του σεναρίου, επισκεφτείτε τον ιστότοπό σας από την Agnes Home και ελέγξτε τα cookies του browser:

Όνομα cookie: agnes_referral_{YOUR_COMPANY_ID}
Πρέπει να περιέχει ένα τυχαίο αναγνωριστικό συνεδρίας

Μέρος 3: Ενσωμάτωση Order Tracking Script

Τι κάνει:

Ελέγχει για το cookie παραπομπής
Διαβάζει πληροφορίες παραγγελίας από HTML attributes
Στέλνει δεδομένα στο API της Agnes Home
Παρακολουθεί προμήθεια αυτόματα

Πού να το προσθέσετε:

Μόνο στη σελίδα Επιβεβαίωσης Παραγγελίας / Ευχαριστιών σας (τη σελίδα που βλέπουν οι πελάτες μετά την ολοκλήρωση μιας αγοράς).

Απαιτούμενα Στοιχεία:

<!-- 1. Order ID (Απαιτούμενο) -->
<div agnes-track-order-id="YOUR_ORDER_ID"></div>

<!-- 2. Σύνολο Παραγγελίας χωρίς ΦΠΑ (Απαιτούμενο για υπολογισμό προμήθειας) -->
<div agnes-track-order-value="ORDER_SUBTOTAL"></div>

<!-- 3. Σύνολο με ΦΠΑ (Προαιρετικό) -->
<div agnes-track-order-value-vat="ORDER_VAT_VALUE"></div>

<!-- 4. Script Παρακολούθησης Παραγγελίας (Απαιτούμενο) -->
<script src="https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}"></script>

Κάνοντας τα Στοιχεία Αόρατα:

Μπορείτε να κρύψετε τα tracking divs χρησιμοποιώντας οποιαδήποτε από αυτές τις μεθόδους:

<!-- Μέθοδος 1: Inline style (συνιστάται) -->
<div style="display: none;" agnes-track-order-id="123"></div>

<!-- Μέθοδος 2: Hidden attribute -->
<div hidden agnes-track-order-id="123"></div>

<!-- Μέθοδος 3: CSS class -->
<div class="agnes-tracking-hidden" agnes-track-order-id="123"></div>
<style>.agnes-tracking-hidden { display: none; }</style>

Σημαντικές Σημειώσεις:

1. Μορφή Αξίας Παραγγελίας:

Χρησιμοποιήστε μόνο αριθμούς (χωρίς σύμβολα νομίσματος)
Χρησιμοποιήστε δεκαδικό σημείο (όχι κόμμα): 299.99 ✓ όχι 299,99 ✗
Παραδείγματα: 299.99, 1250.50, 49.00

2. Αναγνωριστικό Παραγγελίας:

Μπορεί να είναι οποιαδήποτε μορφή string
Πρέπει να είναι μοναδικό ανά παραγγελία
Παραδείγματα: ORDER-12345, INV-2025-001, 12345

3. Εκτέλεση:

Το script τρέχει αυτόματα όταν φορτώνει η σελίδα
Παρακολουθεί μόνο εάν υπάρχει cookie παραπομπής
Παρακολουθεί μία φορά ανά φόρτωση σελίδας (ασφαλές από διπλές καταχωρήσεις)

Οδηγοί ανά Πλατφόρμα

Shopify

1. Προσθήκη Referral Script σε Όλες τις Σελίδες

Τοποθεσία: theme.liquid

Πηγαίνετε σε: Online Store → Themes → Actions → Edit Code
Ανοίξτε το Layout/theme.liquid
Προσθέστε πριν το </head>:

<!-- Agnes Home Referral Tracking -->
<script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>

2. Προσθήκη Παρακολούθησης Παραγγελιών στη Thank you page

Τοποθεσία: Settings → Checkout → Thank you page

Πηγαίνετε σε: Settings → Checkout
Κυλήστε στο Order Status Page → Additional Scripts
Προσθέστε αυτόν τον κώδικα:

{% if first_time_accessed %}
<!-- Agnes Home Order Tracking -->
<div style="display: none;" agnes-track-order-id="{{ order.name }}"></div>
<div style="display: none;" agnes-track-order-value="{{ order.subtotal_price | money_without_currency | remove: ',' }}"></div>
<div style="display: none;" agnes-track-order-value-vat="{{ order.total_price | money_without_currency | remove: ',' }}"></div>

<script src="https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}"></script>
{% endif %}

💡 Το {% if first_time_accessed %} διασφαλίζει ότι η παρακολούθηση συμβαίνει μόνο μία φορά, ακόμα και αν ο πελάτης ανανεώσει τη σελίδα.

WooCommerce (WordPress)

1. Προσθήκη Referral Script σε Όλες τις Σελίδες

Μέθοδος Α: Χρήση του functions.php του θέματος (Συνιστάται)

Προσθέστε στο functions.php του θέματός σας:

// Agnes Home Referral Tracking
add_action('wp_footer', function() {
    ?>
    <script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>
    <?php
});

2. Προσθήκη Παρακολούθησης Παραγγελιών στη Thank you page

Προσθέστε στο functions.php του θέματός σας:

// Agnes Home Order Tracking
add_action('woocommerce_thankyou', function($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);
    $company_id = '{YOUR_COMPANY_ID}'; // Αντικαταστήστε με το Αναγνωριστικό Εταιρείας σας
    ?>

    <!-- Agnes Home Order Tracking -->
    <div style="display: none;" agnes-track-order-id="<?php echo esc_attr($order->get_order_number()); ?>"></div>
    <div style="display: none;" agnes-track-order-value="<?php echo esc_attr($order->get_subtotal()); ?>"></div>
    <div style="display: none;" agnes-track-order-value-vat="<?php echo esc_attr($order->get_total()); ?>"></div>

    <script src="https://mama-api.agneshome.com/order-tracking/script/<?php echo esc_attr($company_id); ?>"></script>

    <?php
}, 10, 1);

Magento 2

1. Προσθήκη Referral Script σε Όλες τις Σελίδες

Τοποθεσία: app/design/frontend/[Vendor]/[Theme]/Magento_Theme/templates/html/header.phtml

Ή προσθέστε μέσω Admin:

Content → Design → Configuration → HTML Head → Scripts and Style Sheets

<script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>

2. Προσθήκη Παρακολούθησης Παραγγελιών στη Success Page

Τοποθεσία: app/design/frontend/[Vendor]/[Theme]/Magento_Checkout/templates/success.phtml

<?php
$orderId = $block->getOrderId();
$order = $block->getOrder();
$companyId = '{YOUR_COMPANY_ID}'; // Αντικαταστήστε με το Αναγνωριστικό Εταιρείας σας
?>

<!-- Agnes Home Order Tracking -->
<div style="display: none;" agnes-track-order-id="<?= $escaper->escapeHtmlAttr($orderId) ?>"></div>
<div style="display: none;" agnes-track-order-value="<?= $escaper->escapeHtmlAttr($order->getSubtotal()) ?>"></div>
<div style="display: none;" agnes-track-order-value-vat="<?= $escaper->escapeHtmlAttr($order->getGrandTotal()) ?>"></div>

<script src="https://mama-api.agneshome.com/order-tracking/script/<?= $escaper->escapeHtmlAttr($companyId) ?>"></script>

React / Vue / Angular (SPA)

1. Προσθήκη Referral Script στο index.html

Στο public/index.html σας:

<!DOCTYPE html>
<html>
  <head>
    <!-- ... άλλο περιεχόμενο head ... -->

    <!-- Agnes Home Referral Tracking -->
    <script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

2. Παρακολούθηση Παραγγελιών στο Component Checkout σας

Παράδειγμα React:

// Στο OrderSuccess/ThankYou component σας
import React, { useEffect } from 'react';

function OrderSuccessPage({ order }) {
  useEffect(() => {
    // Δημιουργία στοιχείων παρακολούθησης
    const orderIdDiv = document.createElement('div');
    orderIdDiv.setAttribute('agnes-track-order-id', order.id);
    orderIdDiv.style.display = 'none';
    document.body.appendChild(orderIdDiv);

    const orderValueDiv = document.createElement('div');
    orderValueDiv.setAttribute('agnes-track-order-value', order.subtotal);
    orderValueDiv.style.display = 'none';
    document.body.appendChild(orderValueDiv);

    const orderValueVatDiv = document.createElement('div');
    orderValueVatDiv.setAttribute('agnes-track-order-value-vat', order.total);
    orderValueVatDiv.style.display = 'none';
    document.body.appendChild(orderValueVatDiv);

    // Φόρτωση σεναρίου παρακολούθησης
    const script = document.createElement('script');
    script.src = 'https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}';
    document.body.appendChild(script);

    // Καθαρισμός
    return () => {
      document.body.removeChild(orderIdDiv);
      document.body.removeChild(orderValueDiv);
      document.body.removeChild(orderValueVatDiv);
      document.body.removeChild(script);
    };
  }, [order]);

  return (
    <div>
      <h1>Ευχαριστούμε για την παραγγελία σας!</h1>
      <p>Αναγνωριστικό Παραγγελίας: {order.id}</p>
      {/* ... υπόλοιπο component σας ... */}
    </div>
  );
}

Παράδειγμα Vue 3:

<template>
  <div>
    <h1>Ευχαριστούμε για την παραγγελία σας!</h1>
    <p>Αναγνωριστικό Παραγγελίας: {{ order.id }}</p>
    <!-- ... υπόλοιπο template σας ... -->
  </div>
</template>

<script setup>
import { onMounted } from 'vue';

const props = defineProps({
  order: Object
});

onMounted(() => {
  // Δημιουργία στοιχείων παρακολούθησης
  const createHiddenDiv = (attr, value) => {
    const div = document.createElement('div');
    div.setAttribute(attr, value);
    div.style.display = 'none';
    document.body.appendChild(div);
    return div;
  };

  const orderIdDiv = createHiddenDiv('agnes-track-order-id', props.order.id);
  const orderValueDiv = createHiddenDiv('agnes-track-order-value', props.order.subtotal);
  const orderValueVatDiv = createHiddenDiv('agnes-track-order-value-vat', props.order.total);

  // Φόρτωση σεναρίου παρακολούθησης
  const script = document.createElement('script');
  script.src = 'https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}';
  document.body.appendChild(script);
});
</script>

Παράδειγμα Angular 20:

// Στο OrderSuccessComponent σας
import { Component, OnInit, Input } from '@angular/core';

@Component({
  selector: 'app-order-success',
  template: `
    <div>
      <h1>Ευχαριστούμε για την παραγγελία σας!</h1>
      <p>Αναγνωριστικό Παραγγελίας: {{ order.id }}</p>
      <!-- ... υπόλοιπο template σας ... -->
    </div>
  `
})
export class OrderSuccessComponent implements OnInit {
  @Input() order: any;

  ngOnInit() {
    // Δημιουργία στοιχείων παρακολούθησης
    const createHiddenDiv = (attr: string, value: string) => {
      const div = document.createElement('div');
      div.setAttribute(attr, value);
      div.style.display = 'none';
      document.body.appendChild(div);
      return div;
    };

    const orderIdDiv = createHiddenDiv('agnes-track-order-id', this.order.id);
    const orderValueDiv = createHiddenDiv('agnes-track-order-value', this.order.subtotal);
    const orderValueVatDiv = createHiddenDiv('agnes-track-order-value-vat', this.order.total);

    // Φόρτωση σεναρίου παρακολούθησης
    const script = document.createElement('script');
    script.src = 'https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}';
    document.body.appendChild(script);
  }
}

Custom HTML / Static Sites

1. Προσθήκη Referral Script

Προσθέστε σε όλες τις σελίδες πριν το </head> ή </body>:

<!DOCTYPE html>
<html>
<head>
  <!-- ... περιεχόμενο head σας ... -->
  <script src="https://mama-api.agneshome.com/order-tracking/referral/3"></script>
</head>
<body>
  <!-- Περιεχόμενο σελίδας σας -->
</body>
</html>

2. Προσθήκη Παρακολούθησης Παραγγελιών

Στη σελίδα ευχαριστιών σας:

<!DOCTYPE html>
<html>
<head>
  <title>Ευχαριστούμε για την Παραγγελία σας</title>
  <script src="https://mama-api.agneshome.com/order-tracking/referral/3"></script>
</head>
<body>
  <h1>Ευχαριστούμε για την Παραγγελία σας!</h1>
  <p>Η παραγγελία σας #12345 έχει επιβεβαιωθεί.</p>

  <!-- Agnes Home Order Tracking -->
  <div style="display: none;" agnes-track-order-id="12345"></div>
  <div style="display: none;" agnes-track-order-value="299.99"></div>
  <div style="display: none;" agnes-track-order-value-vat="359.99"></div>

  <script src="https://mama-api.agneshome.com/order-tracking/script/3"></script>
</body>
</html>

Σημείωση: Για στατικούς ιστότοπους, θα χρειαστείτε ένα σύστημα backend για να εισάγετε δυναμικά τις πραγματικές τιμές παραγγελιών.

Δοκιμή της Ενσωμάτωσης

Βήμα 1: Δοκιμή Παρακολούθησης Referral

Διαγράψτε τα cookies του browser (ή χρησιμοποιήστε incognito mode)
Επισκεφτείτε την Agnes Home και κάντε κλικ σε έναν σύνδεσμο προς τον ιστότοπό σας
Ελέγξτε εάν ορίστηκε cookie:
- Ανοίξτε τα DevTools του browser (F12)
- Πηγαίνετε σε Application/Storage → Cookies
- Αναζητήστε: agnes_referral_{YOUR_COMPANY_ID}
- Πρέπει να έχει μια τιμή όπως: abc123xyz789

Αντιμετώπιση Προβλημάτων:

❌ Δεν υπάρχει cookie; Ελέγξτε εάν φορτώνει το σενάριο παραπομπής (Network tab)
❌ Cookie δεν ορίζεται; Ελέγξτε την κονσόλα του browser για σφάλματα

Βήμα 2: Δοκιμή Παρακολούθησης Παραγγελιών

Βεβαιωθείτε ότι υπάρχει cookie παραπομπής (από Βήμα 1)
Ολοκληρώστε μια δοκιμαστική αγορά στον ιστότοπό σας
Στη σελίδα ευχαριστιών, ελέγξτε την κονσόλα του browser:
- Ανοίξτε DevTools (F12) → Console
- Αναζητήστε μηνύματα παρακολούθησης της Agnes
- Πρέπει να δείτε: “Order tracking successful” ή παρόμοιο
Επαληθεύστε ότι υπάρχουν τα στοιχεία παρακολούθησης:
- Στο Elements tab των DevTools, αναζητήστε agnes-track
- Πρέπει να βρείτε τα 3-4 tracking divs σας με σωστές τιμές
Ελέγξτε το Network tab:
- Αναζητήστε POST request σε: order-tracking/track/{YOUR_COMPANY_ID}
- Η κατάσταση πρέπει να είναι: 200 OK
Επικοινωνήστε με την ομάδα της Agnes Home για να επιβεβαιώσετε ότι η παραγγελία ελήφθη

Βήμα 3: Χρήση Εργαλείου Δοκιμής της Agnes

Η Agnes Home παρέχει μια σελίδα δοκιμής στο Admin Dashboard:

Πλοηγηθείτε σε: https://admin.agneshome.com/demo/{YOUR_COMPANY_ID}
Ακολουθήστε τη διαδικασία δοκιμής 3 βημάτων:
- Βήμα 1: Προσθήκη Referral Script
- Βήμα 2: Επαλήθευση cookie
- Βήμα 3: Προσομοίωση δοκιμαστικής παραγγελίας

Λίστα Ελέγχου Δοκιμής

Χρησιμοποιήστε αυτή τη λίστα ελέγχου για να επαληθεύσετε την ενσωμάτωσή σας:

☐ Το Referral Script φορτώνει σε όλες τις σελίδες
☐ Το cookie παραπομπής ορίζεται όταν επισκέπτεστε από την Agnes Home
☐ Το όνομα cookie ταιριάζει: agnes_referral_{YOUR_COMPANY_ID}
☐ Το Order Tracking Script φορτώνει στη σελίδα ευχαριστιών
☐ Το attribute Order ID έχει σωστή τιμή
☐ Το attribute Order Value έχει σωστό αριθμό (χωρίς σύμβολα νομίσματος)
☐ Το attribute Order Vat value έχει σωστό σύνολο (προαιρετικό)
☐ Το Network request στο tracking endpoint επιτυγχάνει (200 OK)
☐ Η κονσόλα του browser δεν εμφανίζει σφάλματα
☐ Η δοκιμαστική παραγγελία εμφανίζεται στο Agnes Partner Dashboard

Αντιμετώπιση Προβλημάτων

Πρόβλημα: Cookie Referral δεν Ορίζεται

Συμπτώματα:

Δεν υπάρχει cookie agnes_referral_ στον browser
Οι παραγγελίες δεν παρακολουθούνται

Λύσεις:

Ελέγξτε εάν φορτώνει το σενάριο:
DevTools → Network → Filter: “referral”
Πρέπει να δείτε: referral/{YOUR_COMPANY_ID} με κατάσταση 200
Ελέγξτε για σφάλματα JavaScript:
DevTools → Console
Αναζητήστε κόκκινα μηνύματα σφάλματος
Επαληθεύστε ότι έρχεστε από την Agnes Home:
- Το cookie ορίζεται μόνο εάν επισκέπτεστε ΑΠΟ τον ιστότοπο της Agnes Home
- Οι άμεσες επισκέψεις δεν ορίζουν cookie (αυτό είναι σκόπιμο)
- Ελέγξτε ότι το document.referrer περιλαμβάνει τον τομέα της Agnes Home
Ελέγξτε εάν το cookie δεν μπλοκάρεται:
- Ορισμένες επεκτάσεις απορρήτου μπλοκάρουν cookies τρίτων
- Δοκιμάστε σε incognito mode χωρίς επεκτάσεις

Πρόβλημα: Παραγγελίες δεν Παρακολουθούνται

Συμπτώματα:

Το cookie υπάρχει αλλά οι παραγγελίες δεν εμφανίζονται στο Agnes Dashboard
Το Network request αποτυγχάνει ή επιστρέφει σφάλμα

Λύσεις:

Επαληθεύστε ότι υπάρχουν τα attributes παρακολούθησης:
DevTools → Elements → Search for “agnes-track”
Πρέπει να βρείτε 3 divs με τα δεδομένα παραγγελίας σας
Ελέγξτε ότι οι τιμές των attributes είναι σωστές:
✓ Αναγνωριστικό Παραγγελίας: Οποιοδήποτε string (χωρίς ειδικές απαιτήσεις)
✓ Αξία Παραγγελίας: Μόνο αριθμός, χρησιμοποιήστε δεκαδικό σημείο (299.99)
✗ Αξία Παραγγελίας: Μην χρησιμοποιείτε σύμβολα νομίσματος (€299.99)
Ελέγξτε το Network request:
DevTools → Network → Filter: “track”
Πρέπει να δείτε POST σε: order-tracking/track/{YOUR_COMPANY_ID}
Η κατάσταση πρέπει να είναι: 200 OK

Ελέγξτε το payload του request:

{
  "orderId": "ORDER-123",
  "orderValue": "299.99",
  "referralId": "abc123xyz"
}

Επαληθεύστε ότι το cookie παραπομπής εξακολουθεί να υπάρχει:
- Το cookie λήγει μετά από 24 ώρες
- Εάν ο πελάτης περιμένει πολύ, το cookie μπορεί να έχει λήξει

Πρόβλημα: Διπλές Παραγγελίες

Συμπτώματα:

Η ίδια παραγγελία εμφανίζεται πολλές φορές στο Agnes Dashboard

Λύσεις:

Ελέγξτε για πολλαπλές φορτώσεις σεναρίου:
- Βεβαιωθείτε ότι το σενάριο παρακολούθησης φορτώνει μόνο μία φορά ανά σελίδα
- Μην προσθέτετε σενάριο στο global header/footer (μόνο στη σελίδα ευχαριστιών)
Για χρήστες Shopify:
Πάντα χρησιμοποιήστε: {% if first_time_accessed %}
Αυτό αποτρέπει την παρακολούθηση σε ανανέωση σελίδας
Για SPA (React/Vue):
- Χρησιμοποιήστε useEffect με κενό dependency array
- Ή ελέγξτε εάν έχει ήδη παρακολουθηθεί πριν την εκτέλεση

Πρόβλημα: Λάθος Τιμές Παραγγελιών

Συμπτώματα:

Οι υπολογισμοί προμήθειας είναι λανθασμένοι
Οι τιμές παραγγελιών δεν ταιριάζουν με τα αρχεία σας

Λύσεις:

Ελέγξτε τη μορφή αριθμού:
✓ Σωστό: 299.99
✗ Λάθος: 299,99 (κόμμα αντί για τελεία)
✗ Λάθος: €299.99 (περιλαμβάνει σύμβολο νομίσματος)
✗ Λάθος: 299.99 EUR (περιλαμβάνει κωδικό νομίσματος)
Επαληθεύστε ποια τιμή στέλνετε:
- agnes-track-order-value πρέπει να είναι SUBTOTAL (πριν το ΦΠΑ)
- agnes-track-order-value-vat πρέπει να είναι TOTAL (με ΦΠΑ)
- Η προμήθεια υπολογίζεται στην πρώτη τιμή (subtotal)
Για WooCommerce:
Subtotal: $order->get_subtotal()
Total: $order->get_total()
Για Shopify:
Subtotal: {{ order.subtotal_price | money_without_currency }}
Total: {{ order.total_price | money_without_currency }}

Πρόβλημα: Σενάριο Αποκλεισμένο από Ad Blockers

Συμπτώματα:

Το σενάριο δεν φορτώνει για ορισμένους χρήστες
Σφάλμα “Failed to load resource” στην κονσόλα

Λύσεις:

Αυτό είναι αναμενόμενο συμπεριφορά:
- Ορισμένοι χρήστες έχουν ad blockers που αποκλείουν σενάρια παρακολούθησης
- Δυστυχώς, δεν υπάρχει αξιόπιστη λύση
- Οι περισσότεροι χρήστες (~80-90%) δεν θα έχουν blockers
Μελλοντική λύση:
- Η Agnes Home εργάζεται σε ένα server-to-server API
- Αυτό θα παρακάμψει τον αποκλεισμό client-side
- Επικοινωνήστε με την υποστήριξη για ενημερώσεις

Πρόβλημα: Δοκιμή σε Περιβάλλον Ανάπτυξης

Συμπτώματα:

Το cookie ορίζεται αλλά οι παραγγελίες δεν παρακολουθούνται
Σφάλματα δικτύου στην τοπική ανάπτυξη

Λύσεις:

Περιορισμοί CORS:
- Το Agnes API επιτρέπει cross-origin requests
- Θα πρέπει να λειτουργεί στην ανάπτυξη, αλλά ελέγξτε την κονσόλα για σφάλματα CORS
Χρησιμοποιήστε localhost, όχι 127.0.0.1:
- Ορισμένοι browsers χειρίζονται τα cookies διαφορετικά
Δοκιμάστε σε περιβάλλον staging:
- Εάν είναι δυνατό, δοκιμάστε σε έναν δημόσιο staging ιστότοπο
- Πιο αξιόπιστο από την τοπική ανάπτυξη

Συνηθισμένα Μηνύματα Σφάλματος

Σφάλμα	Σημασία	Λύση
`Company not found`	Μη έγκυρο Αναγνωριστικό Εταιρείας	Ελέγξτε ξανά το Αναγνωριστικό Εταιρείας σας
`Missing order details`	Δεν βρέθηκαν attributes παρακολούθησης	Επαληθεύστε ότι τα divs υπάρχουν με σωστά attributes
`No valid referral found`	Το cookie δεν υπάρχει ή έχει λήξει	Βεβαιωθείτε ότι επισκεφτήκατε από την Agnes Home
`Network error`	Το API δεν είναι προσβάσιμο	Ελέγξτε τη σύνδεση internet, δοκιμάστε ξανά
`CORS error`	Cross-origin μπλοκαρισμένο	Επικοινωνήστε με την υποστήριξη της Agnes Home

Συχνές Ερωτήσεις

Γενικές Ερωτήσεις

Ε: Πόσο διαρκεί το cookie παραπομπής;

Α: 24 ώρες από όταν ο επισκέπτης προσγειώνεται για πρώτη φορά στον ιστότοπό σας από την Agnes Home.

Ε: Τι γίνεται εάν ένας πελάτης επιστρέψει μετά από 24 ώρες για να ολοκληρώσει την αγορά του;

Α: Η παραγγελία δεν θα παρακολουθηθεί καθώς το cookie θα έχει λήξει. Ενθαρρύνετε γρήγορες μετατροπές!

Ε: Μπορώ να παρακολουθήσω παραγγελίες χειροκίνητα;

Α: Όχι αυτή τη στιγμή, αλλά το server-to-server API είναι σε εξέλιξη. Επικοινωνήστε με την υποστήριξη για πρόσβαση beta.

Ε: Τα προσωπικά στοιχεία του πελάτη μοιράζονται με την Agnes Home;

Α: Όχι. Μόνο το Αναγνωριστικό Παραγγελίας, η αξία παραγγελίας και το περιεχόμενο HTML (για επαλήθευση) αποστέλλονται. Δεν υπάρχουν προσωπικά στοιχεία πελάτη.

Ε: Αυτό επιβραδύνει τον ιστότοπό μου;

Α: Όχι. Τα σενάρια είναι ελαφριά (<10KB) και φορτώνουν ασύγχρονα. Ελάχιστη επίπτωση στην απόδοση.

Τεχνικές Ερωτήσεις

Ε: Μπορώ να χρησιμοποιήσω διαφορετικό όνομα attribute;

Α: Όχι. Το σενάριο αναζητά συγκεκριμένα τα agnes-track-order-id, agnes-track-order-value και agnes-track-order-value-vat.

Ε: Τα divs πρέπει να είναι ορατά;

Α: Όχι. Μπορείτε (και θα πρέπει) να τα κρύψετε χρησιμοποιώντας style=“display: none;” ή παρόμοιες μεθόδους.

Ε: Μπορώ να βάλω το tracking script στο <head>;

Α: Ναι, αλλά είναι καλύτερα στο <body> μετά τα tracking divs για να διασφαλίσετε ότι υπάρχουν όταν τρέχει το tracking script.

Ε: Τι γίνεται εάν δεν συμπεριλάβω την τιμή ΦΠΑ;

Α: Δεν πειράζει. Είναι προαιρετικό. Η προμήθεια υπολογίζεται μόνο στην βασική αξία παραγγελίας.

Ε: Μπορώ να παρακολουθήσω μερικές επιστροφές;

Α: Όχι αυτόματα. Επικοινωνήστε με την υποστήριξη της Agnes Home για να προσαρμόσετε την προμήθεια για επιστραφείσες παραγγελίες.

Ε: Λειτουργεί με AJAX/dynamic checkouts;

Α: Ναι, εφόσον τα tracking divs υπάρχουν στο DOM όταν τρέχει το σενάριο παρακολούθησης.

Ε: Μπορώ να ενεργοποιήσω την παρακολούθηση προγραμματιστικά;

Α: Όχι αυτή τη στιγμή. Το script τρέχει αυτόματα όταν φορτώνει η σελίδα. Το μελλοντικό API θα υποστηρίξει χειροκίνητη ενεργοποίηση.

Ερωτήσεις Συμμόρφωσης

Ε: Είναι αυτό συμβατό με το GDPR;

Α: Ναι. Το σύστημα χρησιμοποιεί first-party cookies και δεν συλλέγει προσωπικά δεδομένα χωρίς συγκατάθεση.

Ε: Χρειάζεται να ενημερώσω την πολιτική απορρήτου μου;

Α: Ναι. Θα πρέπει να αναφέρετε ότι χρησιμοποιείτε παρακολούθηση της Agnes Home για σκοπούς συνεργασίας.

Ε: Χρειάζομαι συγκατάθεση cookie;

Α: Εξαρτάται από την δικαιοδοσία σας. Συμβουλευτείτε νομικό σύμβουλο. Το cookie είναι λειτουργικό, όχι αναλυτικό.

Υποστήριξη

Χρειάζεστε Βοήθεια;

Υποστήριξη Email:

info@agneshome.com

Χρόνος Απάντησης:

Ώρες εργασίας: < 4 ώρες
Μετά τις ώρες εργασίας: < 24 ώρες

Ώρες Εργασίας:

Δευτέρα - Παρασκευή: 9:00 - 18:00 (EET)

Πριν Επικοινωνήσετε με την Υποστήριξη

Παρακαλώ έχετε έτοιμα:

Το Αναγνωριστικό Εταιρείας σας
Πλατφόρμα/CMS που χρησιμοποιείτε
URL του ιστότοπού σας
Στιγμιότυπο οθόνης της κονσόλας του browser (εάν υπάρχει σφάλμα)
Στιγμιότυπο οθόνης του Network tab (εάν αποτυγχάνει η παρακολούθηση)

Χρήσιμοι Πόροι

Partner Dashboard: https://company.agneshome.com
Ιστότοπος Agnes Home: https://www.agneshome.com

Πρότυπα Κώδικα

Γρήγορα Πρότυπα Copy-Paste

Πρότυπο 1: Βασικό HTML

<!-- Προσθήκη σε όλες τις σελίδες (στο <head> ή πριν το </body>) -->
<script src="https://mama-api.agneshome.com/order-tracking/referral/{YOUR_COMPANY_ID}"></script>

<!-- Προσθήκη μόνο στη σελίδα ευχαριστιών -->
<div style="display: none;" agnes-track-order-id="{ORDER_ID}"></div>
<div style="display: none;" agnes-track-order-value="{ORDER_SUBTOTAL}"></div>
<div style="display: none;" agnes-track-order-value-vat="{ORDER_TOTAL}"></div>
<script src="https://mama-api.agneshome.com/order-tracking/script/{YOUR_COMPANY_ID}"></script>

Πρότυπο 2: PHP (Γενικό)

<!-- Σενάριο Παραπομπής (όλες οι σελίδες) -->
<script src="https://mama-api.agneshome.com/order-tracking/referral/<?php echo YOUR_COMPANY_ID; ?>"></script>

<!-- Παρακολούθηση Παραγγελιών (σελίδα ευχαριστιών) -->
<div style="display: none;" agnes-track-order-id="<?php echo htmlspecialchars($order_id); ?>"></div>
<div style="display: none;" agnes-track-order-value="<?php echo htmlspecialchars($order_subtotal); ?>"></div>
<div style="display: none;" agnes-track-order-value-vat="<?php echo htmlspecialchars($order_total); ?>"></div>
<script src="https://mama-api.agneshome.com/order-tracking/script/<?php echo YOUR_COMPANY_ID; ?>"></script>

Πρότυπο 3: JavaScript (Δυναμική Δημιουργία)

// Δημιουργία και προσθήκη στοιχείων παρακολούθησης
function trackAgnesOrder(orderId, orderValue, orderValueVat, companyId) {
  // Δημιουργία tracking divs
  const createDiv = (attr, value) => {
    const div = document.createElement('div');
    div.setAttribute(attr, value);
    div.style.display = 'none';
    document.body.appendChild(div);
    return div;
  };

  createDiv('agnes-track-order-id', orderId);
  createDiv('agnes-track-order-value', orderValue);
  if (orderValueVat) {
    createDiv('agnes-track-order-value-vat', orderValueVat);
  }

  // Φόρτωση σεναρίου παρακολούθησης
  const script = document.createElement('script');
  script.src = `https://mama-api.agneshome.com/order-tracking/script/${companyId}`;
  document.body.appendChild(script);
}

// Χρήση:
trackAgnesOrder('ORDER-123', '299.99', '359.99', 3);

Λίστα Ελέγχου Ενσωμάτωσης

Εκτυπώστε αυτή τη λίστα ελέγχου και σημειώστε κάθε στοιχείο καθώς το ολοκληρώνετε:

Προ-Ενσωμάτωση

☐ Λάβατε Αναγνωριστικό Εταιρείας από την Agnes Home
☐ Έχετε πρόσβαση για επεξεργασία κώδικα ιστότοπου
☐ Εντοπίσατε τη θέση της σελίδας ευχαριστιών
☐ Διαβάσατε τον οδηγό ενσωμάτωσης

Ενσωμάτωση

☐ Προσθέσατε σενάριο παραπομπής σε όλες τις σελίδες
☐ Επαληθεύσατε ότι φορτώνει το σενάριο παραπομπής (Network tab)
☐ Προσθέσατε στοιχεία παρακολούθησης στη σελίδα ευχαριστιών
☐ Προσθέσατε σενάριο παρακολούθησης στη σελίδα ευχαριστιών
☐ Αντικαταστήσατε τις τιμές placeholder με δυναμικά δεδομένα
☐ Κρύψατε τα tracking divs από την προβολή

Δοκιμή

☐ Διέγραψα cookies του browser
☐ Επισκέφτηκα τον ιστότοπο από σύνδεσμο Agnes Home
☐ Επαλήθευσα ότι ορίστηκε cookie παραπομπής
☐ Ολοκλήρωσα δοκιμαστική αγορά
☐ Ελέγξα την κονσόλα του browser για σφάλματα
☐ Επαλήθευσα ότι το network request παρακολούθησης επιτύχη
☐ Επιβεβαίωσα ότι η παραγγελία εμφανίζεται στο Agnes Dashboard

Μετά την Εκκίνηση

☐ Ενημέρωσα την πολιτική απορρήτου (εάν απαιτείται)
☐ Τεκμηρίωσα την ενσωμάτωση για την ομάδα
☐ Ρύθμισα παρακολούθηση/ειδοποιήσεις (προαιρετικό)
☐ Προγραμμάτισα ανασκόπηση μετά από 30 ημέρες

Επιτυχία!

Μόλις ολοκληρώσετε όλα τα βήματα και επαληθεύσετε ότι η παρακολούθηση λειτουργεί, είστε έτοιμοι!

Οι παραγγελίες από παραπομπές της Agnes Home θα παρακολουθούνται τώρα αυτόματα, και οι προμήθειες θα υπολογίζονται για εσάς.

Ερωτήσεις; Επικοινωνήστε με το info@agneshome.com

Έκδοση Εγγράφου: 1.0

Τελευταία Ενημέρωση: Οκτώβριος 2025

Συντηρείται από: Ομάδα Ανάπτυξης της Agnes Home