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

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

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

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

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

کمپین های استاندارد عملکرد حداکثر به حداقل مجموعه ای از منابع برای ارائه خدمات نیاز دارند.

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

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

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

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

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

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

حداقل شرایط لازم برای کمپین حداکثر عملکرد معتبر

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

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

می‌توانید عملیات ایجاد منابع 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 مشخص شده شما در نظر بگیرد.

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

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

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

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

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

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

حالت نامعتبر

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

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

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

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

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

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

ترتیب عملیات

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

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

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

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

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

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

کمپین های استاندارد عملکرد حداکثر به حداقل مجموعه ای از منابع برای ارائه خدمات نیاز دارند.

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

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

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

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

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

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

حداقل شرایط لازم برای کمپین حداکثر عملکرد معتبر

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

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

می‌توانید عملیات ایجاد منابع 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 مشخص شده شما در نظر بگیرد.

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

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

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

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

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

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

حالت نامعتبر

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

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

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

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

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

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

ترتیب عملیات

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

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

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

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

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

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

کمپین های استاندارد عملکرد حداکثر به حداقل مجموعه ای از منابع برای ارائه خدمات نیاز دارند.

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

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

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

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

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

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

حداقل شرایط لازم برای کمپین حداکثر عملکرد معتبر

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

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

می‌توانید عملیات ایجاد منابع 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 مشخص شده شما در نظر بگیرد.

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

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

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

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

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

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

حالت نامعتبر

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

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

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

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

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

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

ترتیب عملیات

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

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

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

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

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

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

کمپین های استاندارد عملکرد حداکثر به حداقل مجموعه ای از منابع برای ارائه خدمات نیاز دارند.

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

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

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

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

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

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

حداقل شرایط لازم برای کمپین حداکثر عملکرد معتبر

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

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

می‌توانید عملیات ایجاد منابع 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 شما منوط به حداقل نیازهای دارایی است. به عبارت دیگر ، شما می توانید هیچ دارایی یا کلیه دارایی های مورد نیاز را درج کنید.

کمپین عملکرد خرده فروشی حداکثر با گزینه های اضافی

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

هنگام کار با کمپین های عملکرد MAX در API Google ADS ، تمایز مهمی بین دولتهای نامعتبر و درخواست های نامعتبر وجود دارد.

حالت نامعتبر

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

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

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

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

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

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

ترتیب عملیات

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

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

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

گروه های دارایی را به روز کنید

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

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