طلبات البنية

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

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

في 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 إلا إذا استوفى الطلب جميع متطلبات مواد العرض. بعبارة أخرى، لا يمكنك إضافة مواد عرض إلى مجموعات مواد العرض هذه بشكل تدريجي.