طلبات البنية

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

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

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

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

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

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

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