Żądania na poziomie struktury

Ten przewodnik zawiera szczegółowe informacje o skomplikowanych aspektach tworzenia żądań służących do 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 i przewodnika po przetwarzaniu partii danych Performance Max.

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ć.

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ć zawarte 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 artykule Nieprawidłowe stany a nieprawidłowe żądania.

Istnieją różne opcje strukturyzowania żą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 i AssetGroupAsset, utwórz zasoby CampaignBudget, Campaign, Asset i CampaignAsset w osobnych żądaniach. (w przypadku kampanii z włączonymi wskazówkami dotyczącymi marki zasoby Campaign i wymagane zasoby CampaignAsset 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

obraz

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

obraz

Kampanie Performance Max dla handlu detalicznego

Kampanie produktowe są wyjątkowe, ponieważ istnieją 2 rozwiązania umożliwiające tworzenie grup komponentów, które prowadzą do prawidłowego wyświetlania 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ą wszystkie zasoby reklamowe. 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 polem ShoppingSettings)
  • 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 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 się wyświetlać, dopóki wszystkie te zasoby nie zostaną prawidłowo utworzone.

Minimalne wymagania dotyczące prawidłowej obsługi kampanii Performance Max dla handlu detalicznego

obraz

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

obraz

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 z advertising_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 jednego AssetGroup. Jeśli Twoje żądania są obsługiwane, ale kampania lub grupy komponentów nie wyświetlają reklam, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason, 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ć zasoby AssetGroup i AssetGroupAsset. Oznacza to też, że wszystkie zasoby AssetGroupAsset muszą spełniać odpowiednie wymagania dla danego field_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, zanim nie zostanie on utworzony. 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.

obraz

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 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.

Wstecz
Raportowanie
Dalej
Przetwarzanie wsadowe