Ten przewodnik zawiera szczegółowe informacje o skomplikowanych aspektach tworzenia i aktualizowania żądań dotyczących tworzenia i aktualizowania kampanii Performance Max. Może to być przydatne podczas projektowania integracji. Z tego przewodnika dowiesz się, jak są przetwarzane żądania, które zmieniają kampanie Performance Max. Może on być uzupełnieniem przewodnika Performance Max dotyczący rozwiązywania problemów oraz przewodnika Performance Max dotyczącego przetwarzania w partiach.
Tworzenie kampanii Performance Max
W interfejsie Google Ads API elementy kampanii Performance Max są reprezentowane jako kombinacja kilku unikalnych zasobów.
Standardowe kampanie Performance Max
Standardowe kampanie Performance Max wymagają minimalnego zestawu zasobów, aby mogły się wyświetlać.
- Budżet kampanii
- Kampania
- Komponenty kampanii (tylko w przypadku kampanii z włączonymi wskazówkami dotyczącymi marki)
- Grupy komponentów
- Komponenty grupy komponentów
- Assets
W przypadku kampanii z włączonymi wytycznymi dotyczącymi marki operacje tworzenia Campaign
i wymagane zasoby CampaignAsset
muszą być uwzględnione w pojedynczym żądaniu, a zasoby CampaignAsset
muszą spełniać minimalne wymagania i specyfikacje komponentów.
Pamiętaj, że operacje tworzenia elementów AssetGroup
i AssetGroupAsset
muszą być uwzględnione w jednym żądaniu, a zasoby AssetGroupAsset
muszą spełniać wszystkie minimalne wymagania dotyczące komponentów i specyfikacje. Zobacz, jak to się różni w przypadku kampanii produktowych. Prośby o utworzenie AssetGroup
bez wszystkich wymaganych elementów AssetGroupAsset
powodują błąd. Więcej informacji znajdziesz w sekcji Nieprawidłowe stany a nieprawidłowe żądania.
Istnieją różne opcje porządkowania żądań, które tworzą kampanie Performance Max. Decyzja o tym, jak grupować operacje i porządkować żądania, zależy głównie od Twoich celów i infrastruktury.
- Zanim utworzysz zasoby
AssetGroup
iAssetGroupAsset
, utwórz zasobyCampaignBudget
,Campaign
,Asset
iCampaignAsset
w osobnych żądaniach. (w przypadku kampanii z włączonymi wskazówkami dotyczącymi marki zasobyCampaign
i wymagane zasobyCampaignAsset
muszą być uwzględnione w jednym żądaniu) - Uwzględnij wszystkie te zasoby w jednym żądaniu zmiany.
Zasoby CampaignBudget
, Campaign
, Asset
i CampaignAsset
możesz utworzyć w oddzielnych wcześniejszych żądaniach, ale kampania Performance Max nie będzie mogła wyświetlać reklam, dopóki nie zostaną utworzone też zasoby AssetGroup
i AssetGroupAsset
.
Minimalne wymagania dotyczące prawidłowej obsługi kampanii Performance Max
Kampanie Performance Max możesz dostosowywać jeszcze bardziej, tworząc dodatkowe zasoby, jak pokazano na diagramie.
Operacje tworzenia zasobów AssetGroupSignal
możesz uwzględnić w tym samym żądaniu, które tworzy zasoby AssetGroup
i AssetGroupAsset
.
Możesz też utworzyć elementy AssetGroupSignal
w osobnym żądaniu po utworzeniu elementu AssetGroup
.
Kampania Performance Max z dodatkowymi opcjami
Kampanie Performance Max dla handlu detalicznego
Kampanie produktowe są wyjątkowe, ponieważ istnieją 2 sposoby tworzenia grup komponentów, które prowadzą do prawidłowej obsługi kampanii:
- Grupy plików bez komponentów
- Grupy plików zawierające WSZYSTKIE wymagane komponenty (preferowane)
Jeśli zdecydujesz się wykluczyć komponenty z grup komponentów, Google automatycznie użyje komponentów podanych na połączonym koncie Merchant Center do tworzenia reklam. Zalecamy jednak przesyłanie komponentów, które obejmują cały asortyment. Aby można było wyświetlać reklamy w kampaniach Performance Max dla handlu detalicznego, muszą one zawierać co najmniej te zasoby.
CampaignBudget
Campaign
(z wypełnionym polemShoppingSettings
)AssetGroup
AssetGroupListingGroupFilter
Pamiętaj, że w kampaniach produktowych musisz wypełnić pole Campaign.shopping_settings
. Ponadto final_urls
podane w każdym AssetGroup
muszą być zgodne z adresami URL powiązanymi z identyfikatorem konta Merchant Center określonym w Campaign.shopping_settings
. Na koniec każda grupa AssetGroup
musi mieć powiązane prawidłowe drzewo grup list produktów, które składa się z co najmniej jednego zasobu AssetGroupListingGroupFilter
. Musisz co najmniej utworzyć jedno drzewo węzłów, aby uwzględnić wszystkie produkty w określonym pliku danych Merchant Center.
Każdy z tych zasobów można utworzyć osobno lub w ramach jednego żądania. Kampania nie będzie jednak mogła wyświetlać reklam, dopóki wszystkie te zasoby nie zostaną prawidłowo utworzone.
Minimalne wymagania dotyczące prawidłowej obsługi kampanii Performance Max dla handlu detalicznego
Kampanie dotyczące handlu detalicznego mogą korzystać ze wszystkich opcji dostępnych w standardowych kampaniach Performance Max, w tym z tworzenia sygnałów grup komponentów, celów konwersji kampanii i kryteriów kampanii. Jeśli zdecydujesz się dodać komponenty do zasobu AssetGroup
podczas tworzenia zasobu AssetGroup
, zasobem AssetGroup
będą się rządzić minimalne wymagania dotyczące komponentów. Innymi słowy, możesz nie uwzględniać żadnych komponentów lub wszystkich wymaganych komponentów.
Kampania Performance Max dla handlu detalicznego z dodatkowymi opcjami
Nieprawidłowy stan a nieprawidłowe żądania
Podczas pracy z kampaniami Performance Max w interfejsie Google Ads API należy pamiętać o ważnym rozróżnieniu między nieprawidłowymi stanami a nieprawidłowymi żądaniami.
- Nieprawidłowy stan
- Kampania nie może się wyświetlać z powodu jej konfiguracji. Możesz na przykład utworzyć samodzielny zasób
Campaign
zadvertising_channel_type
PERFORMANCE_MAX
. Chociaż żądanie utworzenia kampanii zakończyło się powodzeniem, nie będzie ona mogła wyświetlać reklam, dopóki nie dodasz do niej co najmniej jednegoAssetGroup
. Jeśli Twoje żądania są obsługiwane, ale kampania lub grupy komponentów nie wyświetlają reklam, możesz użyć parametrówCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
iAssetGroupPrimaryStatusReason
, aby określić przyczynę. Szczegółowe informacje znajdziesz w przewodniku dotyczącym rozwiązywania problemów. - Nieprawidłowe żądanie
- Żądanie, które nie zostało zrealizowane, ponieważ spowodowałoby nieprawidłowy stan kampanii lub zasobu. Jeśli np. spróbujesz utworzyć
AssetGroup
w ramach kampanii niehandlowej, ale nie uwzględnisz minimalnych wymaganych komponentów, interfejs Google Ads API zwróci błąd. Dlatego w tym samym żądaniu musisz uwzględnić zasobyAssetGroup
iAssetGroupAsset
. Oznacza to też, że wszystkie zasobyAssetGroupAsset
muszą spełniać odpowiednie wymagania dla danegofield_type
, aby zapobiec niepowodzeniu całej prośby.
Grupowanie operacji za pomocą żądań z zmianami
Kampanie Performance Max składają się z wielu zasobów. Możesz je tworzyć w osobnych żądaniach lub w pojedynczym żądaniu zbiorczego zmodyfikowania. Jak już wspomnieliśmy, w standardowych kampaniach Performance Max AssetGroups
i powiązane z nim AssetGroupAssets
muszą być tworzone w ramach jednego atomowego żądania.
Kampania nie będzie się kwalifikować do wyświetlania reklam, dopóki nie utworzysz wszystkich wymaganych zasobów wymienionych w tym przewodniku. W kolejnych żądaniach używaj rzeczywistych nazw zasobów, do których się odwołujesz. Podczas wysyłania zbiorczych próśb o zmianę zawierających wiele operacji używaj nazw zasobów utworzonych przy użyciu tymczasowych identyfikatorów.
Kolejność działań
Niezależnie od tego, czy do utworzenia kampanii Performance Max używasz żądania zbiorczego, musisz tak uporządkować żądania i operacje, aby nigdy nie odwoływać się do zasobu przed jego utworzeniem. W przypadku zbiorczych operacji modyfikacji oznacza to uporządkowanie operacji w taki sposób, aby zasoby, do których się odnoszą, były wymienione przed zasobami, które się do nich odnoszą.
Jeśli zdecydujesz się utworzyć zasoby Asset w ramach tej samej prośby o zmianę zbiorczą, która tworzy AssetGroup
i jej zasoby AssetGroupAsset
, wszystkie zasoby AssetOperations
powinny znajdować się przed wszystkimi zasobami AssetGroupAssetOperations
, jak pokazano na diagramie.
Serwer Google Ads łączy kolejne AssetGroupAssetOperations
w grupy i sprawdza, czy AssetGroup
spełnia minimalne wymagania dotyczące komponentów po ostatniej operacji w tej grupie. Jeśli w żądaniu przełączasz się między parametrami AssetOperations
i AssetGroupAssetOperations
, serwer interfejsu API sprawdzi minimalne wymagania dotyczące zasobu po pierwszym AssetGroupAssetOperation
i zwróci błąd, nie wykonując pozostałych operacji w żądaniu. W efekcie żaden z komponentów w prośbie nie zostanie dodany do Twojego konta Google Ads. Ponadto nie zostaną utworzone ani AssetGroup
, ani żadne powiązane z nim zasoby AssetGroupAsset
.
Aktualizowanie grup komponentów
Po utworzeniu prawidłowej AssetGroup
nie możesz wysyłać kolejnych żądań, które spowodowałyby nieprawidłowy stan, w którym nie są już spełnione minimalne wymagania dotyczące zasobu. W przypadku takich żądań pojawia się błąd. Jeśli na przykład utworzysz AssetGroup
z jednym MARKETING_IMAGE
(co jest wymagane minimum), wszystkie żądania usunięcia AssetGroupAsset
powiązane z tym MARKETING_IMAGE
zwrócą błąd.
Jest to szczególnie ważne w przypadku grup komponentów w kampaniach produktowych utworzonych bez powiązanych komponentów. Kolejne żądania dodania komponentów do zasobu AssetGroup
przez utworzenie zasobów AssetGroupAsset
będą realizowane tylko wtedy, gdy żądanie będzie zgodne ze wszystkimi wymaganiami dotyczącymi komponentów. Inaczej mówiąc, nie możesz stopniowo dodawać komponentów do tych grup komponentów.