‏API التسويق‏

بدء استخدام ميزات الذكاء الاصطناعي التوليدي في API التسويق

دعم API لميزات الذكاء الاصطناعي التوليدي

المعلنون مسؤولون عن معاينة تصميم الإعلان الذي يعرض تصميمات تم إنشاؤها بواسطة الذكاء الاصطناعي قبل نشر الإعلانات. راجع تعليمات معاينة التكوين.

لا تقدم Meta أي ضمانات بشأن مدى اكتمال عمليات إنشاء النصوص المقترحة أو الخلفيات التي تم إنشاؤها أو الصور الموسعة وموثوقيتها ودقتها. إذا كنت تستخدم API التسويق للوصول إلى ميزات الذكاء الاصطناعي التوليدي الموضحة أدناه، فستنطبق شروط تصميم إعلان الذكاء الاصطناعي التوليدي بالإضافة إلى شروط منصة Meta.

يوضح هذا المستند كيفية استخدام ميزات الذكاء الاصطناعي التوليدي التالية: إنشاء النصوص وتوسيع الصورة وإنشاء الخلفية للإعلانات.

قبل البدء

يجب اتباع هذه الخطوات لإعداد الحملات الإعلانية من خلال ميزات الذكاء الاصطناعي التوليدي من Meta.

  1. إنشاء حملة إعلانية
  2. إنشاء مجموعة إعلانية
  3. إنشاء إعلان أو تصميم مستقل
  4. معاينة التصميم
  5. تمكين الإعلان

إنشاء النصوص

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

الخطوة الأولى: الاشتراك لاستخدام "إنشاء النصوص" عند إنشاء الإعلان

يمكنك إنشاء إعلان من خلال نقطة النهاية /ads أو إنشاء تصميم مستقل من خلال نقطة النهاية /adcreatives. ينطبق الاشتراك في الميزة فقط على الإعلان أو تصميم الإعلان الذي تم إنشاؤه في الطلب الحالي. في أي من النهجين، اشترك لاستخدام ميزة "إنشاء النصوص" عن طريق:

  1. توفير نص رئيسي في الحقل message في object_story_spec
  2. الاشتراك لاستخدام text_generation

راجع الأمثلة على الطلبات أدناه:

الاشتراك عبر نقطة النهاية /adcreatives

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      ...
      "message": "<PRIMARY_TEXT_HERE>",
  }' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "text_generation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

أو يمكنك إنشاء كائن إعلان من خلال نقطة النهاية act_<AD_ACCOUNT_ID>/ads:

الاشتراك عبر نقطة النهاية /ads

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Text Gen Adgroup",
    "object_story_spec": {
      ...
      "message": "<PRIMARY_TEXT_HERE>",
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "text_generation": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

الخطوة الثانية: معاينة "إنشاء النصوص"

عند إنشاء الإعلان مع الاشتراك لاستخدام text_generation، سيتم تطبيق الميزة فقط على الإعلان الحالي وسيتم إدخال النصوص الرئيسية التي تم إنشاؤها في مواصفات التصميم. إذا تم الاشتراك في الميزة عبر نقطة النهاية /ads، فسيتم تعيين الحقل status في adgroup على PAUSED بشكل افتراضي (راجع الوثائق). يمكنك مراجعة الاقتراحات التي تم إنشاؤها قبل تعيين حالة الإعلان يدويًا على ACTIVE حتى يمكن عرضه.

يمكن معاينة مواصفات التصميم التي تحتوي على الاقتراحات التي تم إنشاؤها عن طريق قراءة asset_feed_spec من خلال معرف التصميم أو معرف الإعلان. راجع المثال على الطلب والاستجابة أدناه:

ابدأ بالاستعلام عن asset_feed_spec لتصميم الإعلان المستقل الذي تم إنشاؤه في الخطوة الأولى.

الطلب

// request from creative
curl -X GET -G \
  -d 'fields=asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<CREATIVE_ID>
  
// request from ad
curl -X GET -G \
  -d 'fields=creative{asset_feed_spec,status}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>

الاستجابة

{
  "asset_feed_spec": {
    "bodies": [
      {
        "text": "Buy some cool LED TV at cheap price"
      },
      {
        "text": "Get your dream LED TV at an unbeatable price! Buy now and save big!"
      },
      {
        "text": "Get the best LED TV deals! 📺 Save money and upgrade your entertainment."
      },
      {
        "text": "Get an LED TV at a low cost! Cheap, high-quality options are available."
      },
      {
        "text": "Get LED TVs at affordable prices  ✨  !"
      }
    ],
    "optimization_type": "DEGREES_OF_FREEDOM"
  },
  "id": "<CREATIVE_ID>"
}

بمجرد أن تصبح الاقتراحات مقبولة للنشر بعد مراجعتها، يُرجى الانتقال إلى الخطوة الثالثة لتعيين الإعلان على ACTIVE. إذا كان أي من الاقتراحات التي تم إنشاؤها غير مقبول، فيُرجى إنشاء إعلان أو تصميم إعلان جديد بدون الاشتراك في "إنشاء النصوص".

إنشاء تصميم إعلان بدون الاشتراك في "إنشاء النصوص"

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      ...
      "message": "<PRIMARY_TEXT_HERE>",
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

الخطوة الثالثة: تعيين حالة adgroup على ACTIVE

بعد التحقق من اقتراحات النصوص التي تم إنشاؤها، يمكنك تعيين status للإعلان على ACTIVE. يجب إجراء هذه الخطوة في الحالتين:

  1. عند اشتراك الإعلان في الميزة عبر نقطة النهاية /ads
  2. إذا كان الإعلان هو أول إعلان يستخدم تصميم الإعلان الموجود من خلال الاشتراك في "إنشاء النصوص".

الطلب

curl \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>

توسيع الصورة

يمكنك توسيع الصورة تلقائيًا لتناسب المزيد من المواضع.

الخطوة الأولى: إنشاء إعلان أو تصميم مشترك في توسيع الصورة

يمكنك إنشاء إعلان من خلال نقطة النهاية /ads أو إنشاء تصميم مستقل من خلال نقطة النهاية /adcreatives. في أي من النهجين، اشترك لاستخدام ميزة "توسيع الصورة" في مواصفات التصميم (راجع الأمثلة أدناه).

الطلب

// creative example
curl -X POST \
  -F 'name=Image Expansion Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_uncrop": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Image Expansion Adgroup",
    "object_story_spec": {
      ...
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_uncrop": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

الخطوة الثانية: معاينة "توسيع الصورة"

هذه الميزة مدعومة لمواضع INSTAGRAM_STANDARD وFACEBOOK_REELS_MOBILE وINSTAGRAM_REELS وMOBILE_FEED_STANDARD وINSTGRAM_STORY. لإلقاء نظرة على هذه المواضع، يمكنك إرسال طلب GET إلى نقطة النهاية /<AD_ID>/previews.

إذا كانت أي من الصور التي تم إنشاؤها غبر مقبولة، فيُرجى إعادة إنشاء الإعلان أو تصميم الإعلان بدون الاشتراك في "توسيع الصورة":

  • يمكنك تعيين creative_feature كـ image_uncrop.
  • أعد طلب المعاينة إذا تم عرض status كـ pending.

ملاحظة: إذا لم يتم عرض العقدة transformation_spec، فهذا يعني أن تصميم الإعلان غير مؤهل لتوسيع الصورة.

الطلب

INSTAGRAM_STANDARD

curl -X GET -G \
  -d 'ad_format=INSTAGRAM_STANDARD' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

الاستجابة

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_uncrop": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible"
          }
        ]
      }
    }
  ]
}

(اختياري) معاينة مباشرة بدون إنشاء الإعلان

يمكنك أيضًا طلب معاينة باستخدام نقطة النهاية act_<AD_ACCOUNT_ID>/generatepreviews بدون إنشاء إعلان بالفعل.

الطلب

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'creative={
        "object_story_spec": {
        "page_id": "<PAGE_ID>",
        ...
        "link_data": {
           "image_hash": "<IMAGE_HASH>",
           "link": "<WEBSITE_LINK>"
        }
      }
  }'
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/generatepreviews

إنشاء الخلفية

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

الخطوة الأولى: إنشاء إعلان أو تصميم إعلان مشترك في إنشاء الخلفية

لا يعمل إنشاء الخلفية حاليًا إلا مع إعلانات المنتجات الديناميكية أو إعلانات كتالوج Advantage+ في موجز الهواتف المحمولة.

يمكنك إنشاء إعلان من خلال نقطة النهاية /ads أو إنشاء تصميم مستقل من خلال نقطة النهاية /adcreatives. في أي من النهجين، اشترك لاستخدام ميزة إنشاء الخلفية في مواصفات التصميم (راجع الأمثلة أدناه).

الطلب

// creative example
  curl -X POST \
  -F 'name=Background Gen Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_background_gen": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Background Gen Adgroup",
    "object_story_spec": {
      ...
    },
    "product_set_id": "<PRODUCT_SET_ID>",
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_background_gen": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

الخطوة الثانية: معاينة إنشاء الخلفية

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

إذا كانت أي من الخلفيات التي تم إنشاؤها غير مقبولة، فيُرجى إعادة إنشاء الإعلان أو تصميم الإعلان بدون الاشتراك في "إنشاء الخلفية".

  • لا يتم دعم المعاينة حاليًا إلا للموضع MOBILE_FEED_STANDARD
  • تعيين creative_feature كـ image_background_gen
  • إذا لم تكن المعاينة المباشرة لمنتجات الكتالوج جاهزة، فيتم عرض معاينة جاهزة مع تعيين status على PENDING

الطلب

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

الاستجابة

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

(اختياري) معاينة مباشرة بدون إنشاء الإعلان

يمكنك أيضًا طلب معاينة لتصميم الإعلان باستخدام نقطة النهاية /<AD_CREATIVE_ID>/previews بدون إنشاء إعلان بالفعل.

الطلب

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>/generatepreviews

الاستجابة

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

معرفة المزيد