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