تقسيم إنشاء نماذج المزيج التسويقي في API الرؤى

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

يتم دمج استدعاءات API في API الرؤى باستخدام المعلمة breakdowns=mmm. على عكس التقسيمات الأخرى، لا يدعم هذا التقسيم الجمع مع breakdowns أو action_breakdowns أخرى.

تحتوي الاستجابات على أدوات قياس وتقسيمات مماثلة للنتائج من تصدير بيانات إنشاء نماذج المزيج التسويقي في تقارير الإعلانات. لا تتوفر بيانات إنشاء نماذج المزيج التسويقي إلا على مستوى المجموعة الإعلانية، وهو السلوك الافتراضي (المكافئ للمعلمة level=adset). في الوقت الحالي، تُعد impressions وspend هي أدوات القياس المدعومة لبيانات إنشاء نماذج المزيج التسويقي. ملاحظة:spend هي أداة قياس تقديرية. للتعرف على المزيد، راجع API الرؤى، أدوات القياس التقديرية والتي تم إيقاف استخدامها.

البدء السريع

لاستدعاء API الرؤى، تحتاج إلى الإذن ads_read للحساب الإعلاني المحدد.

للحصول على بيانات إنشاء نماذج المزيج التسويقي:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

تستخدم API الرؤى قيم افتراضية للمعلمات التي لم يتم تحديدها في الاستدعاء. نوصي باستخدام المعلمتين time_range وdate_preset. يمكن زيادة دقة الاستجابة بشكل أكبر باستخدام time_increment.

مثال

يحصل استدعاء API هذا على بيانات إنشاء نماذج المزيج التسويقي للأسبوع الماضي:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  -F "date_preset=last_7d" \ 
  -F "time_increment=1” \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

لمزيد من المعلومات حول API الرؤى وكيفية تأهيل API التسويق، راجع البدء السريع لـ API الرؤى.

الاستعلام على مستوى مدير الأعمال

ستكون حالة الاستخدام الشائعة هي استرداد بيانات إنشاء نماذج المزيج التسويقي لمدير أعمال واحد. هذه العملية غير مدعومة بشكل مباشر لأن API الرؤى تعمل على مستوى الحساب الإعلاني وما دونه.

لتنزيل البيانات الخاصة بمدير أعمال، تحتاج أولاً إلى الاستعلام عن الحسابات الإعلانية المتوفرة باستخدام نقاط النهاية owned_ad_accounts وclient_ad_accounts.
```
curl \
  -F "access_token=ACCESS_TOKEN" \ 
  "https://graph.facebook.com/v21.0/BUSINESS_ID/owned_ad_accounts"
```
```
curl \
  -F "access_token=ACCESS_TOKEN" \ 
  "https://graph.facebook.com/v21.0/BUSINESS_ID/client_ad_accounts"
```
قم بالتكرار على معرفات الحسابات الإعلانية الفردية التي تم إرجاعها للاستعلام عن بيانات إنشاء نماذج المزيج التسويقي لكل حساب إعلاني.

التقييدات وأفضل الممارسات

تتسبب دقة بيانات إنشاء نماذج المزيج التسويقي في احتواء الاستجابة على عدد كبير من السجلات بالإضافة إلى حجم كبير للسجل. يمكن أن يتسبب هذا في تعطيل طلباتك أثناء الحساب. لتجنب ذلك، يمكنك خفض حجم الطلب عن طريق استخدام time_range وfiltering والاستعلام عن نطاق الوقت الإجمالي في الأقسام. للتعرف على المزيد، راجع تقييدات API الرؤى وأفضل الممارسات.

بالنسبة لهذا الإصدار، لا يوجد سوى filtering محدد مدعوم للاستعلام عن بيانات إنشاء نماذج المزيج التسويقي. لا يتم السماح إلا لمجموعات المشغل المدرجة هذه لحقل، وستعمل استخدامات filtering الأخرى على إرجاع خطأ.

الحقل	المشغلات المسموح بها
`campaign.id`	`IN`، `NOT_IN`
`campaign.name`	`CONTAIN`، `NOT_CONTAIN`
`adset.id`	`IN`، `NOT_IN`
`adset.name`	`CONTAIN`، `NOT_CONTAIN`
`country`	`IN`
`region`	`IN`
`dma`	`IN`
`device_platform`	`IN`
`publisher_platform`	`IN`
`platform_position`	`IN`

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

بدلاً من ذلك، يمكنك استخدام دفق مهام API الرؤى غير المتزامنة. يؤدي هذا إلى إنشاء مهمة تحسب البيانات بطريقة غير متزامنة. تستجيب نقطة النهاية بـ id تقرير الإعلان، والذي يمكنك الاستعلام من خلاله عن حالة المهمة واستعادة البيانات المحسوبة. ومع ذلك، لاحظ أنه قد تنتهي مهلة بعض الطلبات حتى كمهمة غير متزامنة. لمزيد من المعلومات، راجع مهام API الرؤى غير المتزامنة.

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

فهرس العمود	عناوين الأعمدة الافتراضية من تقسيم إنشاء نماذج المزيج التسويقي
0	`account_id`
1	`campaign_id`
2	`adset_id`
3	`date_start`
4	`date_stop`
5	`impressions`
6	`spend`
7	`country`
8	`region`
9	`dma`
10	`device_platform`
11	`platform_position`
12	`publisher_platform`
13	`creative_media_type`