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

يشرح هذا الدليل طريقة إنشاء إعلانات النقر للانتقال إلى وجهات متعددة ونشرها باستخدام 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/v19.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/v19.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/v19.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/v19.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.

مثال

إضافة عناصر لتشجيع التفاعل عن طريق تضمين رسالة ترحيبية.

"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": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

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

الطلب

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/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

الاستجابة

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

{
  "id": "<AD_CREATIVE_ID>"
}

التحديث

يمكنك تحديث تصميم الإعلان عن طريق إرسال طلب 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/v19.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/v19.0/act_<AD_ACCOUNT_ID>/ads

الاستجابة

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

{
  "id": "<AD_ID>"
}

التحديث

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

القراءة

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

الطلب

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

الاستجابة

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