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

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

ایجاد کمپین‌های Performance Max

در API گوگل ادز، موجودیت‌های کمپین Performance Max به صورت ترکیبی از چندین منبع منحصر به فرد نمایش داده می‌شوند.

کمپین‌های استاندارد با حداکثر عملکرد

کمپین‌های استاندارد با حداکثر عملکرد (Standard Performance Max) برای ارائه خدمات به حداقل منابع نیاز دارند.

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

برای کمپین‌هایی که دستورالعمل‌های برند در آنها فعال است، عملیات ایجاد Campaign و منابع مورد نیاز CampaignAsset باید در یک درخواست واحد گنجانده شوند و منابع CampaignAsset باید حداقل الزامات و مشخصات دارایی را برآورده کنند.

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

گزینه‌های مختلفی برای ساختاردهی درخواست‌هایی که کمپین‌های Performance Max را ایجاد می‌کنند، وجود دارد. تصمیم‌گیری در مورد نحوه گروه‌بندی عملیات و ساختاردهی درخواست‌ها تا حد زیادی به اهداف و زیرساخت شما بستگی دارد.

• قبل از ایجاد منابع AssetGroup و AssetGroupAsset ، منابع CampaignBudget ، Campaign ، Asset و CampaignAsset را در درخواست‌های جداگانه ایجاد کنید. (برای کمپین‌هایی که دستورالعمل‌های برند آنها فعال است، منابع Campaign و CampaignAsset مورد نیاز باید در یک درخواست واحد گنجانده شوند)
• همه این منابع را در یک درخواست mutate واحد بگنجانید.

اگرچه می‌توانید منابع CampaignBudget ، Campaign ، Asset و CampaignAsset را در درخواست‌های قبلی جداگانه با موفقیت ایجاد کنید، اما کمپین Performance Max تا زمانی که منابع AssetGroup و AssetGroupAsset نیز ایجاد نشوند، واجد شرایط ارائه نخواهد بود.

حداقل الزامات برای یک کمپین معتبر Performance Max

شما می‌توانید کمپین‌های Performance Max خود را با ایجاد منابع اضافی، همانطور که در نمودار نشان داده شده است، بیشتر سفارشی کنید.

• سیگنال‌های گروه دارایی
• اهداف تبدیل کمپین
• معیارهای کمپین

شما می‌توانید عملیات ایجاد منابع AssetGroupSignal را در همان درخواستی که منابع AssetGroup و AssetGroupAsset را ایجاد می‌کند، بگنجانید. به عنوان یک روش جایگزین، می‌توانید موجودیت‌های AssetGroupSignal را در یک درخواست جداگانه پس از ایجاد AssetGroup ایجاد کنید.

کمپین Performance Max با گزینه‌های اضافی

کمپین‌های Performance Max برای خرده‌فروشی

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

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

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

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

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

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

حداقل الزامات برای یک کمپین معتبر Retail Performance Max

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

کمپین Retail Performance Max با گزینه‌های اضافی

وضعیت نامعتبر در مقابل درخواست‌های نامعتبر

هنگام کار با کمپین‌های Performance Max در API گوگل ادز، تمایز مهمی بین حالت‌های نامعتبر و درخواست‌های نامعتبر وجود دارد.

وضعیت نامعتبر

این کمپین به دلیل نحوه پیکربندی‌اش واجد شرایط ارائه نیست. برای مثال، می‌توانید یک منبع Campaign مستقل با نوع advertising_channel_type با PERFORMANCE_MAX ایجاد کنید. اگرچه درخواست ایجاد کمپین موفقیت‌آمیز است، اما تا زمانی که حداقل یک AssetGroup به کمپین اضافه نکنید، واجد شرایط ارائه نیست. اگر درخواست‌های شما موفقیت‌آمیز باشد اما کمپین یا گروه‌های دارایی شما ارائه نمی‌شوند، می‌توانید CampaignPrimaryStatus ، CampaignPrimaryStatusReason ، AssetGroupPrimaryStatus و AssetGroupPrimaryStatusReason برای تعیین دلیل، همانطور که در راهنمای عیب‌یابی به تفصیل آمده است، استفاده کنید.

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

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

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

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

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

ترتیب عملیات

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

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

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

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

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

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