إعلانات النقر للانتقال إلى وجهات متعددة

يشرح هذا الدليل طريقة إنشاء إعلانات النقر للانتقال إلى وجهات متعددة ونشرها باستخدام API التسويق.

ترسل إعلانات النقر للانتقال إلى وجهات متعددة الأشخاص الذين ينقرون على الإعلانات مباشرةً إلى محادثات مع النشاط التجاري في تطبيق المراسلة أو التطبيقات (Messenger أو Instagram أو واتساب) التي من المرجح أن يقومون بالرد منها. استخدم هذه الإعلانات للوصول إلى الأشخاص على نطاق واسع وتقديم خدمة مميزة حسب حاجة الشخص.

تعني الإعلانات متعددة الوجهات أنه بإمكان الإعلان الانتقال إلى مجموعة من الوجهات: دردشة في Messenger أو دردشة في Instagram أو دردشة في واتساب.

إذا كنت ترغب في إنشاء إعلان ينتقل فقط إلى وجهة واحدة، فراجع ما يلي:

• إعلانات النقر لفتح محادثة في Messenger
• إعلانات النقر لفتح محادثة في Instagram
• إعلانات النقر لفتح محادثة في واتساب

نظرة عامة على إنشاء الإعلان

يوضح هذا المستند الخطوات المطلوب اتباعها لإعداد الدمج لإعلانات النقر للانتقال إلى وجهات متعددة. ستحتاج إلى ما يلي:

1. إنشاء حملة إعلانية
2. إنشاء مجموعة إعلانية تربط الإعلانات بالحملة الإعلانية
3. إنشاء تصميم إعلان لنوع الإعلان متعدد الوجهات الذي تريد عرضه
4. إنشاء إعلان عن طريق ربط تصميم الإعلان بالمجموعة الإعلانية

قبل البدء

يفترض هذا الدليل:

• حساب إعلاني مع Meta
• تحميل أي أصول على خوادم Meta، مثل الصور أو مقاطع الفيديو، لاستخدامها في إعلاناتك

الخطوة الأولى: إنشاء حملة إعلانية

ابدأ بإنشاء حملة إعلانية. لإجراء ذلك، يمكنك إرسال طلب POST إلى نقطة النهاية /act_<AD_ACCOUNT_ID>/campaigns حيث يكون <AD_ACCOUNT_ID> هو معرف الحساب الإعلاني من Meta. يجب أن يتضمن طلبك:

المعلمات

الطلب

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

الاستجابة

عند نجاح العملية، سيستلم التطبيق استجابة JSON تتضمن معرف الحملة الإعلانية التي تم إنشاؤها مؤخرًا.

{
  "id": "<AD_CAMPAIGN_ID>"
}

التحديث

يمكنك تحديث الحملة الإعلانية عن طريق إرسال طلب POST إلى /<AD_CAMPAIGN_ID>.

القراءة

للتحقق من إنشاء الحملة الإعلانية لإعلانات النقر للانتقال إلى وجهات متعددة، يمكنك إرسال طلب GET إلى /<AD_CAMPAIGN_ID>. راجع مرجع الحملة الإعلانية للحصول على قائمة كاملة بالمعلمات المتوفرة.

الطلب

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

الاستجابة

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

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

بمجرد توفر حملة إعلانية، يمكنك إنشاء مجموعة إعلانية. لإنشاء مجموعة إعلانية، يمكنك إرسال طلب POST إلى نقطة النهاية /act_<AD_ACCOUNT_ID>/adsets حيث يكون <AD_ACCOUNT_ID> هو معرف الحساب الإعلاني في Meta. يجب أن يتضمن طلبك:

المعلمات

تفضل بزيارة مرجع المجموعة الإعلانية للحساب الإعلاني للحصول على قائمة كاملة بالمعلمات المتوفرة.

الطلب

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

الاستجابة

عند نجاح العملية، سيستلم التطبيق استجابة JSON تتضمن معرف المجموعة الإعلانية التي تم إنشاؤها مؤخرًا.

{
  "id": "<AD_SET_ID>"
}

التحديث

يمكنك تحديث المجموعة الإعلانية عن طريق إرسال طلب POST إلى /<AD_SET_ID>.

القراءة

للتحقق من إنشاء المجموعة الإعلانية لإعلانات النقر للانتقال إلى وجهات متعددة، يمكنك إرسال طلب GET إلى /<AD_SET_ID>. راجع مرجع المجموعة الإعلانية للحصول على قائمة كاملة بالمعلمات المتوفرة.

الطلب

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

الاستجابة

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

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

يسمح لك تصميم الإعلان بإضافة الأصول إلى الإعلانات. لإنشاء تصميم إعلان، يمكنك إرسال طلب POST إلى نقطة النهاية /act_<AD_ACCOUNT_ID>/adcreatives حيث يكون <AD_ACCOUNT_ID> هو معرف الحساب الإعلاني في Meta. يجب أن يتضمن طلبك:

المعلمات

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

تفضل بزيارة مرجع تصميم الإعلان للحصول على قائمة كاملة بالمعلمات المتوفرة.

ملء الرسالة الترحيبية للصفحة

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

لمزيد من المعلومات حول أدوات التفاعل، راجع مرجع ice_breakers.

التقييدات

• يجب ألا يزيد عدد أحرف عناوين أدوات التفاعل عن 80 حرفًا.
• يجب ألا يزيد عدد أحرف استجابات أدوات التفاعل عن 300 حرف.
• يجب أن يزيد عدد أحرف نص الرسالة عن 300 حرف.

مثال

أنشئ كائن page_welcome_message لإضافة أدوات التفاعل مع رسالة ترحيبية.

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

أمثلة على إنشاء تصميم الإعلان

أضف الحقل page_welcome_message إلى تصميم الإعلان كما يلي.

الطلب

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

الاستجابة

عند نجاح العملية، سيستلم التطبيق استجابة JSON تتضمن معرف تصميم الإعلان الذي تم إنشاؤه مؤخرًا.

{
  "id": "<AD_CREATIVE_ID>"
}

إنشاء تصميمات الإعلان باستخدام محتوى Instagram

منشورات Instagram

يُرجى الرجوع إلى استخدام المنشورات كإعلانات Instagram لمزيد من التفاصيل.

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

صور Instagram

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

إنشاء تصميمات الإعلان باستخدام محتوى فيسبوك

راجع استخدام المنشورات كإعلانات Instagram: منشورات فيسبوك لمزيد من التفاصيل.

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

حيث يكون object_story_id هو معرف المنشور بتنسيق postOwnerID_postID ويكون instagram_actor_id إما معرف حساب Instagram المتصل بالصفحة أو معرف حساب Instagram المدعوم بالصفحة. راجع المزيد من التفاصيل في إعداد حسابات Instagram بالصفحات.

التحديث

يمكنك تحديث تصميم الإعلان عن طريق إرسال طلب POST إلى /<AD_CREATIVE_ID>.

القراءة

للتحقق من إنشاء تصميم إعلان للنقر للانتقال إلى وجهات متعددة، يمكنك إرسال طلب GET إلى /<AD_CREATIVE_ID>. راجع تصميم الإعلان للحصول على قائمة كاملة بالمعلمات المتوفرة.

الطلب

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

الاستجابة

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

الخطوة الرابعة: إنشاء إعلان

تسمح لك الإعلانات بربط معلومات تصميم الإعلان بالمجموعات الإعلانية. لإنشاء مجموعة إعلانية، يمكنك إرسال طلب POST إلى نقطة النهاية /act_<AD_ACCOUNT_ID>/ads حيث يكون <AD_ACCOUNT_ID> هو معرف الحساب الإعلاني في Meta. يجب أن يتضمن طلبك:

المعلمات

الطلب

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

الاستجابة

عند نجاح العملية، سيستلم التطبيق استجابة JSON تتضمن معرف الإعلان الذي تم إنشاؤه مؤخرًا.

{
  "id": "<AD_ID>"
}

زر الدعوة لاتخاذ إجراء

يمكنك أيضًا تعيين زر دعوة لاتخاذ إجراء عند إنشاء الإعلان.

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

راجع وثائق مواصفات قائمة بيانات الأصل لمزيد من المعلومات.

التحديث

يمكنك تحديثإعلان عن طريق إرسال طلب POST إلى /<AD_ID>.

القراءة

للتحقق من إنشاء إعلان النقر للانتقال إلى وجهات متعددة، يمكنك إرسال طلب GET إلى /<AD_ID>. راجع مرجع الإعلان للحصول على قائمة كاملة بالمعلمات المتوفرة.

الطلب

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

الاستجابة

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}