شرح Partnership Ads في ميتا: الاذونات اللي بتحدد شكل الشغل

سؤال بييجي لي كتير من ناس بتشتغل مع كرييتورز: «عملنا تعاون مع حد، البوست نزل وجاب تفاعل حقيقي، ازاي اشيله ورا ميزانية؟». والناس بتجاوب عليه بكلمة «Whitelisting» كأنها حاجة واحدة بسيطة، وهي مش كده.

الصيغة اللي ميتا موثقاها اسمها Partnership Ads، والتوثيق بيقول انها بتخليك «run Facebook and Instagram ads from a creator or other partner's handle»، يعني الاعلان بيطلع من هاندل الكرييتور مش من هاندلك. والجزء اللي بيحدد شكل الشغل كله هو الاذونات، وفيها نظامين مختلفين خالص، وكل واحد بيسمح بحاجة التاني مش بيسمح بيها.

انا هفصل النظامين من التوثيق نفسه، وفي الاخر هقول لك الارقام اللي بتتداول عن الصيغة دي وليه مقدرتش اوثقها.

النظامين: اذن على مستوى البوست، واذن على مستوى الحساب

ده الفرق اللي لازم تفهمه قبل اي حاجة تانية، لان هو اللي بيحدد هل انت محتاج بوست موجود اصلا ولا لأ.

اذن على مستوى البوست (Post-Level). التوثيق بيقول انه بيطبق لما مفيش اذن على مستوى الحساب بينك وبين الشريك، وان «A creator must give permission to a brand to use individual posts as partnership ads». يعني الكرييتور بيوافق على بوست بعينه، واحد واحد.

اذن على مستوى الحساب (Account-Level). هنا انت بتطلب الاذن من الكرييتور، وهو بيقبل من تطبيق انستجرام، وبعد كده التوثيق بيقول انك تقدر تعمل اعلانات من هاندل الكرييتور من غير بوست موجود قبل كده. ودي الحاجة اللي بتغير طبيعة الشغل: انت مابقتش محتاج ينزل عضوي الاول.

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

What this covers
What this covers

اذن الحساب: الصلاحيات والدور اللي لازم يكون موجود

دي النقطة اللي بتوقف فيها فرق كتير وهي مش في ايد المعلن، هي في ايد الادمن. التوثيق بيطلب صلاحيات instagram_branded_content_ads_brand وinstagram_basic وbusiness_management.

والاهم: التوثيق بيقول ان «the user who granted your app access must have one of the following roles on the Instagram business account»، والادوار المقبولة هي ADS او CREATOR_MANAGEMENT او CREATOR_CONTENT، وبيتوزعوا من تاب People في Meta Business Suite.

يعني لو طلب الاذن بيرجع لك فاشل، شوف الدور الاول قبل ما تدور على بج في الكود. الاندبوينت نفسه هو /{business-account-id}/branded_content_ad_permissions، وبتبعت فيه creator_instagram_account او creator_instagram_username، والالغاء بنفس الاندبوينت مع revoke بقيمة true.

ولما تيجي تقرا الاذونات الموجودة عندك، التوثيق بيقول ان اقصى limit هو 1000 في الطلب الواحد، وبتصفح بـlimit وoffset. والرد بيرجع فيه permission_status، وده العمود اللي بيقول لك مين وافق فعلا ومين لسه.

اذن البوست: الحد اللي بيوقع السكريبتات

لو بتشتغل بالـAPI على قايمة كرييتورز، في تفصيلتين في التوثيق لازم تعرفهم، لان الاتنين بيعملوا سلوك مش متوقع لو مش واخد بالك.

الاولى: الحد الاقصى للقراية. طلب الـGET على /{user-id}/branded_content_tag_approval بيقبل 100 يوزر ايدي كحد اقصى في الطلب الواحد. فلو عندك قايمة اطول، بتقسمها انت.

والتانية وهي الاخطر: السلوك بيكون كله او ولا حاجة. التوثيق بيقول عن الاضافة ان «The API returns false if one or more user IDs fail to update; in that case it adds no user IDs to the approval list»، وبيقول نفس الكلام على الحذف. يعني لو بعت مية ايدي وواحد فيهم غلط، مفيش حاجة اتضافت خالص، والرد بيرجع false وخلاص.

ده بيعني ان اي سكريبت بيضيف كرييتورز بالباتش لازم يقرا الرد ويعيد المحاولة بعد ما يشيل الايديهات الغلط، مش يفترض النجاح. ولو كنت بتعدي على الناحية التانية، الكرييتور نفسه بيدي الاذن عن بوست معين من /{ig-media-id}/branded_content_partner_promote مع sponsor_id وpermission.

At a glance
At a glance

اللي ميتا ضافته في 2025 وبيغير قرار الهيدر

في يوليو 2025 ميتا نشرت تحديثات على الـAPI، وفيها حاجة مش تفصيلة تقنية، دي قرار كرياتيف.

الصيغة الجديدة بتخليك تظهر الشريك لوحده في هيدر الاعلان، وفي نفس الوقت النظام «dynamically selects whether to feature one or both partners in the ads header» على حسب «which will perform best for the campaign objectives». يعني قرار مين يبان في الهيدر بقى حاجة النظام بياخدها، مش حاجة بتتقفل في البريف.

وفيه كمان خاصية بتقترح عليك محتوى الكرييتور: التوثيق بيقول انها «surfaces AI-enabled organic creator content» و«recommends approved branded content that we predict will perform best in partnership ads». ودي بتشتغل على المحتوى المعتمد عندك اصلا، فقيمتها بتزيد لو مكتبة الاذونات عندك كبيرة.

وتفصيلة تالتة بتوفر وقت: فيديو انستجرام موجود بقى ينفع يترفع لفيسبوك مباشرة باستخدام الـInstagram Partnership Ad Code على {ad-account-id}/advideos بدل ما تدور على الملف الاصلي.

جدول: انهي اذن تختار

الحالة عندكالاذن المناسبالسبب من التوثيق
بوست عضوي واحد شغال وعايز تمولهاذن على مستوى البوستالكرييتور بيوافق على بوست بعينه
علاقة مستمرة وكرياتيف جديد كل شهراذن على مستوى الحساببتعمل اعلانات من غير بوست موجود قبل كده
عايز تمنع ناس تعلم براندكقايمة الموافقة على التاجبتضيف وتشيل مين مسموح له يتاجك
بتشتغل بالـAPI على قايمة كبيرةباتش مع قراية الردالاضافة كلها او ولا حاجة لو ايدي غلط
عايز تستهدف جمهور الكرييتوراذن على مستوى الحساببيسمح بتضمين او استبعاد جمهوره

والصف التالت فيه حاجة ناس كتير مش عارفاها: التوثيق بيقول انك تقدر «restrict who can tag your brand» في ليبل الشراكة المدفوعة، والتقييد اختياري. يعني لو براندك بيتعلم في بوستات انت مش عارفها، ده اعداد عندك مش حاجة مفروضة عليك.

الارقام اللي هتسمعها، وليه مش هقولها

لو بحثت عن الصيغة دي هتلاقي رقمين بيتكرروا في كل مقال تقريبا: ان الـCTR اعلى بـ53 في المية، وان تكلفة الاكتساب بتقل 19 في المية. وهتلاقيهم منسوبين لبحث من ميتا.

انا مش هكتب الرقمين دول كحقيقة، ومش هبني عليهم توصية. السبب بسيط: لقيتهم في مقالات وكالات وشركات ادوات، ومقدرتش اوصل لصفحة من ميتا نفسها فيها الرقمين دول ولا للمنهجية بتاعتهم. ولما مكنش فيه مصدر اصلي، الرقم مش رقم، ده اقتباس بيتنقل.

وده مش تفصيلة اكاديمية. الرقم اللي بيتنقل من غير منهجية بيبقى تارجت في اجتماع، وبعدين حد بيتحاسب عليه. لو عايز رقم للصيغة دي، الطريقة الوحيدة اللي بتدي رقم حقيقي هي تيست عندك انت، وفيه كلام مفصل عن حدود القراية دي في اعلانات UGC وأداءها، لان نفس المشكلة موجودة هناك بالظبط.

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

حاجتين عمليتين قبل ما تبدأ

الاولى: الاذن مش نهاية الشغل، دي بدايته. لسه عندك قرار كام اصل كرياتيف تشتغل عليه وازاي توزعهم، وده قرار بيتغير بعد Andromeda، وفصلته في تنويع الكرياتيف بعد Andromeda وفي عدد الكرياتيف في كل مجموعة اعلانية.

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

ولو انت في الناحية التانية من الطبلية، يعني براند بيتفق مع مؤثر وعايز يعرف الاذونات والقواعد قبل التعاقد، فيه تفصيل للجانب ده عند KF Agency في تحويل محتوى المؤثر لإعلان ممول: الأذونات والقواعد الموثقة.

حدود الكلام ده بصراحة

كل اللي فوق مصدره توثيق Marketing API، يعني الناحية البرمجية. الواجهة في Ads Manager بتتغير اسرع من التوثيق، وصفحات مساعدة ميتا بتمنع القراية الالية فمقدرتش اوثق خطوات الواجهة بنفسي هنا. فلو الشكل عندك مختلف، التوثيق هو المرجع للسلوك مش للخطوات.

وحاجة اخيرة تستاهل تتقال: الصيغة دي بتحل مشكلة توزيع، مش مشكلة محتوى. لو الكرياتيف نفسه ضعيف، الهاندل بتاع الكرييتور مش هيصلحه، هو بس هيوديه لناس اكتر. وده بيخلي اول سؤال في اي تعاون هو هل المحتوى ده كان هيشتغل اصلا، مش ازاي امول عليه.

أسئلة شائعة

محتاج بوست عضوي موجود عشان اعمل Partnership Ad؟

مش بالضرورة. ده بيعتمد على نوع الاذن. اذن على مستوى البوست بيشتغل على بوست موجود والكرييتور بيوافق عليه بعينه. اما اذن على مستوى الحساب، فالتوثيق بيقول انك بعد ما الكرييتور يقبل الطلب من تطبيق انستجرام تقدر تعمل اعلانات من هاندله من غير بوست موجود قبل كده.

ليه طلب الاذن بيرجع لي فاشل؟

ابدأ بالدور قبل الكود. التوثيق بيقول ان اليوزر اللي ادى التطبيق الاكسس لازم يكون له دور ADS او CREATOR_MANAGEMENT او CREATOR_CONTENT على حساب انستجرام بيزنس، وبيتحدد من تاب People في Meta Business Suite. وكمان لازم صلاحيات instagram_branded_content_ads_brand و instagram_basic و business_management.

ضيفت قايمة كرييتورز بالباتش والرد رجع false، ايه اللي حصل؟

يعني مفيش حاجة اتضافت. التوثيق صريح ان الـAPI بترجع false لو ايدي واحد او اكتر فشل، وفي الحالة دي مش بتضيف اي ايدي للقايمة. فلازم تقرا الرد، تشيل الايديهات الغلط، وتعيد. وخد بالك ان قراية الموافقات بالـGET بتقبل 100 ايدي كحد اقصى في الطلب الواحد.

الـ53 في المية في الـCTR رقم حقيقي؟

مقدرتش اوثقه. الرقم ده ورقم الـ19 في المية في تكلفة الاكتساب موجودين في مقالات وكالات وشركات ادوات منسوبين لبحث من ميتا، ومقدرتش اوصل لصفحة من ميتا فيها الرقمين ولا المنهجية. فمتبنيش توقع عليهم، وشغل تيست عندك لو عايز رقم.

اقدر امنع حد يعلم براندي في ليبل الشراكة؟

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

المصادر