Żądania na poziomie struktury

Z tego przewodnika dowiesz się, jak tworzyć i aktualizować kampanie Performance Max. Może on być przydatny podczas projektowania integracji. Z tego przewodnika dowiesz się, jak są przetwarzane żądania, które modyfikują kampanie Performance Max. Może on być przydatny jako uzupełnienie przewodnika rozwiązywania problemów z kampaniami Performance Max i przewodnika dotyczącego przetwarzania wsadowego kampanii Performance Max.

Tworzenie kampanii Performance Max

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

Standardowe kampanie Performance Max

Aby standardowe kampanie Performance Max mogły się wyświetlać, muszą mieć minimalny zestaw zasobów.

• Budżet kampanii
• Kampania
• Komponenty kampanii (tylko w przypadku kampanii z włączonymi wskazówkami dotyczącymi marki)
• Grupy plików
• Komponenty grupy plików
• Komponenty

W przypadku kampanii z włączonymi wskazówkami dotyczącymi marki operacje tworzenia Campaign i wymaganych zasobów CampaignAsset muszą być zawarte w jednym żądaniu, a zasoby CampaignAsset muszą spełniać minimalne wymagania i specyfikacje dotyczące komponentów.

Pamiętaj, że operacje tworzenia jednostek AssetGroup i AssetGroupAsset muszą być zawarte w jednym żądaniu, a zasoby AssetGroupAsset muszą łącznie spełniać wszystkie minimalne wymagania i specyfikacje dotyczące komponentów. Zobacz, jak to wygląda w przypadku kampanii detalicznych. Żądania utworzenia zasobu AssetGroup bez wszystkich wymaganych AssetGroupAsset jednostek powodują błąd. Więcej informacji znajdziesz w sekcji Nieprawidłowy stan a nieprawidłowe żądania .

Istnieją różne opcje strukturyzowania żądań, które tworzą kampanie Performance Max. Decyzja o tym, jak grupować operacje i strukturyzować żądania, zależy w dużej mierze od Twoich celów i infrastruktury.

• Utwórz zasoby CampaignBudget, Campaign, Asset i CampaignAsset w osobnych żądaniach przed utworzeniem zasobów AssetGroup i AssetGroupAsset. (W przypadku kampanii z włączonymi wskazówkami dotyczącymi marki zasoby Campaign i wymagane zasoby CampaignAsset muszą być zawarte w jednym żądaniu).
• Dołącz wszystkie te zasoby do jednego żądania modyfikacji.

Chociaż możesz utworzyć zasoby CampaignBudget, Campaign, Asset i CampaignAsset w osobnych wcześniejszych żądaniach, kampania Performance Max nie będzie się wyświetlać, dopóki nie utworzysz też zasobów AssetGroup i AssetGroupAsset.

Minimalne wymagania dotyczące prawidłowej kampanii Performance Max

Możesz dodatkowo dostosować kampanie Performance Max, tworząc dodatkowe zasoby, jak pokazano na diagramie.

• Sygnały grupy plików
• Cele konwersji kampanii
• Kryteria kampanii

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

Kampania Performance Max z dodatkowymi opcjami

Kampanie Performance Max dla handlu detalicznego

Kampanie detaliczne są wyjątkowe, ponieważ istnieją 2 odrębne sposoby tworzenia grup plików, które skutkują prawidłową kampanią:

• Grupy plików bez komponentów
• Grupy plików, które zawierają WSZYSTKIE wymagane komponenty (zalecane)

Gdy zdecydujesz się wykluczyć komponenty z grup plików, Google automatycznie użyje komponentów podanych na połączonym koncie Merchant Center do tworzenia reklam. Zalecamy jednak podanie komponentów, aby dotrzeć do wszystkich zasobów. Aby kampanie Performance Max dla handlu detalicznego mogły się wyświetlać, muszą mieć minimalny zestaw zasobów.

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

Pamiętaj, że w kampaniach detalicznych pole Campaign.shopping_settings musi być wypełnione. Ponadto adresy URL final_urls wymienione w każdej grupie plików AssetGroup muszą być zgodne z adresami URL powiązanymi z identyfikatorem konta Merchant Center określonym w polu Campaign.shopping_settings. Na koniec każdy AssetGroup musi mieć powiązane, prawidłowe drzewo grup informacji o produktach składające się z co najmniej 1 AssetGroupListingGroupFilter zasobu. Musisz utworzyć co najmniej 1 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 jednym żądaniu. Kampania nie będzie się jednak wyświetlać, dopóki wszystkie te zasoby nie zostaną utworzone prawidłowo.

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

Kampanie detaliczne mogą korzystać ze wszystkich opcji dostępnych w standardowych kampaniach Performance Max, w tym z tworzenia sygnałów grup plików, celów konwersji kampanii i kryteriów kampanii. Jeśli podczas tworzenia zasobu AssetGroup zdecydujesz się dodać komponenty reklamy do grupy plików AssetGroup, będzie ona AssetGroup podlegać minimalnym wymaganiom dotyczącym komponentów reklamy. Innymi słowy, możesz nie uwzględniać żadnych komponentów lub uwzględnić wszystkie wymagane komponenty.

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 rozróżniać nieprawidłowe stany i nieprawidłowe żądania.

Nieprawidłowy stan

Kampania nie kwalifikuje się do wyświetlania ze względu na sposób jej skonfigurowania. Możesz na przykład utworzyć samodzielny zasób Campaign z wartością PERFORMANCE_MAX w polu advertising_channel_type. Chociaż żądanie utworzenia kampanii zakończy się powodzeniem, nie będzie się ona wyświetlać, dopóki nie dodasz do niej co najmniej 1 grupy plików AssetGroup. Jeśli żądania się powiodą, ale kampania lub grupy plików nie będą się wyświetlać, możesz użyć pól CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, i AssetGroupPrimaryStatusReason, aby określić przyczynę, jak opisano w przewodniku rozwiązywania problemów.

Nieprawidłowe żądanie

Żądanie, które nie zostanie zrealizowane, ponieważ spowoduje przejście kampanii lub zasobu w nieprawidłowy stan. Na przykład Google Ads API zgłosi błąd, jeśli spróbujesz utworzyć AssetGroup w kampanii innej niż produktowa bez uwzględnienia minimalnej wymaganej liczby komponentów. Dlatego musisz uwzględnić AssetGroup i jej zasoby AssetGroupAsset w tym samym żądaniu. Oznacza to również, że wszystkie zasoby AssetGroupAsset muszą spełniać prawidłowe specyfikacje dla danego pola field_type, aby zapobiec niepowodzeniu całego żądania.

Grupowanie operacji za pomocą żądań modyfikacji

Kampanie Performance Max składają się z wielu zasobów. Możesz je tworzyć w osobnych żądaniach lub w jednym zbiorczym żądaniu zmiany. Jak już wspomnieliśmy, grupy plików AssetGroups i powiązane z nimi zasoby AssetGroupAssets w standardowych kampaniach Performance Max muszą być tworzone w jednym niepodzielnym żądaniu.

Kampania nie będzie się wyświetlać, dopóki nie utworzysz wszystkich wymaganych zasobów wymienionych w tym przewodniku. W przypadku wysyłania osobnych żądań używaj w kolejnych żądaniach rzeczywistych nazw zasobów, do których się odwołujesz. W przypadku wysyłania zbiorczych żądań modyfikacji 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 zbiorczego żądania zmiany, musisz uporządkować żądania i operacje tak, aby nigdy nie odwoływać się do zasobu przed jego utworzeniem. W przypadku zbiorczych żądań zmiany oznacza to uporządkowanie operacji w taki sposób, aby zasoby, do których się odwołujesz, były wymienione przed zasobami, które się do nich odwołują.

Jeśli zdecydujesz się utworzyć zasoby zasobów w tym samym zbiorczym żądaniu modyfikacji, które tworzy AssetGroup i jej zasoby AssetGroupAsset, wszystkie operacje AssetOperations powinny poprzedzać wszystkie operacje AssetGroupAssetOperations, jak pokazano na diagramie.

Serwer Google Ads łączy kolejne AssetGroupAssetOperations i sprawdza, czy AssetGroup spełnia minimalne wymagania dotyczące komponentów po wykonaniu ostatniej operacji w tej grupie. Jeśli w żądaniu będziesz przełączać się między AssetOperations i AssetGroupAssetOperations, serwer API sprawdzi minimalne wymagania dotyczące komponentów po pierwszej AssetGroupAssetOperation i zwróci błąd bez wykonywania pozostałych operacji w żądaniu. W rezultacie żadne komponenty w żądaniu nie zostaną dodane do Twojego konta Google Ads. Ponadto nie zostaną utworzone ani AssetGroup, ani żadne powiązane z nią zasoby AssetGroupAsset.

Aktualizowanie grup plików

Po utworzeniu prawidłowej grupy plików AssetGroup nie możesz wysyłać kolejnych żądań, które spowodują przejście w nieprawidłowy stan, w którym nie są już spełnione minimalne wymagania dotyczące komponentów. Wszystkie takie żądania powodują błąd. Jeśli na przykład utworzysz AssetGroup z 1 MARKETING_IMAGE (minimalne wymaganie), wszystkie żądania usunięcia AssetGroupAsset powiązanego z tym MARKETING_IMAGE zwrócą błąd.

Jest to szczególnie ważne w przypadku grup zasobów w kampaniach detalicznych utworzonych bez powiązanych zasobów. Kolejne żądania dodania komponentów reklamy do AssetGroup przez utworzenie AssetGroupAsset zasobów zakończą się powodzeniem tylko wtedy, gdy żądanie spełni wszystkie wymagania dotyczące komponentów reklamy. Innymi słowy, nie możesz dodawać komponentów do tych grup plików stopniowo.