طلبات البنية

يوضّح هذا الدليل العديد من التفاصيل الدقيقة المتعلّقة بهيكلة الطلبات التي تنشئ "حملات الأداء الأفضل" وتعدّلها. ويمكن أن يكون مرجعًا مفيدًا أثناء تصميم عملية الدمج. يوضّح هذا الدليل كيفية معالجة الطلبات التي تعدّل "حملات الأداء الأفضل"، ويمكن أن يكون مرجعًا مصاحبًا لدليل تحديد المشاكل وحلّها في "الأداء الأفضل" ودليل المعالجة على دفعات في "الأداء الأفضل".

إنشاء "حملات الأداء الأفضل"

في Google Ads API، يتم تمثيل كيانات "حملات الأداء الأفضل" كمجموعة من عدّة مراجع فريدة.

حملات الأداء الأفضل العادية

تتطلّب "حملات الأداء الأفضل" العادية حدًا أدنى من المراجع لعرض الإعلانات.

• ميزانية الحملة
• الحملة
• مواد عرض الحملة (للحملات التي تم تفعيل إرشادات العلامة التجارية فيها فقط)
• مجموعات مواد العرض
• مواد عرض مجموعة مواد العرض
• Assets

بالنسبة إلى الحملات التي تم تفعيل إرشادات العلامة التجارية فيها، يجب تضمين العمليات لإنشاء Campaign ومراجع CampaignAsset المطلوبة في طلب واحد، ويجب أن تستوفي مراجع CampaignAsset الحدّ الأدنى من متطلبات مواد العرض ومواصفاتها.

من المهم ملاحظة أنّه يجب تضمين العمليات لإنشاء AssetGroup و AssetGroupAsset معًا في طلب واحد، ويجب أن تتكامل مراجع AssetGroupAsset لاستيفاء جميع الحدّ الأدنى من متطلبات مواد العرض والمواصفات. اطّلِع على الاختلاف في حملات البيع بالتجزئة. تؤدي الطلبات لإنشاء AssetGroup بدون جميع كيانات AssetGroupAsset المطلوبة إلى حدوث خطأ. لمزيد من السياق، اطّلِع على الحالة غير الصالحة مقابل الطلبات غير الصالحة .

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

• يمكنك إنشاء مراجع CampaignBudget وCampaign وAsset وCampaignAsset في طلبات منفصلة قبل إنشاء مراجع AssetGroup وAssetGroupAsset. (بالنسبة إلى الحملات التي تم تفعيل إرشادات العلامة التجارية فيها، يجب تضمين Campaign ومراجع CampaignAsset المطلوبة معًا في طلب واحد)
• يمكنك تضمين كل هذه المراجع في طلب تعديل واحد.

على الرغم من أنّه يمكنك إنشاء مراجع CampaignBudget وCampaign وAsset و CampaignAsset بنجاح في طلبات منفصلة سابقة، لن تكون "حملة الأداء الأفضل" مؤهّلة لعرض الإعلانات إلى أن يتم إنشاء مراجع AssetGroup وAssetGroupAsset أيضًا.

الحدّ الأدنى من المتطلبات لـ "حملة أداء أفضل" صالحة لعرض الإعلانات

يمكنك تخصيص حملات الأداء الأفضل بشكل أكبر من خلال إنشاء مواد عرض إضافية كما هو موضّح في المخطّط البياني.

• إشارات مجموعة مواد العرض
• أهداف الإحالات الناجحة للحملة
• معايير الحملة

يمكنك تضمين عمليات لإنشاء مراجع AssetGroupSignal في الطلب نفسه الذي ينشئ مراجع AssetGroup وAssetGroupAsset. بدلاً من ذلك، يمكنك إنشاء كيانات AssetGroupSignal في طلب منفصل بعد إنشاء AssetGroup.

"حملة أداء أفضل" تتضمّن خيارات إضافية

"حملات الأداء الأفضل" للبيع بالتجزئة

تتميّز "حملات البيع بالتجزئة" بطريقتَين منفصلتَين لإنشاء مجموعات مواد عرض تؤدي إلى حملة صالحة لعرض الإعلانات:

• مجموعات مواد عرض لا تتضمّن أي مواد عرض
• مجموعات مواد عرض تتضمّن جميع مواد العرض المطلوبة (الخيار المفضّل)

عند اختيار استبعاد مواد العرض من مجموعات مواد العرض، تستخدِم Google تلقائيًا مواد العرض المقدَّمة في حسابك المرتبط على Merchant Center لإنشاء الإعلانات. ومع ذلك، ننصحك بتقديم مواد عرض للوصول إلى جميع المساحات الإعلانية. تتطلّب "حملات الأداء الأفضل" للبيع بالتجزئة الحدّ الأدنى من مجموعة المراجع التالية لعرض الإعلانات.

• CampaignBudget
• Campaign (مع تعبئة ShoppingSettings)
• AssetGroup
• AssetGroupListingGroupFilter

من المهم ملاحظة أنّه يجب تعبئة الحقل Campaign.shopping_settings في "حملات البيع بالتجزئة". بالإضافة إلى ذلك، يجب أن تتطابق final_urls المدرَجة في كل AssetGroup مع عناوين URL المرتبطة برقم تعريف حساب Merchant Center المحدّد في Campaign.shopping_settings. أخيرًا، يجب أن تتضمّن كل AssetGroup شجرة مجموعة بيانات منتجات مرتبطة وصالحة تتألف من مرجع واحد أو أكثر من مراجع AssetGroupListingGroupFilter يجب إنشاء شجرة عقدة واحدة على الأقلّ لتضمين جميع المنتجات في خلاصة Merchant Center المحدّدة.

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

الحدّ الأدنى من المتطلبات لـ "حملة أداء أفضل" صالحة لعرض الإعلانات للبيع بالتجزئة

يمكن أن تستخدِم "حملات البيع بالتجزئة" جميع الخيارات المتاحة لـ "حملات الأداء الأفضل" العادية، بما في ذلك إنشاء إشارات مجموعة مواد العرض وأهداف الإحالات الناجحة للحملة ومعايير الحملة. إذا اخترت إضافة مواد عرض الإعلان إلى AssetGroup عند إنشاء مورد AssetGroup، تخضع AssetGroup للحدّ الأدنى من متطلبات مواد عرض الإعلان. بعبارة أخرى، يمكنك إما عدم تضمين أي مواد عرض أو تضمين جميع مواد العرض المطلوبة.

"حملة أداء أفضل" للبيع بالتجزئة تتضمّن خيارات إضافية

الحالة غير الصالحة مقابل الطلبات غير الصالحة

عند استخدام "حملات الأداء الأفضل" في Google Ads API، هناك فرق مهم بين الحالات غير الصالحة والطلبات غير الصالحة.

حالة غير صالحة

الحملة غير مؤهّلة لعرض الإعلانات بسبب طريقة إعدادها. على سبيل المثال، يمكنك إنشاء مرجع Campaign مستقل مع advertising_channel_type بقيمة PERFORMANCE_MAX. على الرغم من نجاح طلب إنشاء الحملة، لن تكون مؤهّلة لعرض الإعلانات إلى أن تضيف AssetGroup واحدة على الأقل إلى الحملة. إذا نجحت طلباتك ولكن لم يتم عرض إعلانات حملتك أو مجموعات مواد العرض، يمكنك استخدام CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, و AssetGroupPrimaryStatusReason لتحديد السبب، كما هو موضّح بالتفصيل في الـ دليل تحديد المشاكل وحلّها.

طلب غير صالح

طلب لن ينجح لأنّه سيضع الحملة أو المرجع في حالة غير صالحة. على سبيل المثال، يعرض Google Ads API رسالة خطأ إذا حاولت إنشاء AssetGroup لحملة غير مخصّصة للبيع بالتجزئة بدون تضمين الحدّ الأدنى من مواد العرض المطلوبة. لهذا السبب، يجب تضمين AssetGroup ومراجع AssetGroupAsset في الطلب نفسه. يعني هذا أيضًا أنّه يجب أن تستوفي جميع مراجع AssetGroupAsset المواصفات الصحيحة لـ field_type معيّن لمنع فشل الطلب بالكامل.

تجميع العمليات باستخدام طلبات التعديل

تتألف "حملات الأداء الأفضل" من مراجع متعدّدة، ويمكنك إنشاء هذه المراجع المنفصلة في طلبات فريدة أو في طلب تعديل مجمّع واحد. ومع ذلك، يجب إنشاء AssetGroups وAssetGroupAssets المرتبطة بها في "حملات الأداء الأفضل" العادية في طلب واحد غير قابل للتجزئة كما سبق أن ذكرنا.

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

ترتيب العمليات

بغض النظر عمّا إذا كنت تستخدِم طلب تعديل مجمّعًا لإنشاء "حملة أداء أفضل"، يجب ترتيب طلباتك وعملياتك بطريقة لا تشير فيها أبدًا إلى مرجع قبل إنشائه. في حالة طلبات التعديل المجمّعة، يعني ذلك ترتيب العمليات بطريقة يتم فيها إدراج المراجع المشار إليها قبل المراجع التي تشير إليها.

إذا اخترت إنشاء مراجع مواد العرض في طلب التعديل المجمّع نفسه الذي ينشئ AssetGroup ومراجع AssetGroupAsset، يجب أن تأتي جميع AssetOperations قبل جميع AssetGroupAssetOperations، كما هو موضّح في الرسم البياني.

يجمّع خادم "إعلانات Google" عمليات AssetGroupAssetOperations المتتالية معًا ويقيّم ما إذا كانت AssetGroup تستوفي الحدّ الأدنى من متطلبات مواد العرض بعد العملية الأخيرة في تلك المجموعة. إذا بدّلت بين AssetOperations و AssetGroupAssetOperations في طلبك، سيقيّم خادم واجهة برمجة التطبيقات الحدّ الأدنى من متطلبات مواد العرض بعد أول AssetGroupAssetOperation وسيعرض رسالة خطأ بدون المتابعة مع بقية العمليات في الطلب. نتيجةً لذلك، لن تتم إضافة أي من مواد العرض في الطلب إلى حسابك على "إعلانات Google". علاوةً على ذلك، لن يتم إنشاء AssetGroup أو أي من مراجع AssetGroupAsset المرتبطة بها.

تعديل مجموعات مواد العرض

بعد إنشاء AssetGroup صالحة، لا يمكنك إرسال طلبات لاحقة تؤدي إلى حالة غير صالحة لا يتم فيها استيفاء الحدّ الأدنى من متطلبات مواد العرض. تعرض أي من هذه الطلبات رسالة خطأ. على سبيل المثال، إذا أنشأت AssetGroup تتضمّن MARKETING_IMAGE (الحدّ الأدنى من المتطلبات)، ستعرض أي طلبات لإزالة AssetGroupAsset المرتبطة بـ MARKETING_IMAGE رسالة خطأ.

يُعدّ ذلك مهمًا بشكل خاص في حالة مجموعات مواد العرض في "حملات البيع بالتجزئة" التي تم إنشاؤها بدون أي مواد عرض مرتبطة. لن تنجح الطلبات اللاحقة لإضافة مواد عرض الإعلان إلى الـ AssetGroup من خلال إنشاء مراجع AssetGroupAsset إلا إذا استوفى الـ الطلب جميع متطلبات مواد عرض الإعلان. بعبارة أخرى، لا يمكنك إضافة مواد عرض إلى مجموعات مواد العرض هذه بشكل تدريجي.