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

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

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

در 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 نهاد را در درخواستی جداگانه ایجاد کنید.

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

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

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

• گروه‌های دارایی بدون دارایی‌های سفارشی (یا فقط با دارایی‌های HTML5 MEDIA_BUNDLE)
• گروه‌های دارایی که حاوی همه دارایی‌های لازم هستند (ترجیحی)

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

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

فیلد Campaign.shopping_setting باید در پویش‌های خرده‌فروشی پر شود. علاوه‌براین، هر final_urls فهرست‌شده در AssetGroup باید با دامنه وب‌سایت مرتبط با شناسه حساب Merchant Center مشخص‌شده در Campaign.shopping_setting مطابقت داشته باشد. درنهایت، هر AssetGroup باید دارای درخت گروه فهرستگان محصول معتبر و مرتبطی باشد که از یک یا چند منبع AssetGroupListingGroupFilter تشکیل شده باشد. حداقل باید یک درخت گره واحد ایجاد کنید تا همه محصولات موجود در فید Merchant Center مشخص‌شده شما را دربرگیرد.

هرکدام از این منابع را می‌توان به‌طور جداگانه یا در یک درخواست ایجاد کرد. اما تا زمانی که همه این منابع به‌درستی ایجاد نشده باشند، پویش واجدشرایط ارائه نخواهد بود.

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

پویش‌های خرده‌فروشی «بیشینه‌سازی عملکرد» می‌توانند از همه گزینه‌های دردسترس برای پویش‌های استاندارد «بیشینه‌سازی عملکرد» استفاده کنند، ازجمله ایجاد نشان‌های گروه دارایی، اهداف تبدیل پویش، و معیارهای پویش. اگر هنگام ایجاد منبع AssetGroup، تصمیم بگیرید دارایی‌های سفارشی (به‌غیراز دارایی‌های HTML5 MEDIA_BUNDLE) را به 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 جابه‌جا شوید، سرور میانای برنامه‌سازی کاربردی حداقل الزامات دارایی را پس‌از اولین AssetGroupAssetOperation ارزیابی می‌کند و بدون ادامه دادن بقیه عملیات در درخواست، خطایی برمی‌گرداند. درنتیجه، هیچ‌یک از دارایی‌های موجود در درخواست به حساب Google Ads شما اضافه نخواهد شد. علاوه‌براین، نه AssetGroup و نه هیچ‌کدام از منابع AssetGroupAsset مرتبط ایجاد نخواهد شد.

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

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

برای گروه‌های دارایی در پویش‌های خرده‌فروشی «عملکرد بیشینه» که بدون هیچ‌گونه دارایی سفارشی مرتبط ایجاد شده‌اند، درخواست‌های بعدی برای پیوند دادن دارایی‌های سفارشی (به‌جز دارایی‌های HTML5 MEDIA_BUNDLE) باید اطمینان حاصل کنند که حداقل یک final_urls در AssetGroup تنظیم شده است (اگر در ابتدا حذف شده باشد، ابتدا آن را پر می‌کند) و باید همه حداقل دارایی‌های موردنیاز (ازجمله دارایی‌های نمانام در سطح پویش اگر رهنمودهای نمانام فعال باشد) را در یک درخواست اتمی واحد ارائه دهند. دارایی‌های اختیاری مثل YOUTUBE_VIDEO را به‌تنهایی پیوند ندهید یا دارایی‌ها را به‌صورت افزایشی در درخواست‌های جداگانه اضافه نکنید. پیوند دادن فقط دارایی‌های سفارشی اختیاری باعث می‌شود گروه دارایی در وضعیت پشتیبانی‌نشده قرار بگیرد که ویرایش‌ها را در واسط کاربری Google Ads مسدود می‌کند. برای جزئیات، به پیوند دادن گروه‌های دارایی به دارایی‌ها در پویش‌های خرده‌فروشی «عملکرد بیشینه» مراجعه کنید.