مصادر البيانات الخارجية

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

استخدام مصدر البيانات الخارجي لتغذية المحتوى

لعرض تغذية المحتوى، يمكنك إنشاء واجهة برمجة تطبيقات (API) توفر JSON يحتوي على العديد من عناصر تغذية المحتوى. كمثال، يمكن أن يبدو كما يلي:

{
  "feed": {
    "version": "1.0",
    "title": "sample-data-feed",
    "items": [
      {
        "title": "Meet the Full Cast",
        "link": "https://bird.com/article",
        "description": "See who's joining previously announced stars Katie Brayben and Christian Borle in the Elton John-Jake Shears-James Graham musical.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:21:00",
        "creator": "Joe Black"
      },
      {
        "title": "Stars in ASL American",
        "link": "https://bird.com/article",
        "description": "Center Theatre Group is teaming up with Deaf West Theatre to reopen the Mark Taper Forum with a new production of the Green Day musical after bringing revivals of Big River and Spring Awakening to Broadway.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:59:00",
        "creator": "Joe Black"
      }
    ]
  }
}

يمكن استخدام تغذية JSON أعلاه كـ URL لواجهة برمجة التطبيقات عند إنشاء مصدر البيانات الخارجية.

بمجرد الإنشاء، يمكنك الإشارة إليه في نموذج البريد الإلكتروني كما يلي:

1. أولاً، أضف عنصر HTML وأضف الكود أدناه لاسترداد مصدر البيانات الخارجية بالاسم أي. {% datafetch "اسم-source-data-الخارجي" %}

2. استخدم وظيفة for في السائل للحصول على جميع العناصر في تغذيتك مع المسار أي. {% for <your-item> in dataFetchResponse.<مسار-json-الخاصة بك> %}.

إذا كان لديك عنصر واحد فقط، فقد لا يكون ذلك مطلوباً

على فرض أن sample-data-feed هو اسم مصدر البيانات الخارجية وfeed.items هو المسار في تغذية JSON للحصول على العناصر، سيبدو كما يلي:

{% datafetch "sample-data-feed" %}
{% for item in dataFetchResponse.feed.items %}

• بعد إضافة ذلك، يمكنك بعد ذلك إضافة أي صورة أو نص أو عناصر زر والإشارة إلى مصدر البيانات الخارجي كما هو أدناه على فرض هيكلة sample-data-feed :

{{item.title}} - لعرض العنوان في عنصر نص

{{item.description}} - لعرض الوصف في عنصر نص

{{item.link}} - لإضافة رابط في عنصر زر

{{item.thumbnail}} - لإضافة مصدر URL الصورة في عنصر الصورة

• الآن أضف كتلة HTML أخرى لإنهاء استرداد مصدر البيانات الخارجية ووظيفة for كما هو موضح أدناه

{% endfor %}
{% enddatafetch %}

لمعاينة بريدك الإلكتروني، يمكنك التبديل إلى المعاينة ورؤية كيف تبدو تغذية المحتوى الخاصة بك

ملاحظة: إذا كان لديك تغذية ثابتة، يمكنك تحديثها هنا يدويًا عن طريق اختيار مصدر البيانات الخارجي من قائمة التحديث لمصدر البيانات الخارجية.