أنشئ إعلان Meta مع التركيز على مواضع ريلز المتوفرة وتعرف على أفضل الممارسات المتعلقة بعمليات تشغيل الإعلانات لدينا.
إذا كنت لا تلبي هذه المتطلبات الأساسية، فيرجى الرجوع إلى وثائق المطوّر.
توفر Meta بيئة اختبارية، والتي لا تعرض إعلانات فعليًا، ولكنها تسمح لك بما يلي:
اقرأ أفضل ممارسات الاختبار.
رمز الوصول هو سلسلة مشفرة تحدد مستخدمًا أو تطبيقًا أو صفحة ويمكن استخدامها بواسطة التطبيق لإجراء استدعاءات graph API. يمكنك عرض موعد انتهاء صلاحيته ومعرفة التطبيق الذي أنشأه. يجب أن تتضمن استدعاءات API التسويق التي تتم في تطبيقات Meta رمز وصول.
الحصول على رمز وصول مع الأذونات الضرورية:
ads_management
: إجراء تغييرات في الحسابات الإعلانية المحددة
ads_read
: قراءة بيانات الإعلانات
read_insights
: قراءة رؤى الأداء
استخدم رموز وصول النظام لأن مدة صلاحيتها أطول.
للوصول إلى نقاط نهاية API التسويق، يتعين عليك إنشاء تطبيق أعمال. تخضع هذه التطبيقات إلى طبقة إضافية من طبقات تصريح Graph API تُعرف باسم مستويات الوصول. وأثناء عملية مراجعة التطبيقات، يجب أيضًا على تطبيقك طلب أذونات وميزات محددة. يجب إكمال عملية التحقق من النشاط التجاري إذا كان سيتم استخدام التطبيق بواسطة مستخدمي تطبيق ليس لديهم دور في التطبيق ذاته أو دور في النشاط التجاري الذي طالب بالتطبيق.
إذا كان تطبيقك يدير الحسابات الإعلانية للآخرين، فأنت بحاجة إلى:
ads_read
و/أو
ads_management
احصل على حسابات الإعلانات الخاصة بالمعلنين لديك واسمح لهم باختيار الحساب الذي سيتم إنشاء الإعلانات فيه.
من خلال API إدارة الأعمال التي نوفرها، يمكنك رؤية كل الحسابات الإعلانية التي يمكن للأنشطة التجارية لدى المعلنين الوصول إليها. يؤدي هذا إلى إرجاع جميع الحسابات الإعلانية المملوكة لنشاط تجاري ما. لاحظ أنك ستحتاج إلى إذن business_management
على مستوى التطبيق والمستخدم. ارجع إلى واجهات API إدارة أصول الأنشطة التجارية.
curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0
/<BUSINESS_ID>/owned_ad_accounts"
تمثل الحملة الإعلانية أعلى مستوى في البنية التنظيمية داخل الحساب الإعلاني، ويجب أن تمثل هدفًا واحدًا للمعلن. تحتوي هذه الكائنات على هدفك الإعلاني ومجموعة إعلانية واحدة أو أكثر. يساعدك هذا في تحسين النتائج وقياسها لكل هدف إعلاني. تعرف على المزيد حول إنشاء الحملة الإعلانية وقراءة بياناتها وتحديثها وحذفها هنا.
curl -X POST \
-F 'name="My campaign"' \
-F 'objective="OUTCOME_TRAFFIC"' \
-F 'status="PAUSED"' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
لتمكين المعلنين من الوصول إلى مجموعات معينة، حدد هذه المعلمات في طلبات API التي تجريها:
ومن ثم سيتم الوصول إلى العملاء المحتملين الذين من المرجح أن يكونوا مهتمين بمنتجاتك أو خدماتك.
curl -X POST \
-F 'access_token=YOUR_ACCESS_TOKEN' \
-F 'name=My Custom Audience' \
-F 'subtype=CUSTOM' \
-F 'description=People who live in New York, aged 25-40, interested in technology' \
-F 'customer_file_source=USER_PROVIDED_ONLY' \
-F 'targeting_spec={
"geo_locations": {
"countries": ["US"],
"regions": [{"key": "4081"}] # New York region key
},
"age_min": 25,
"age_max": 40,
"interests": [{"id": "6003139266461", "name": "Technology"}]
}' \
https://graph.facebook.com/v21.0
/act_YOUR_AD_ACCOUNT_ID/customaudiences
يمكن أن تحتوي المجموعات الإعلانية على إعلان واحد أو أكثر. يجب أن يتوفر لدى الإعلانات الموجودة ضمن المجموعة الإعلانية خصائص الاستهداف والميزانية والفوترة وهدف التحسين والمدة نفسها.
يمكنك تعيين الميزانية والجدول الزمني والاستهداف واستراتيجية عرض الأسعار وخيارات الموضع. تسمح المجموعات الإعلانية بالتحكم في كيفية عرض الإعلانات ومكان عرضها لشرائح معينة من الجمهور، وتحسين الأداء، وتحقيق أهداف التسويق.
المعلمات الرئيسية:
تتوفر تفاصيل أكثر شمولاً هنا.
يمكنك اختيار موضع يدوي يتضمن إعلانات ريلز على Instagram وفيسبوك، أو تحديد المواضع تلقائيًا بشكل افتراضي. إذا لم تحدد أي شيء لحقل موضع معين، فسيتم تضمين كل المواضع الافتراضية المحتملة لهذا الحقل.
curl -X POST \
-F 'access_token=YOUR_ACCESS_TOKEN' \
-F 'name=Reels Ad Set' \
-F 'campaign_id=YOUR_CAMPAIGN_ID' \
-F 'daily_budget=5000' \
-F 'billing_event=IMPRESSIONS' \
-F 'optimization_goal=REACH' \
-F 'start_time=2024-07-10T10:00:00-0700' \
-F 'end_time=2024-07-20T10:00:00-0700' \
-F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
-F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
-F 'status=PAUSED' \
-F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
-F 'publisher_platforms=["instagram"]' \
-F 'instagram_positions=["reels"]' \
https://graph.facebook.com/v21.0
/act_YOUR_AD_ACCOUNT_ID/adsets
publisher_platforms | facebook_position أو instagram position | الأهداف المتوافقة | optimization_goal |
---|---|---|---|
instagram |
| OUTCOME_APP_PROMOTION |
|
instagram |
| OUTCOME_AWARENESS |
|
instagram |
| OUTCOME_LEADS |
|
instagram |
| OUTCOME_TRAFFIC |
|
instagram |
| OUTCOME_ENGAGEMENT |
|
instagram |
|
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
مزيج optimization_goal + الهدف المتوافق
| هل مؤهل لاستخدام ريلز فيسبوك؟ | هل مؤهل لاستخدام ريلز IG؟ |
---|---|---|
| ✅ | ❌ |
| ❌ | ✅ |
| ✅ | ❌ |
| ✅ | ❌ |
| ✅ | ❌ |
| ❌ | ✅ |
| ✅ | ❌ |
| ✅ | ❌ |
| ✅ | ❌ |
تصميمات الإعلانات هي المكونات المرئية والنصية للإعلانات، والتي تدعم تنسيقات الإعلانات التالية:
قم بأتمتة عناصر التصميم وتحسين الأداء باستخدام ميزة معالجة التصميم لدينا.
يمكن للمستخدمين توفير أصل جديد أو إعادة استخدام مقطع ريلز موجود من حسابهم على Instagram كتصميم إعلان.
يمكنك إنشاء إعلانات من مقاطع ريلز الحالية أو العادية على Instagram أو فيسبوك والتي تكون مؤهلة للترويج لها، بشرط أن تكون:
لإعادة استخدام مقطع ريلز عادي على Instagram كتصميم إعلان لحملة إعلانية جديدة:
احصل على معرف حساب Instagram للأعمال، والذي يجب أن يكون مرتبطًا بصفحة فيسبوك
GET/{ad_account_id}/connected_instagram_accounts
أوGET/{business_id}/instagram_business_accounts
اعثر على مقطع ريلز الذي تريد الترويج له
GET/{ig-business-account-user-id}/media
توفير تصميم الإعلان
instagram_actor_id
في مواصفات التصميم، يمكنك تعيين instagram_user_id
كمعرف مستخدم Instagramsource_instagram_media_id
كمعرف الوسائطcall_to_action
للترويجيمكنك استخدام boost_eligibility_info
كطريقة سهلة وفعالة لتحديد ما إذا كانت الوسائط مؤهلة للترويج كإعلان واستخدام boost_ads_list
لتتبع المعلومات المتعلقة بإعلان Instagram السابق الذي تم ترويجه.
curl -i -X POST \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>
يمكنك أتمتة عملية إنشاء عناصر إعلانية متنوعة ومشجعة على التفاعل، مثل: الصور ومقاطع الفيديو والنصوص. تساعد هذه الأدوات المدعومة بالذكاء الاصطناعي على تحسين أداء الإعلانات من خلال تخصيص المحتوى وفقًا لتفضيلات الجمهور وتعزيز تنوع التصميمات. سيؤدي إنشاء الإعلانات إلى زيادة التفاعل وتحسين الحملات الإعلانية.
يمكنك معاينة الإعلانات بتنسيقات ريلز من فيسبوك وInstagram الموضحة في الجدول أدناه باستخدام:
منصة النشر | تنسيق الإعلان |
---|---|
فيسبوك |
|
|
curl -X POST \
'https://graph.facebook.com/v21.0
/act_{ad_account_id}/adpreviews' \
-F 'access_token={your_access_token}' \
-F 'creative={
"object_story_spec": {
"instagram_actor_id": "{instagram_actor_id}",
"video_data": {
"video_id": "{video_id}",
"title": "Check out our new product!",
"description": "Exciting new features and benefits.",
"call_to_action": {
"type": "LEARN_MORE",
"value": {
"link": "https://www.example.com/product"
}
}
}
}
}' \
-F 'ad_format=INSTAGRAM_REELS'
لحجز إعلان باستخدام API التسويق، قم بإنشاء كائن مجموعة إعلانية وربط كائن المجموعة الإعلانية لديك بتصميم الإعلان. استخدم /act_{ad_account_id}/ads
لإرسال كائن الإعلان، والتحقق من الاستجابة لتأكيد نجاح الحجز. تؤدي هذه الخطوة إلى الانتهاء من إعداد الإعلان، ما يجعله جاهزًا للعرض استنادًا إلى التكوينات المتوفرة.
curl -X POST \
-F 'name="My Ad"' \
-F 'adset_id="<AD_SET_ID>"' \
-F 'creative={
"creative_id": "<CREATIVE_ID>"
}' \
-F 'status="PAUSED"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
استخدم API الرؤى للحصول على أدوات القياس من الحسابات الإعلانية وإرسالها إلى الإعلانات:
act_<AD_ACCOUNT_ID>/insights
<CAMPAIGN_ID>/insights
<ADSET_ID>/insights
<AD_ID>/insights
عند تشغيل حملة إعلانية على Instagram وفيسبوك، أضف breakdowns=publisher_platform
لعرض إحصائيات مواضع فيسبوك وInstagram بشكل منفصل، كما هو موضح في عينة الاستدعاء أدناه. عند تقسيم الرؤى حسب مستوى الموضع، سيكون من الممكن معرفة مستوى أداء الإعلانات عبر موضع ريلز من Instagram وفيسبوك.
curl -X GET \
'https://graph.facebook.com/v21.0
/{ad_account_id}/insights' \
-F 'access_token={your_access_token}' \
-F 'level=campaign' \
-F 'fields=campaign_name,impressions,clicks,spend' \
-F 'breakdowns=publisher_platform,platform_position' \
-F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
-F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'
OUTCOME_APP_PROMOTION
OUTCOME_AWARENESS
OUTCOME_ENGAGEMENT
OUTCOME_LEADS
OUTCOME_SALES
OUTCOME_TRAFFIC
تحتوي API التسويق على منطق تقييد معدلات الاستدعاء الخاص بها ويتم استثناؤها من كل تقييدات معدلات الاستدعاء في Graph API. الميزة التي تؤثر على حصة تقييد معدلات استدعاء API التسويق هي الوصول القياسي لإدارة الإعلانات. بشكل افتراضي، تحصل على إمكانية الوصول القياسي عند إضافة منتج API التسويق إلى لوحة معلومات التطبيق، ما يوفر لك إمكانية الوصول إلى API التسويق. لزيادة حصة تقييد معدلات الاستدعاء، قم بالترقية إلى الوصول المتقدم.
تساهم إعلانات ريلز في تحويل الاهتمام إلى إجراء، ما يؤدي إلى تحسين النتائج. عند إنشائها بالطريقة الصحيحة، فإنها تكون أكثر فعالية.
1. قم بإنشاء فيديو بنسبة عرض إلى ارتفاع 9:16 لجعل الفيديو الخاص بك جذابًا: مقاطع ريلز هي تنسيق فيديو غامر معروض على شاشة كاملة. لمساعدة تصميمك على أن يبدو ملائمًا في هذه الميزة، حاول البدء بالفيديو مع تغيير حجمه إلى 9:16.
2. أنشئ مقاطع ملائمة بحيث تكون رسالتك واضحة: اجعل المقاطع ضمن النطاق المناسب حتى لا يتم حجب تراكبات الملصقات النصية أو أزرار الدعوة إلى اتخاذ إجراء أو الرسائل الرئيسية بواسطة واجهة مستخدم ريلز. اترك 35% من الجزء السفلي في التصميم بتنسيق 9:16 خاليًا من النصوص والشعارات والعناصر الأساسية الأخرى.
3. استخدم الصوت لجعل الفيديو الذي توفره ممتعًا: يُعد الصوت، سواء كان موسيقى أو تعليقًا صوتيًا أو مؤثرات صوتية، عنصرًا رئيسيًا لزيادة التفاعل وجعل المقطع ترفيهيًا بالنسبة لمقاطع ريلز.