Żądania na poziomie struktury

W tym przewodniku szczegółowo opisujemy wiele skomplikowanych działań związanych z tworzeniem i aktualizowaniem kampanii Performance Max. Może się przydać przy projektowaniu integracji. Z tego przewodnika dowiesz się, jak są przetwarzane żądania, które modyfikują kampanie Performance Max, i mogą służyć jako zasoby towarzyszące podane w przewodniku po rozwiązywaniu problemów z kampaniami Performance Max i w poradniku dotyczącym przetwarzania wsadowego w kampaniach Performance Max.

Utwórz kampanie Performance Max

W interfejsie Google Ads API elementy kampanii Performance Max są przedstawione jako połączenie kilku unikalnych zasobów.

Standardowe kampanie Performance Max

Standardowe kampanie Performance Max wymagają minimalnego zestawu zasobów do wyświetlania reklam.

Pamiętaj, że operacje tworzenia elementów AssetGroup i AssetGroupAsset muszą zostać uwzględnione razem w jednym żądaniu, a zasoby AssetGroupAsset muszą łączyć się tak, aby spełniały wszystkie minimalne wymagania dotyczące komponentów i specyfikacje. Zobacz, czym różni się to w przypadku kampanii detalicznych. Żądania utworzenia obiektu AssetGroup bez wszystkich wymaganych elementów AssetGroupAsset skutkują błędem. Więcej informacji o tym znajdziesz w sekcji Nieprawidłowy stan a nieprawidłowe żądania.

Istnieją różne opcje tworzenia struktury żądań, które tworzą kampanie Performance Max. Decyzja o sposobie grupowania operacji i struktury żądań zależy w dużej mierze od Twoich celów i infrastruktury.

  • Utwórz zasoby CampaignBudget, Campaign i Asset w osobnych żądaniach przed utworzeniem zasobów AssetGroup i AssetGroupAsset.
  • Uwzględnij wszystkie te zasoby w jednym żądaniu mutacji.

Możesz utworzyć zasoby CampaignBudget, Campaign i Asset w osobnych wcześniejszych żądaniach, ale kampania Performance Max nie będzie mogła wyświetlać reklam, dopóki nie utworzysz też zasobów AssetGroup i AssetGroupAsset.

Wymagania minimalne dotyczące prawidłowej kampanii Performance Max

obraz

Kampanie Performance Max możesz jeszcze bardziej dostosowywać, tworząc dodatkowe zasoby, tak jak na ilustracji.

W tym samym żądaniu, które tworzy zasoby AssetGroup i AssetGroupAsset, możesz dodać operacje tworzenia zasobów AssetGroupSignal. Elementy AssetGroupSignal możesz też utworzyć w osobnej prośbie po utworzeniu AssetGroup.

Kampania Performance Max z dodatkowymi opcjami

obraz

Kampanie Performance Max dla branży handlu detalicznego

Kampanie detaliczne wyróżniają się tym, że istnieją 2 różne sposoby tworzenia grup plików, które prowadzą do prawidłowego wyświetlania kampanii:

  • Grupy plików bez komponentów
  • Grupy plików zawierające WSZYSTKIE wymagane komponenty (zalecane)

Jeśli zdecydujesz się wykluczyć komponenty z grup plików, Google automatycznie utworzy reklamy na podstawie komponentów przesłanych na połączonym koncie Merchant Center. Zalecamy jednak przesłanie komponentów, które będą obejmować wszystkie zasoby reklamowe. Kampanie Performance Max dla sprzedawców detalicznych wymagają tego minimalnego zestawu zasobów, aby mogły wyświetlać reklamy.

  • CampaignBudget
  • Campaign (z wypełnionym polem ShoppingSettings)
  • AssetGroup
  • AssetGroupListingGroupFilter

Pamiętaj, że w przypadku kampanii detalicznych pole Campaign.shopping_settings musi być wypełnione. Dodatkowo final_urls w każdym elemencie AssetGroup musi odpowiadać adresom URL powiązanym z identyfikatorem konta Merchant Center określonym w dokumencie Campaign.shopping_settings. Każdy element AssetGroup musi też mieć powiązane, prawidłowe drzewo grup informacji o produktach, które składa się z co najmniej 1 zasobu AssetGroupListingGroupFilter. Musisz utworzyć co najmniej 1 drzewo węzła do uwzględnienia wszystkich produktów w określonym pliku danych Merchant Center.

Każdy z tych zasobów można utworzyć oddzielnie lub w pojedynczym żądaniu. Kampania nie będzie jednak wyświetlać reklam, dopóki wszystkie te zasoby nie zostaną prawidłowo utworzone.

Minimalne wymagania dotyczące prawidłowej kampanii detalicznej Performance Max

obraz

W kampaniach detalicznych dostępne są wszystkie opcje dostępne w standardowych kampaniach Performance Max, m.in. tworzenie sygnałów grup plików, celów konwersji kampanii i kryteriów kampanii. Jeśli podczas tworzenia zasobu AssetGroup zdecydujesz się dodać zasoby do AssetGroup, Twój AssetGroup będzie spełniać minimalne wymagania dotyczące zasobów. Inaczej mówiąc, możesz nie uwzględnić żadnych komponentów albo wszystkie wymagane zasoby.

Kampania Performance Max służąca do promowania sprzedaży detalicznej z dodatkowymi opcjami

obraz

Nieprawidłowy stan a nieprawidłowe żądania

W przypadku kampanii Performance Max za pomocą interfejsu Google Ads API istnieje istotna różnica między nieprawidłowymi stanami a nieprawidłowymi żądaniami.

Nieprawidłowy stan
Kampania nie kwalifikuje się do wyświetlania reklam ze względu na jej konfigurację. Możesz na przykład utworzyć samodzielny zasób Campaign z wartością advertising_channel_type o wartości PERFORMANCE_MAX. Chociaż żądanie utworzenia kampanii się uda, nie będzie mogła wyświetlać reklam, dopóki nie dodasz do kampanii co najmniej 1 elementu AssetGroup. Jeśli Twoje żądania zostaną zrealizowane, ale kampania lub grupy komponentów nie będą się wyświetlać, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason, aby określić przyczynę, zgodnie z informacjami podanymi w przewodniku na temat rozwiązywania problemów.
Nieprawidłowe żądanie
Żądanie, które nie zostałoby zrealizowane, ponieważ stan kampanii lub zasobu spowodowałoby ich nieprawidłowy stan. Interfejs Google Ads API zgłasza błąd, jeśli np. próbujesz utworzyć identyfikator AssetGroup na potrzeby kampanii innej niż handel detaliczny bez uwzględnienia minimalnej wymaganej liczby zasobów. Właśnie dlatego w tym samym żądaniu musisz uwzględnić zasób AssetGroup i jego zasoby AssetGroupAsset. Oznacza to też, że wszystkie zasoby AssetGroupAsset muszą spełniać prawidłowe specyfikacje w przypadku danego elementu field_type, aby zapobiec odrzuceniu całego żądania.

Operacje grupowe z żądaniami mutacji

Kampanie Performance Max składają się z wielu zasobów, które możesz utworzyć w ramach unikalnych żądań lub w pojedynczym żądaniu zmiany zbiorczej. Jednak element AssetGroups i powiązane z nim AssetGroupAssets w standardowych kampaniach Performance Max trzeba utworzyć w pojedynczym żądaniu, jak już podano.

Twoja kampania nie będzie wyświetlać reklam, dopóki nie utworzysz wszystkich wymaganych materiałów wymienionych w tym przewodniku. Wysyłając oddzielne żądania, w kolejnych żądaniach używaj rzeczywistych nazw zasobów w odniesieniu do przywołanych zasobów. Wysyłając żądania zbiorcze mutacji, które zawierają wiele operacji, używaj nazw zasobów utworzonych przy użyciu identyfikatorów tymczasowych.

Kolejność działań

Niezależnie od tego, czy do utworzenia kampanii Performance Max użyjesz prośby o zbiorczą mutację, musisz uporządkować żądania i operacje w taki sposób, aby nigdy nie odwoływać się do zasobu przed jego utworzeniem. W przypadku żądań zbiorczej mutacji oznacza to uporządkowanie operacji w taki sposób, że odwołania do zasobów są wymienione przed zasobami, które się do nich odwołują.

Jeśli zdecydujesz się utworzyć zasoby zasobów w ramach tego samego żądania zbiorczej mutacji, które tworzy zasób AssetGroup i jego zasoby AssetGroupAsset, wszystkie zasoby AssetOperations powinny znajdować się przed wszystkimi obiektami AssetGroupAssetOperations, jak pokazano na diagramie.

obraz

Serwer Google Ads zbiera razem kolejne elementy AssetGroupAssetOperations i ocenia, czy po ostatniej operacji w tej grupie AssetGroup spełnia minimalne wymagania dotyczące zasobów. Jeśli w żądaniu będziesz przełączać się między AssetOperations i AssetGroupAssetOperations, serwer interfejsu API oceni minimalne wymagania dotyczące zasobów po pierwszym AssetGroupAssetOperation i zwróci błąd bez wykonywania pozostałych operacji w żądaniu. W efekcie żaden z komponentów z prośby nie zostanie dodany do Twojego konta Google Ads. Nie zostanie utworzony zasób AssetGroup ani żaden z powiązanych zasobów AssetGroupAsset.

Zaktualizuj grupy plików

Po utworzeniu prawidłowego obiektu AssetGroup nie możesz już wysyłać kolejnych żądań, w wyniku których minimalne wymagania dotyczące zasobów nie będą już spełnione. Każde takie żądanie powoduje wyświetlenie błędu. Jeśli np. utworzysz AssetGroup z pojedynczym elementem MARKETING_IMAGE (wymagania minimalne), wszelkie żądania usunięcia obiektu AssetGroupAsset powiązanego z tym elementem MARKETING_IMAGE będą zwracać błąd.

Jest to szczególnie ważne w przypadku grup komponentów w kampaniach detalicznych, które zostały utworzone bez powiązanych komponentów. Kolejne prośby o dodanie zasobów do AssetGroup przez utworzenie zasobów AssetGroupAsset zakończą się powodzeniem tylko wtedy, gdy będą spełnione wszystkie wymagania dotyczące zasobów. Inaczej mówiąc, nie możesz dodawać komponentów do tych grup stopniowo.