دليل الإعداد

تكاملات المواقع الإلكترونية

كيف تضع إعلانات RentMerchant وزر دفع الإيجار وقائمة السكان ورموز QR على موقعك الحالي. ينتهي معظم الملاك في نحو عشر دقائق.

1. قبل أن تبدأ

2. اعثر على الكود الخاص بك

  1. سجّل الدخول على app.rentmerchant.com.
  2. افتح الإعدادات، ثم علامة التبويب التكاملات.
  3. انقر على أي خيار لفتحه، ثم استخدم زر نسخ الكود الخاص به. يحتوي الكود بالفعل على اسم حسابك، لذا الصقه تمامًا كما نسخته.

في الأمثلة الواردة في هذه الصفحة، يُستخدم your-name بدلًا من اسم حسابك. انسخ دائمًا الكود الحقيقي من صفحة التكاملات بدلًا من إعادة كتابة هذه الأمثلة.

3. أضف إعلانات عقاراتك للإيجار

تعرض الأداة المنازل التي تُدرجها. لا يُعرض أي شيء حتى تفعّله، منزلًا منزلًا.

  1. افتح الإعلانات (ضمن التأجير). ستجد كل وحداتك هناك. العقار الذي لا يضم وحدات يعرض زر إنشاء إعلان.
  2. انقر على تعديل في أي منزل واملأ عدد غرف النوم والحمامات والمساحة بالقدم المربع والإيجار الشهري ومبلغ التأمين وتاريخ الإتاحة (اتركه فارغًا ليظهر "متاح الآن") والحيوانات الأليفة والوصف.
  3. ارفع حتى 12 صورة. الصورة الأولى هي الغلاف؛ استخدم الأسهم لإعادة الترتيب. تُزال بيانات الموقع الجغرافي من كل صورة تلقائيًا.
  4. حدّد إدراج هذا المنزل للعموم وانقر على حفظ الإعلان.

عند تأجير منزل، انقر على إلغاء الإدراج في صفحة الإعلانات. يختفي من موقعك خلال خمس دقائق، دون أي كود لتغييره.

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

4. أداة الإعلانات

تعرض المنازل المدرجة كبطاقات مع صورة والإيجار وعدد غرف النوم والحمامات والإتاحة. ينقر الزوار على أي بطاقة لفتح صفحة إعلانها.

الخيار A: كود الأداة (موصى به)

تتسع لعرض صفحتك وتكبر لتناسب إعلاناتك. الصقها حيث يجب أن تظهر الإعلانات:

<div data-rentmerchant-listings="your-name"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

الخيار B: iframe

لأدوات إنشاء المواقع التي لا تسمح بالسكريبتات. إنها مربع بارتفاع ثابت قابل للتمرير:

<iframe src="https://app.rentmerchant.com/embed/listings/your-name" title="Available rentals"
        loading="lazy" style="width:100%;height:900px;border:0"></iframe>

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

5. زر السكان العائم

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

<script src="https://app.rentmerchant.com/embed/v1/resident-button.js" data-rentmerchant-site="your-name" async></script>

إذا لم تكن في أداة الإنشاء منطقة لكود الموقع بالكامل، فالصقه في كل صفحة تريد ظهور الزر فيها.

6. الأزرار والروابط

الأزرار: في قسم الأزرار ضمن التكاملات، حدّد الأزرار التي تريدها، واختر لونًا، وتحقق من المعاينة، وانسخ الكود. الأزرار روابط عادية منسّقة، لذا تعمل في أي أداة إنشاء مواقع تقبل HTML، بما في ذلك النشرات البريدية.

الروابط (كل الخطط): انسخ أي رابط إلى قائمة التنقل في موقعك، أو التذييل، أو ملفك على وسائل التواصل الاجتماعي، أو توقيع بريدك الإلكتروني. في معظم أدوات الإنشاء: افتح محرر القائمة، وأضف عنصر رابط، والصق العنوان.

7. رموز QR

في قسم رموز QR، انقر على تنزيل PNG أسفل الرمز الذي تريده. اطبعه على لافتة "للإيجار" (استخدم العقارات المتاحة للإيجار أو قدّم الآن)، أو على إعلان في غرفة الغسيل (دفع الإيجار أو الصيانة)، أو في حزمة الانتقال. اطبعه بعرض 2.5 سم (1 بوصة) على الأقل وامسحه بهاتفك قبل طباعة دفعة كاملة.

8. خطوة بخطوة لأداة إنشاء موقعك

تغيّر أدوات إنشاء المواقع قوائمها من حين لآخر. إذا لم تتطابق التسمية أدناه تمامًا، فابحث عن العنصر المسمى HTML أو Embed أو Code.

Wix

  1. الإعلانات أو الأزرار: في المحرر، انقر على Add Elements (+)، ثم Embed Code، ثم Embed HTML. اختر الرمز، والصق الكود، وانقر على Update. اسحب المربع إلى الحجم الذي تريده.
  2. زر السكان: انتقل إلى الإعدادات في موقعك، ثم Custom Code (ضمن الإعدادات المتقدمة)، وانقر على Add Custom Code، والصق الكود، واختر All pages وBody, end. لا يتيح Wix الكود المخصص إلا للمواقع المرتبطة بنطاق وذات خطة مدفوعة.
  3. انشر موقعك.

Squarespace

  1. الإعلانات أو الأزرار: عدّل الصفحة، وانقر على موضع الإدراج، واختر الرمز، والصق الكود، وتأكد من إيقاف Display Source.
  2. زر السكان: افتح الإعدادات، ثم Developer Tools (أو Advanced)، ثم Code Injection، والصق الكود في Footer.
  3. تتطلب السكريبتات في كتل Code وCode Injection خطة Squarespace تتضمن الكود المخصص. إذا لم يعمل كود الأداة، فاستخدم خيار الـ iframe بدلًا من ذلك.

WordPress

  1. الإعلانات أو الأزرار: عدّل الصفحة، وانقر على +، وأضف كتلة Custom HTML، والصق الكود، ثم حدّث الصفحة.
  2. زر السكان: استخدم إعداد كود التذييل في القالب إن وُجد، أو إضافة لكود الرأس والتذييل (مثل WPCode)، والصق الكود في التذييل.
  3. على WordPress.com (الخدمة المستضافة)، لا تعمل السكريبتات إلا في الخطط التي تسمح بالإضافات والكود المخصص. في الخطط الأخرى، استخدم خيار الـ iframe والأزرار.

GoDaddy Websites + Marketing

  1. عدّل موقعك، وانقر على Add Section، وابحث عن HTML، وأضفه.
  2. الصق الكود في مربع الكود المخصص في القسم وانقر على Done. خيار الـ iframe هو الأكثر موثوقية هنا.
  3. بالنسبة لزر السكان، ابحث ضمن الإعدادات في موقعك عن كود الموقع بالكامل. إذا لم تتضمنه خطتك، فأضف الأزرار إلى صفحاتك بدلًا من ذلك.

Weebly (Square Online classic)

  1. الإعلانات أو الأزرار: اسحب عنصر Embed Code إلى الصفحة، وانقر عليه، واختر Edit Custom HTML، والصق الكود.
  2. زر السكان: الإعدادات، ثم SEO، ثم الصق الكود في Footer Code.

Webflow

  1. الإعلانات أو الأزرار: اسحب عنصر Code Embed إلى الصفحة والصق الكود.
  2. زر السكان: Site settings، ثم Custom code، والصق الكود في Footer code. ثم انشر.
  3. تتطلب Webflow خطة موقع مدفوعة للكود المخصص.

موقع مخصص أو مبني يدويًا

الصق كود الأداة حيث يجب أن تظهر الإعلانات، وزر السكان قبل وسم </body> الختامي مباشرةً. أو استخدم موجزات JSON لبناء تصميمك الخاص.

9. مرجع الخيارات

السمةيعمل معما الذي تفعله
data-limit="3"أداة الإعلاناتاعرض أول بضعة منازل فقط (الأقرب إتاحةً أولًا).
data-accent="#0f766e"أداة الإعلانات، وزر السكانلونك الخاص، كرمز سداسي عشري من ست خانات. اللون الافتراضي هو النيلي الخاص بـ RentMerchant.
data-position="left"زر السكانضع الزر في الزاوية السفلية اليسرى بدلًا من اليمنى.
data-label="Tenants"زر السكانغيّر نص الزر (حتى 24 حرفًا).
?accent=0f766eعنوان الـ iframeلونك لنسخة الـ iframe، يُضاف إلى نهاية عنوانها.

مثال، أداة تعرض ثلاثة منازل باللون الأزرق المخضر:

<div data-rentmerchant-listings="your-name" data-limit="3" data-accent="#0f766e"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

10. لمطوري المواقع: موجزات JSON

موجزان عامان للقراءة فقط يحملان البيانات نفسها التي تعرضها الأدوات. لا حاجة إلى مفتاح، والطلبات عبر النطاقات المختلفة مسموحة، والاستجابات مخزّنة مؤقتًا لمدة خمس دقائق.

GET https://app.rentmerchant.com/r/your-name/listings.json
GET https://app.rentmerchant.com/r/your-name/links.json

يتضمن كل عنصر في listings:

{
  "id": 476,
  "title": "Capitol Flats · Unit 102",
  "city": "Columbus, OH",
  "rent": "$1,950/mo",          "rent_amount": 1950,
  "deposit": "$1,950",
  "facts": ["2 bed", "1 bath", "880 sq ft"],
  "bedrooms": 2, "bathrooms": 1, "square_feet": 880,
  "available": "Available now", "available_on": null,
  "pets": "Cats OK",
  "description": "Bright corner two bedroom...",
  "photos": [{ "url": "...", "thumb": "...", "w": 2000, "h": 1500 }],
  "url": "https://app.rentmerchant.com/r/your-name/listings/476",
  "apply_url": "https://app.rentmerchant.com/apply/...?unit=476"
}

اعرض النص تمامًا كما هو مُقدَّم، واربط بـ url وapply_url بدلًا من إنشاء نموذج طلب خاص بك. عنوان الشارع الكامل موجود في صفحة الإعلان فقط، لا في الموجز. يُرجع links.json اسمك ولون التمييز وروابط السكان (key وlabel وurl).

11. حل المشكلات

منطقة الأداة فارغة.
قد تكون أداة الإنشاء تحذف السكريبتات؛ استخدم خيار الـ iframe. وتحقق أيضًا من أن حسابك على Pro وأن بريدك الإلكتروني مؤكَّد، وأن الكود لُصق كاملًا.
تظهر رسالة بأنه لا توجد منازل متاحة.
افتح الإعلانات في حسابك وتأكد من تحديد منزل واحد على الأقل كمعروض. تظهر التغييرات خلال خمس دقائق.
تبدو جيدة في المحرر ولكن ليس في موقعي المنشور.
معظم أدوات إنشاء المواقع لا تشغّل السكريبتات إلا في الموقع المنشور، لا في معاينة المحرر. انشر الموقع، ثم تحقق من العنوان المباشر.
الـ iframe مقطوع أو يظهر فيه شريط تمرير.
استخدم النسخة ذات الحجم التلقائي، أو ارفع قيمة height في كود الـ iframe.
زر السكان لا يظهر.
يجب أن يكون في منطقة كود الموقع بالكامل أو في الصفحة نفسها، ولا يظهر إلا في الموقع المنشور. إذا لم يكن لدى حسابك روابط لعرضها، فإنه يبقى مخفيًا.
شيء آخر؟
افتح الدعم في حسابك وأخبرنا بعنوان موقعك وأداة الإنشاء التي تستخدمها. سنلقي نظرة.

12. الأمان والخصوصية

مستعد لربط موقعك؟

سجّل الدخول وافتح التكاملات، أو شاهد أداة الإعلانات وهي تعمل أولًا.