الحسابات الإعلانية

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

المطالبة بالحسابات

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

حسابات التصميمات لا تكون قابلة للمطالبة.

للمطالبة بحساب إعلاني لنشاطك التجاري، قم بتوفير معرف الحساب الإعلاني بالتنسيق act_###. إرسال POST: \يجب أن يكون مقدم الطلب مسؤولاً عن النشاط التجاري الذي تتم المطالبة بالحساب الإعلاني له

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

إذا كنت مسؤولاً في الحساب الإعلاني، فإننا نوافق على طلب المطالبة هذا على الفور. يرجع فيسبوك access_status تم تعيينها على CONFIRMED.

إذا كنت مستخدمًا لا تتوفر لديه الأذونات المناسبة على الحساب الإعلاني، فسنرسل طلب ملكية إلى مسؤولي الحساب الإعلاني. بمجرد أن نرسل الطلب، ستحتوي الاستجابة على access_status تم عيينها على PENDING.

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

طلب الوصول إلى الحساب

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

إنشاء حسابات إعلانية

لاستخدام واجهة API هذه، يجب أن يكون لديك إعداد صفحة ونشاط تجاري صالح. إذا كان لديك أي حسابات إعلانية أو صفحات غير مكتملة تم إلغاء نشرها بواسطة فيسبوك، فلن تتمكن من إنشاء حساب إعلاني جديد.

يقتصر إنشاء الحساب الإعلاني باستخدام واجهة API على 5 حسابات إعلانية. لإنشاء أكثر من 5 حسابات إعلانية، يجب القيام بذلك يدويًا.

الحقول المتوفرة:

لإنشاء حساب إعلاني جديد لنشاط تجاري، حدّد name وcurrency وtimezone_id وend_advertiser وmedia_agency وpartner. يرجى الاطلاع على الشروط التالية:

• يجب أن يكون media_agency وpartner اسمًا مستعارًا لصفحة فيسبوك أو معرف صفحة فيسبوك أو معرف تطبيق فيسبوك.
• يجب أن يكون end_advertiser معرف النشاط التجاري.

إذا لم يكن لدى حسابك الإعلاني معلن أو وكالة إعلامية أو شريك، فحدد NONE. إذا كان لحسابك الإعلاني معلن أو وكالة إعلامية أو شريك، لكنهم ليسوا متواجدين على فيسبوك كصفحة أو تطبيق، فحدد UNFOUND.

لإنشاء حساب إعلاني:

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

إذا كان لديك بالفعل حد رصيد ائتماني موسّع مع فيسبوك، فيمكنك تعيين invoice على true. بعد ذلك، نقوم بربط حسابك الإعلاني الجديد بحد الرصيد الائتماني الموسّع الخاص بك.

تبدو الاستجابة كما يلي:

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

عرض الحسابات المملوكة

يمكنك عرض كل الحسابات الإعلانية التي يمكن لنشاطك التجاري الوصول إليها من خلال استدعاء GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

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

• permitted_tasks عبارة عن مصفوفة من المهام التي يمكنك تعيينها لهذا الحساب الإعلاني المحدد.
• access_type يحدد ما إذا كان نشاطك التجاري يتصرف كـ OWNER أو AGENCY في الحساب الإعلاني.

لعرض الحسابات الإعلانية التي لا يزال الوصول إليها معلقًا، قم بإجراء استدعاء GET هذا:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

إزالة الحسابات

لا يمكنك إزالة الحسابات الإعلانية من نشاطك التجاري إذا كنت OWNER وإذا كانت الحسابات بالحالة CONFIRMED. إذا كان لديك طلب وصول بالحالة PENDING أو لديك صلاحية الوصول AGENCY إلى الحساب الإعلاني، فيمكنك تنفيذ استدعاء DELETE هذا:

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

عرض صلاحية الوصول إلى الحساب

يمكنك عرض الحسابات الإعلانية التي يمتلك شخص ما إذنًا فيها باستخدام استدعاء GET هذا:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

لعرض الأذونات التي يمتلكها شخص ما في حساب إعلاني، قم بتنفيذ استدعاء GET هذا:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

إضافة الأشخاص إلى الحسابات

بعد ربط مدير الأعمال بحساب إعلاني، يمكنك تعيين المهام لمستخدمي النشاط التجاري الآخرين. تتضمن المهام المحتملة ما يلي:

ستحتاج إلى ما يلي:

• adaccount_id — معرف الحساب الإعلاني، في نموذج act_123
• user_id — معرف المستخدم المطلوب إضافته
• المهام المطلوب تعيينها

لإضافة مستخدم جديد يمكنه تنفيذ المهام ['MANAGE', 'ADVERTISE', 'ANALYZE']، قم بتنفيذ استدعاء POST هذا:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

تغيير الأذونات في الحسابات

قم بتنفيذ استدعاء POST نفسه لتغيير مهام المستخدم الحالي تمامًا كما تفعل لإضافة مستخدم جديد:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

إزالة الأشخاص من الحسابات الإعلانية

لإزالة شخص ما من حساب، تحتاج إلى:

• adaccount_id — معرف الحساب الإعلاني، في نموذج act_123
• user_id — معرف المستخدم المطلوب إزالته

يكون استدعاء DELETE كالتالي:

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"