Żądania na poziomie struktury

W tym przewodniku opisujemy wiele zagadek związanych ze strukturą żądań, które służą do tworzenia i aktualizowania kampanii Performance Max. Może się przydać przy projektowaniu integracji. Z tego przewodnika dowiesz się, jak przetwarzane są żądania przekształcające kampanie Performance Max. Możesz też towarzyszyć mu w przewodniku po rozwiązywaniu problemów z kampaniami Performance Max.

Tworzenie kampanii Performance Max

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

Standardowe kampanie Performance Max

Standardowe kampanie Performance Max wymagają pewnego minimalnego zestawu zasobów, aby mogły wyświetlać reklamy.

• Budżet kampanii
• Kampania
• Grupy plików
• Komponenty grupy plików
• Zasoby

Pamiętaj, że operacje tworzenia elementów AssetGroup i AssetGroupAsset muszą być uwzględnione razem w jednym żądaniu, a zasoby AssetGroupAsset muszą być połączone, aby spełnić wszystkie minimalne wymagania dotyczące komponentów i specyfikacje. Zobacz, czym różni się to w przypadku kampanii detalicznych. Żądania utworzenia elementu AssetGroup bez wszystkich wymaganych elementów AssetGroupAsset powodują błąd. Więcej informacji znajdziesz w sekcji Nieprawidłowy stan a żądania nieprawidłowe.

Istnieją różne opcje porządkowania żądań, które tworzą kampanie Performance Max. Decyzja o grupowaniu operacji i żądań uporządkowanych w dużej mierze zależy od Twoich celów i infrastruktury.

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

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

Minimalne wymagania dotyczące prawidłowej kampanii Performance Max do wyświetlania reklam

Możesz jeszcze bardziej dostosować kampanie Performance Max, tworząc dodatkowe materiały widoczne na schemacie.

• Sygnały grup zasobów
• Cele konwersji kampanii
• Kryteria kampanii

Możesz uwzględnić operacje tworzenia zasobów AssetGroupSignal w tym samym żądaniu, które tworzy zasoby AssetGroup i AssetGroupAsset. Możesz też utworzyć encje AssetGroupSignal w osobnym żądaniu po utworzeniu AssetGroup.

Kampania Performance Max z dodatkowymi opcjami

Kampanie Performance Max dla sklepów

Kampanie detaliczne są wyjątkowe pod tym względem, że istnieją 2 różne sposoby tworzenia grup komponentów, których wynikiem jest prawidłowa kampania wyświetlająca reklamy:

• Grupy plików niezawierające żadnych komponentów
• Grupy plików zawierające WSZYSTKIE wymagane zasoby (zalecane)

Jeśli wykluczasz komponenty z grup plików, Google automatycznie tworzy reklamy na podstawie komponentów z Twojego połączonego konta Merchant Center. Zalecamy jednak udostępnianie komponentów, które mają być dostępne we wszystkich zasobach reklamowych. Kampanie Performance Max dla sprzedawców detalicznych wymagają poniższego minimalnego zestawu zasobów, aby mogły wyświetlać reklamy.

• CampaignBudget
• Campaign (z wypełnioną wartością 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 być zgodny z adresami URL powiązanymi z identyfikatorem konta Merchant Center określonym w Campaign.shopping_settings. Każdy element AssetGroup musi mieć powiązane, prawidłowe drzewo grup informacji o produktach złożone z co najmniej 1 zasobu typu AssetGroupListingGroupFilter. Musisz utworzyć co najmniej 1 drzewo węzłów, aby uwzględnić wszystkie produkty z określonego 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 Performance Max obsługującej sprzedaż detaliczną

Kampanie sprzedażowe mogą korzystać ze wszystkich opcji dostępnych w standardowych kampaniach Performance Max, w tym z tworzenia sygnałów grup plików, celów konwersji w kampanii i kryteriów kampanii. Jeśli zdecydujesz się dodać zasoby AssetGroup do zasobu AssetGroup, AssetGroup musi ono spełniać minimalne wymagania dotyczące zasobów. Innymi słowy, możesz albo nie uwzględnić żadnych zasobów, albo wszystkie wymagane.

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

Nieprawidłowy stan a nieprawidłowe żądania

Podczas korzystania z kampanii Performance Max za pomocą interfejsu Google Ads API należy pamiętać o ważnej różnicy między nieprawidłowymi stanami a nieprawidłowymi żądaniami.

Nieprawidłowy stan

Kampania nie może wyświetlać reklam ze względu na jej konfigurację. Możesz na przykład utworzyć samodzielny zasób Campaign z advertising_channel_type o wartości PERFORMANCE_MAX. Chociaż żądanie utworzenia kampanii zostanie zrealizowane, nie będzie ona mogła wyświetlać reklam, dopóki nie dodasz do niej co najmniej 1 elementu AssetGroup. Jeśli żądania zostaną zrealizowane, ale kampania lub grupy zasobów się nie wyświetlają, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason, aby określić przyczynę. Więcej informacji znajdziesz w przewodniku rozwiązywania problemów.

Nieprawidłowe żądanie

Żądanie, które nie zostałoby zrealizowane, spowodowałoby nieprawidłowy stan kampanii lub zasobu. Interfejs Google Ads API zwraca błąd np. wtedy, gdy próbujesz utworzyć AssetGroup w kampanii niezwiązanej z handlem detalicznym bez uwzględnienia minimalnej wymaganej liczby komponentów. Dlatego w tym samym żądaniu musisz umieścić zasób AssetGroup i jego zasoby AssetGroupAsset. Oznacza to też, że wszystkie zasoby AssetGroupAsset muszą spełniać prawidłowe specyfikacje dla danego elementu field_type, aby uniknąć niepowodzenia całego żądania.

Operacje grupowania z żądaniami zmiany

Kampanie Performance Max obejmują wiele zasobów, które możesz tworzyć w ramach unikalnych żądań lub w pojedynczym zbiorczym żądaniu zmian. Jednak element AssetGroups i powiązane z nim AssetGroupAssets w standardowych kampaniach Performance Max trzeba utworzyć w jednym, niepodzielnym żądaniu.

Aby reklamy z Twojej kampanii mogły się wyświetlać, musisz utworzyć wszystkie wymagane zasoby wymienione w tym przewodniku. Gdy wysyłasz osobne żądania, w kolejnych żądaniach używaj rzeczywistych nazw zasobów przywoływanych zasobów. Podczas wysyłania zbiorczych żądań mutacji zawierających wiele operacji używaj nazw zasobów tworzonych z użyciem 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 zbiorczych żądań mutacji oznacza to uporządkowanie operacji w taki sposób, aby wskazane zasoby były wymienione przed zasobami, które się do nich odwołują.

Jeśli zdecydujesz się utworzyć zasoby zasobów w tym samym żądaniu zbiorczej mutacji, które tworzy AssetGroup i jego zasoby AssetGroupAsset, wszystkie AssetOperations powinny znajdować się przed wszystkimi AssetGroupAssetOperations, jak pokazano na diagramie.

Serwer Google Ads grupuje kolejno AssetGroupAssetOperations i ocenia, czy po ostatniej operacji w tej grupie AssetGroup spełnia minimalne wymagania dotyczące zasobów. Jeśli w żądaniu zamienisz się między AssetOperations a AssetGroupAssetOperations, serwer API oceni minimalne wymagania dotyczące zasobów po pierwszym AssetGroupAssetOperation i zwróci błąd, nie wykonując dalszych operacji w żądaniu. W rezultacie żaden z komponentów w żądaniu nie zostanie dodany do Twojego konta Google Ads. Ponadto nie zostanie utworzony zasób AssetGroup ani żaden z powiązanych zasobów AssetGroupAsset.

Zaktualizuj grupy plików

Po utworzeniu prawidłowego elementu AssetGroup nie możesz już przesyłać kolejnych żądań, które spowodowałyby nieprawidłowy stan, w wyniku którego nie będą już spełnione minimalne wymagania dotyczące zasobów. Każde takie żądanie powoduje wystąpienie błędu. Jeśli na przykład utworzysz AssetGroup z pojedynczym elementem MARKETING_IMAGE (jest to minimalne wymaganie), wszystkie żądania usunięcia elementu AssetGroupAsset powiązanego z tym MARKETING_IMAGE będą zwracać błąd.

Jest to szczególnie ważne w przypadku grup komponentów w kampaniach detalicznych utworzonych bez powiązanych komponentów. Kolejne prośby o dodanie zasobów do zasobu AssetGroup poprzez utworzenie AssetGroupAsset zasobów zostaną zrealizowane tylko wtedy, gdy będą spełniały wszystkie wymagania dotyczące zasobów. Inaczej mówiąc, do tych grup komponentów nie możesz dodawać zasobów stopniowo.