طلبات البنية

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

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

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

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

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

• ميزانية الحملة
• الحملة
• مجموعات مواد العرض
• مواد عرض مجموعة مواد العرض
• مواد العرض

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

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

• أنشئ الموارد CampaignBudget وCampaign وAsset في طلبات منفصلة قبل إنشاء الموارد AssetGroup وAssetGroupAsset.
• قم بتضمين كافة هذه الموارد في طلب تبديل واحد.

ومع أنّه يمكنك إنشاء الموارد CampaignBudget وCampaign وAsset بنجاح في طلبات منفصلة سابقة، لن تكون "حملة الأداء الأفضل" مؤهَّلة للعرض إلى أن يتم إنشاء المراجعَين 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 إلا إذا استوفى الطلب جميع متطلبات مواد العرض. بمعنى آخر، لا يمكنك إضافة مواد عرض إلى مجموعات مواد العرض هذه بشكل تدريجي.