طلبات البنية

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

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

في 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.

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

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

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

• مجموعات مواد العرض التي لا تتضمّن مواد عرض مخصّصة (أو التي تتضمّن مواد عرض HTML5 MEDIA_BUNDLE فقط)
• مجموعات مواد العرض التي تحتوي على جميع مواد العرض المطلوبة (مفضّلة)

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

• CampaignBudget
• Campaign (مع ملء ShoppingSetting)
• AssetGroup
• AssetGroupListingGroupFilter

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

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

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

يمكن أن تستخدم "حملات الأداء الأفضل" للبيع بالتجزئة جميع الخيارات المتاحة لـ "حملات الأداء الأفضل" العادية، بما في ذلك إنشاء إشارات مجموعات مواد العرض وأهداف الإحالات الناجحة للحملة ومعايير الحملة. إذا اخترت إضافة مواد عرض مخصّصة (غير مواد عرض HTML5 في MEDIA_BUNDLE) إلى 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 واحد (الحد الأدنى المطلوب)، سيؤدي طلب إزالة MARKETING_IMAGE هذا فقط إلى ظهور خطأ AssetGroupAsset. في "حملات الأداء الأفضل" للبيع بالتجزئة، يمكنك إعادة AssetGroup إلى الاعتماد على مواد العرض التي يتم إنشاؤها تلقائيًا في Google Merchant Center عن طريق إزالة جميع روابط AssetGroupAsset المخصّصة في طلب واحد.

بالنسبة إلى مجموعات مواد العرض في "حملات الأداء الأفضل" للبيع بالتجزئة التي تم إنشاؤها بدون أي مواد عرض مخصّصة مرتبطة بها، يجب أن تضمن الطلبات اللاحقة لربط مواد العرض المخصّصة (بخلاف مواد عرض HTML5 MEDIA_BUNDLE) ضبط final_urls واحد على الأقل في AssetGroup (تعبئته أولاً إذا تم حذفه في الأصل) ويجب تقديم جميع الحد الأدنى من مواد العرض المطلوبة (بما في ذلك مواد العرض الخاصة بالعلامة التجارية على مستوى الحملة في حال تفعيل إرشادات العلامة التجارية) في طلب واحد غير قابل للتجزئة. لا تربط مواد عرض الإعلان الاختيارية، مثل YOUTUBE_VIDEO، وحدها، ولا تُضِف مواد عرض الإعلان بشكل تدريجي في طلبات منفصلة. يؤدي ربط مواد العرض المخصّصة الاختيارية فقط إلى ترك مجموعة مواد العرض في حالة غير متوافقة تمنع إجراء التعديلات في واجهة مستخدم "إعلانات Google". لمعرفة التفاصيل، يُرجى الاطّلاع على المقالة ربط مجموعات مواد العرض بمواد العرض في "حملات الأداء الأفضل" للبيع بالتجزئة.