درخواست‌های ساختار

این راهنما بسیاری از پیچیدگی‌های ساختاردهی درخواست‌هایی را که پویش‌های «عملکرد بیشینه» را ایجاد و به‌روزرسانی می‌کنند شرح می‌دهد. این سند می‌تواند منبع مفیدی برای طراحی ادغام شما باشد. این راهنما توضیح می‌دهد که درخواست‌هایی که پویش‌های «عملکرد بیشینه» را تغییر می‌دهند چگونه پردازش می‌شوند و می‌تواند منبع همراهی برای راهنمای عیب‌یابی «عملکرد بیشینه» و راهنمای پردازش دسته‌ای «عملکرد بیشینه» باشد.

ایجاد پویش‌های «عملکرد بیشینه»

در Google Ads API، نهادهای پویش «عملکرد بیشینه» به‌صورت ترکیبی از چند منبع منحصربه‌فرد نشان داده می‌شوند.

پویش‌های استاندارد «عملکرد بیشینه»

کمپین‌های «عملکرد بیشینه» استاندارد برای ارائه شدن به حداقل مجموعه‌ای از منابع نیاز دارند.

• بودجه پویش
• پویش
• دارایی‌های پویش (فقط برای پویش‌هایی که دستورالعمل‌های نمانام در آن‌ها فعال است)
• گروه‌های دارایی
• دارایی‌های گروه دارایی
• دارایی‌ها

برای پویش‌هایی که رهنمودهای نمانام در آن‌ها فعال است، عملیات ایجاد 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 منبع را ایجاد می‌کند اضافه کنید. یا می‌توانید پس‌از ایجاد AssetGroup، AssetGroupSignal نهاد را در درخواستی جداگانه ایجاد کنید.

پویش «عملکرد بیشینه» با گزینه‌های بیشتر

پویش‌های «عملکرد بیشینه» برای خرده‌فروشی

پویش‌های خرده‌فروشی از این نظر منحصربه‌فرد هستند که دو روش مجزا برای ایجاد گروه‌های دارایی وجود دارد که منجر به پویش معتبر ارائه می‌شود:

• گروه‌های دارایی بدون هیچ دارایی
• گروه‌های دارایی که حاوی همه دارایی‌های الزامی است (ترجیحی)

وقتی تصمیم می‌گیرید دارایی‌ها را از گروه‌های دارایی مستثنی کنید، Google به‌طور خودکار از دارایی‌های ارائه‌شده در حساب Merchant Center پیوندشده شما برای ایجاد آگهی‌ها استفاده می‌کند. بااین‌حال، توصیه می‌کنیم دارایی‌هایی ارائه دهید که به همه موجودی‌ها دسترسی داشته باشند. پویش‌های «عملکرد بیشینه» برای خرده‌فروشی به مجموعه حداقلی از منابع زیر برای ارائه نیاز دارد.

• CampaignBudget
• ‫Campaign (با ShoppingSettings پرشده)
• AssetGroup
• AssetGroupListingGroupFilter

توجه به این نکته مهم است که فیلد Campaign.shopping_settings باید در پویش‌های خرده‌فروشی پر شود. علاوه‌براین، final_urls فهرست‌شده در هر AssetGroup باید با نشانی‌های وب مرتبط با شناسه حساب 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 برای تعیین دلیل آن استفاده کنید، همان‌طور که در راهنمای عیب‌یابی به‌تفصیل توضیح داده شده است.

درخواست نامعتبر

درخواستی که موفقیت‌آمیز نخواهد بود زیرا پویش یا منبع را در وضعیت نامعتبری قرار می‌دهد. برای مثال، اگر بخواهید AssetGroup برای پویش غیرخرده‌فروشی بدون گنجاندن حداقل دارایی‌های لازم ایجاد کنید، Google Ads API خطا می‌دهد. به همین دلیل باید AssetGroup و منابع AssetGroupAsset آن را در همان درخواست بگنجانید. این همچنین به این معنی است که همه منابع AssetGroupAsset شما باید مشخصات صحیح را برای یک field_type مشخص داشته باشند تا از ناموفق شدن کل درخواست جلوگیری شود.

عملیات گروهی با درخواست‌های تغییر

پویش‌های «عملکرد بیشینه» از چندین منبع تشکیل شده‌اند و این گزینه را دارید که این منابع جداگانه را در درخواست‌های منحصربه‌فرد یا در یک درخواست جهش انبوه ایجاد کنید. بااین‌حال، همان‌طور که قبلاً اشاره شد، AssetGroups و AssetGroupAssets مرتبط در پویش‌های استاندارد «عملکرد بیشینه» باید در یک درخواست اتمی واحد ایجاد شوند.

تا زمانی که همه منابع موردنیاز ذکرشده در این راهنما را باموفقیت ایجاد نکنید، پویش شما واجدشرایط ارائه کردن نیست. هنگام صدور درخواست‌های جداگانه، از نام‌های منبع واقعی منابع ارجاع‌شده در درخواست‌های بعدی استفاده کنید. هنگام صدور درخواست‌های تغییر انبوه حاوی چندین عملیات، از نام‌های منبعی استفاده کنید که بااستفاده از شناسه‌های موقت تشکیل شده‌اند.

اولویت عملگرها

صرف‌نظر از اینکه از درخواست تغییر انبوه برای ایجاد پویش «بیشینه‌سازی عملکرد» استفاده می‌کنید یا نه، باید درخواست‌ها و عملیات‌هایتان را به‌گونه‌ای ترتیب دهید که هرگز به منبعی قبل‌از ایجاد آن ارجاع ندهید. در مورد درخواست‌های تغییر انبوه، این به معنای ترتیب‌بندی عملیات‌ها به گونه‌ای است که منابع ارجاع‌شده قبل از منابعی که به آن‌ها ارجاع می‌دهند فهرست شوند.

اگر تصمیم دارید منابع «دارایی» را در همان درخواست جهش انبوهی ایجاد کنید که AssetGroup و منابع AssetGroupAsset آن را ایجاد می‌کند، همه AssetOperations باید قبل‌از همه AssetGroupAssetOperations بیاید، همان‌طور که در نمودار نشان داده شده است.

کارساز Google Ads‏ AssetGroupAssetOperations متوالی را دسته‌بندی می‌کند و ارزیابی می‌کند که آیا AssetGroup پس‌از آخرین عملیات در آن گروه حداقل الزامات دارایی را برآورده می‌کند یا نه. اگر در درخواستتان بین AssetOperations و AssetGroupAssetOperations جابه‌جا شوید، سرور API الزامات حداقل دارایی را پس‌از اولین AssetGroupAssetOperation ارزیابی می‌کند و بدون ادامه دادن بقیه عملیات در درخواست، خطایی برمی‌گرداند. درنتیجه، هیچ‌یک از دارایی‌های موجود در درخواست به حساب Google Ads شما اضافه نخواهد شد. علاوه‌براین، نه AssetGroup و نه هیچ‌یک از منابع مرتبط AssetGroupAsset ایجاد نخواهند شد.

به‌روزرسانی گروه‌های دارایی

پس‌از ایجاد AssetGroup معتبر، نمی‌توانید درخواست‌های بعدی را صادر کنید که منجر به وضعیت نامعتبر شود که در آن حداقل الزامات دارایی دیگر برآورده نشود. هرگونه درخواست ازاین‌دست با خطا مواجه می‌شود. برای مثال، اگر AssetGroup را با یک MARKETING_IMAGE (حداقل الزام) ایجاد کنید، هرگونه درخواست برای برداشتن AssetGroupAsset مرتبط با آن MARKETING_IMAGE با خطا مواجه خواهد شد.

این موضوع به‌ویژه درمورد گروه‌های دارایی در پویش‌های خرده‌فروشی که بدون هیچ دارایی مرتبطی ایجاد شده‌اند اهمیت دارد. درخواست‌های بعدی برای افزودن دارایی به AssetGroup با ایجاد AssetGroupAsset منبع فقط درصورتی موفق خواهد بود که درخواست همه الزامات دارایی را برآورده کند. به عبارت دیگر، نمی‌توانید دارایی‌ها را به‌صورت افزایشی به این گروه‌های دارایی اضافه کنید.