الأدلة

اكتشاف دولة الزائر لضبط الضريبة والعملة الافتراضيتين

مطالبة زائر جديد باختيار دولته من قائمة منسدلة طويلة قبل عرض السعر عليه خطوة إضافية يمكن لقيمة افتراضية جيدة أن تلغيها تمامًا.

الحصول على رمز الدولة

استدعاء واحد إلى /v1/ip بعنوان الزائر يعيد الحقل country_code بالصيغة القياسية ISO 3166-1 alpha-2، وهي الصيغة التي تعتمد عليها أصلًا معظم جداول البحث عن الضرائب والعملات.

GET /v1/ip?ip=198.51.100.7
{
  "status": "ok",
  "ip": "198.51.100.7",
  "version": 4,
  "found": true,
  "country": "Germany",
  "country_code": "DE",
  "region": "Berlin",
  "city": "Berlin",
  "postcode": "10115",
  "lat": 52.5200,
  "lon": 13.4050,
  "timezone": "Europe/Berlin",
  "asn": 6789,
  "org": "Example Telecom"
}

من رمز الدولة إلى الضريبة والعملة

اربط قيمة country_code بجدول معدلات الضرائب وجدول العملات لديك، بالطريقة نفسها التي تربط بها دولة اختارها العميل يدويًا. تعامل مع الدولة المستخرجة من IP كقيمة افتراضية لا كإجابة نهائية، واسمح للزائر بتغييرها، لأن العميل المسافر أو الذي يتصل عبر VPN لن يطابق دائمًا دولة الفوترة التي يحتاجها فعلًا.

عندما لا يعيد الاستعلام نتيجة

الطلب الخاص بعنوان لا تتوفر له بيانات موقع يعيد الحقل found بقيمة false بدلًا من خطأ، وهذا أمر يستحق التخطيط له صراحة. ارجع في هذه الحالة إلى دولة وعملة افتراضيتين معقولتين بدلًا من ترك الحقل فارغًا أو السماح لقيمة country_code فارغة بالوصول إلى حساب الضريبة دون أن يلاحظها أحد.

أين تختلف My Geocode نفسها

تسعير My Geocode نفسه باليورو (EUR) فقط، في كل أنحاء العالم، بغض النظر عن البلد الذي يُفوتَر منه العميل. وهذه مسألة منفصلة عما تعرضه لزوارك، إذ إن توطين العملة المعروضة حسب الدولة المكتشفة أمر معقول تمامًا حتى لو كان نظامك الخلفي يسوّي كل شيء بعملة واحدة، كما يفعل نظامنا.

خطأ يستحق التجنب

حصر الزائر في الدولة المكتشفة دون أي وسيلة لتغييرها مشكلة أكبر من الخطأ في القيمة الافتراضية أحيانًا. فالعميل الذي يتسوق من فندق في الخارج، أو من خلف شبكة VPN تابعة لشركته تخرج من دولة غير التي يوجد فيها فعلًا، سيصادف قيمة افتراضية خاطئة عاجلًا أو آجلًا. اعرض الدولة المكتشفة دائمًا كحقل قابل للتعديل لا كقيمة ثابتة مدمجة في الطلب.

تكلفة الطلبات

النمط المعقول هو استعلام واحد لكل جلسة زائر جديدة، مخزن مؤقتًا طوال مدة تلك الجلسة. وهذا يعني طلبًا واحدًا من حصتك اليومية لكل جلسة بدلًا من كل مشاهدة صفحة، ما يُبقي حتى الموقع المزدحم ضمن حدود 2,500 طلب مجاني يوميًا المضمنة مع كل مفتاح أو المتاحة دون أي مفتاح من عنوان واحد.

تتضمن الاستجابة نفسها أيضًا الحقل timezone، لذا فإن مسار الدفع الذي يريد عملة افتراضية وعرضًا معقولًا للوقت المحلي في تأكيدات الطلبات معًا يمكنه الحصول على الاثنين من استدعاء واحد بدلًا من استعلامين منفصلين.

ضبط العملة الافتراضية بشكل صحيح من أول مشاهدة للصفحة يجنّبك تغييرًا مزعجًا في السعر لاحقًا أثناء الدفع. يسرد توثيق الاستعلام عن IPv4 كل حقل تعيده نقطة النهاية.