طلبات البنية

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

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

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

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

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

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

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

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

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

على الرغم من أنّه يمكنك إنشاء CampaignBudget وCampaign وAsset بنجاح. الموارد في طلبات سابقة منفصلة، فلن تكون "حملة الأداء الأفضل" مؤهَّلة للعرض إلى أن يتم استيفاء موارد AssetGroup وAssetGroupAsset بإنشائها أيضًا.

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

يمكنك تخصيص "حملات الأداء الأفضل" بشكلٍ أكبر من خلال إنشاء والموارد كما هو موضح في الرسم التخطيطي.

• إشارات مجموعات مواد العرض
• أهداف الإحالات الناجحة للحملة
• معايير الحملة

يمكنك تضمين عمليات لإنشاء موارد AssetGroupSignal بالطريقة نفسها. إلى إنشاء الموردَين AssetGroup وAssetGroupAsset. بدلاً من ذلك، يمكنك إنشاء كيانات AssetGroupSignal في طلب منفصل. بعد إنشاء AssetGroup.

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

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

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

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

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

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

ترتيب العمليات

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

إذا اخترت إنشاء موارد مواد عرض في طلب التبديل المجمّع نفسه الذي تنشئ AssetGroup ومواردها AssetGroupAsset، وجميع يجب أن تأتي AssetOperations قبل كل AssetGroupAssetOperations، كما كما هو موضح في المخطط.

يعمل خادم "إعلانات Google" على تجميع AssetGroupAssetOperations المتتالية معًا. ويقيّم ما إذا كانت AssetGroup تستوفي الحدّ الأدنى من متطلبات مواد العرض التالية العملية الأخيرة في تلك المجموعة. في حال التبديل بين AssetOperations وAssetGroupAssetOperations في طلبك، فسيقيّم خادم واجهة برمجة التطبيقات الحد الأدنى لمتطلبات مواد العرض بعد أول AssetGroupAssetOperation بإرجاع خطأ دون متابعة بقية العمليات في طلبك. نتيجةً لذلك، لن تتم إضافة أيّ من مواد العرض الواردة في الطلب إلى حسابك على "إعلانات Google". علاوةً على ذلك، لا تتوافق AssetGroup أو أي من سيتم إنشاء AssetGroupAsset مورد.

تعديل مجموعات مواد العرض

بعد إنشاء AssetGroup صالح، لا يمكنك إصدار الطلبات اللاحقة. التي قد تؤدي إلى حالة غير صالحة يمكن فيها الحد الأدنى لمتطلبات مواد العرض لم تعد تتحقق. ويؤدي أي من هذه الطلبات إلى حدوث خطأ. على سبيل المثال، إذا إنشاء AssetGroup باستخدام MARKETING_IMAGE واحد (الحدّ الأدنى للمتطلبات)، وأي طلبات لإزالة السمة AssetGroupAsset المرتبطة بـ MARKETING_IMAGE هذا ستعرض خطأ.

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