طلبات البنية

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

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

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

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

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

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

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

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