Żądania na poziomie struktury

Ten przewodnik zawiera szczegółowe informacje o strukturze żądań, które tworzą i aktualizują kampanie Performance Max. Może to być przydatne źródło informacji 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 rozwiązywania problemów z kampaniami Performance Max i przewodnika przetwarzania zbiorczego 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

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ć zawarte w jednym żądaniu, a zasoby CampaignAsset muszą spełniać minimalne wymagania dotyczące komponentów i specyfikacji.

Pamiętaj, że operacje tworzenia obiektów 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, czym różni się to w przypadku kampanii w sieci handlowej. Żądania utworzenia AssetGroup bez wszystkich wymaganych elementów AssetGroupAsset 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ć uwzględnione razem w jednym żądaniu).
  • Uwzględnij wszystkie te zasoby w jednym żądaniu zmiany.

Możesz utworzyć zasoby CampaignBudget, Campaign, Asset i CampaignAsset w oddzielnych wcześniejszych żądaniach, ale kampania Performance Max nie będzie kwalifikować się do wyświetlania reklam, dopóki nie utworzysz też zasobów AssetGroup i AssetGroupAsset.

Minimalne wymagania dotyczące prawidłowo wyświetlanej kampanii Performance Max

obraz

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

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

Kampania Performance Max z dodatkowymi opcjami

obraz

Kampanie Performance Max dla handlu detalicznego

Kampanie w branży handlu detalicznego są wyjątkowe, ponieważ istnieją 2 odrębne sposoby tworzenia grup plików, które umożliwiają wyświetlanie prawidłowych kampanii:

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

Jeśli zdecydujesz się wykluczyć komponenty z grup plików, Google będzie automatycznie używać komponentów podanych na połączonym koncie Merchant Center do tworzenia reklam. Zalecamy jednak przesyłanie komponentów, aby docierać do wszystkich zasobów reklamowych. Aby kampanie Performance Max dla handlu detalicznego mogły się wyświetlać, wymagają one co najmniej tego zestawu zasobów:

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

Pamiętaj, że w kampaniach w sieci handlowej pole Campaign.shopping_settings musi być wypełnione. Dodatkowo final_urls wymienione w każdym AssetGroup musi być zgodne 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 wpisów o produktach składające się z co najmniej 1 zasobu AssetGroupListingGroupFilter. Musisz utworzyć co najmniej 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ć oddzielnie lub w ramach jednego żądania. Jednak kampania nie będzie się kwalifikować do wyświetlania, dopóki wszystkie te komponenty nie zostaną prawidłowo utworzone.

Minimalne wymagania dotyczące prawidłowo wyświetlanej kampanii Performance Max dla handlu detalicznego

obraz

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

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

Nieprawidłowy stan
Kampania nie kwalifikuje się do wyświetlania reklam ze względu na sposób jej konfiguracji. Możesz na przykład utworzyć samodzielny zasób Campaign z advertising_channel_type o wartości PERFORMANCE_MAX. Żądanie utworzenia kampanii zostanie zrealizowane, ale nie będzie ona kwalifikować się do wyświetlania, dopóki nie dodasz do niej co najmniej 1 AssetGroup. Jeśli Twoje żądania są realizowane, ale kampania lub grupy plików nie wyświetlają reklam, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason, aby określić przyczynę, zgodnie z opisem 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 interfejs Google Ads API zgłosi błąd, jeśli spróbujesz utworzyć AssetGroup w kampanii innej niż handlowa bez uwzględnienia minimalnej wymaganej liczby komponentów. Dlatego musisz uwzględnić AssetGroup i jego zasoby AssetGroupAsset w tym samym żądaniu. Oznacza to również, że wszystkie Twoje AssetGroupAsset zasoby muszą spełniać odpowiednie specyfikacje dla danego field_type, aby zapobiec niepowodzeniu całego żądania.

Operacje na grupach z żądaniami zmiany

Kampanie Performance Max składają się z wielu zasobów, które możesz tworzyć w osobnych żądaniach lub w jednym żądaniu zbiorczej zmiany. Jednak AssetGroups i powiązane z nimi AssetGroupAssets w standardowych kampaniach Performance Max muszą być tworzone w ramach jednego niepodzielnego żądania, jak już wspomnieliśmy.

Kampania nie będzie się wyświetlać, dopóki nie utworzysz wszystkich wymaganych zasobów wymienionych w tym przewodniku. W przypadku wysyłania oddzielnych żądań w kolejnych żądaniach używaj rzeczywistych nazw zasobów, do których się odwołujesz. W przypadku wysyłania zbiorczych żądań zmiany 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łują, były wymienione przed zasobami, które się do nich odwołują.

Jeśli zdecydujesz się utworzyć zasoby Asset w tym samym zbiorczym żądaniu zmiany, które tworzy AssetGroup i jego zasoby AssetGroupAsset, wszystkie elementy AssetOperations powinny występować przed wszystkimi elementami AssetGroupAssetOperations, jak pokazano na diagramie.

obraz

Serwer Google Ads łączy kolejne operacje AssetGroupAssetOperations w pakiety i sprawdza, czy AssetGroup spełnia minimalne wymagania dotyczące komponentów po ostatniej operacji w tej grupie. Jeśli w żądaniu używasz na przemian znaków AssetOperations i AssetGroupAssetOperations, serwer interfejsu API oceni minimalne wymagania dotyczące komponentów po pierwszym wystąpieniu znaku AssetGroupAssetOperation i zwróci błąd bez kontynuowania pozostałych operacji w żądaniu. W rezultacie żadne komponenty z prośby nie zostaną dodane do Twojego konta Google Ads. Ponadto nie zostaną utworzone ani zasób AssetGroup, ani żadne powiązane z nim zasoby AssetGroupAsset.

Aktualizowanie grup plików

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

Jest to szczególnie ważne w przypadku grup plików w kampaniach detalicznych 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 spełni wszystkie wymagania dotyczące komponentów. Innymi słowy, nie możesz dodawać komponentów do tych grup plików stopniowo.

Wstecz
Raportowanie dotyczące kryteriów kampanii
Dalej
Przetwarzanie wsadowe