Żądania na poziomie struktury

Ten przewodnik zawiera szczegółowe informacje o tworzeniu żą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 modyfikują kampanie Performance Max. Może on służyć jako uzupełnienie przewodnika po rozwiązywaniu problemów z kampaniami Performance Max i przewodnika po przetwarzaniu wsadowym kampanii 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ą do wyświetlania reklam minimalnego zestawu zasobów.

W przypadku kampanii z włączonymi wytycznymi dotyczącymi marki operacje tworzenia zasobów 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 komponentów AssetGroup i AssetGroupAsset muszą być zawarte w jednym żądaniu, a zasoby AssetGroupAsset muszą spełniać wszystkie minimalne wymagania i specyfikacje dotyczące komponentów. Zobacz, jak to wygląda w przypadku kampanii detalicznych. Żądania utworzenia AssetGroup bez wszystkich wymaganych encji AssetGroupAsset powodują błąd. Więcej informacji znajdziesz w sekcji Nieprawidłowy stan a nieprawidłowe żądania.

Istnieją różne opcje tworzenia żą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 modyfikacji.

Chociaż możesz utworzyć zasoby CampaignBudget, Campaign, Asset i CampaignAsset w oddzielnych wcześniejszych żądaniach, kampania Performance Max nie będzie mogła wyświetlać reklam, dopóki nie zostaną utworzone zasoby 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.

Możesz uwzględnić operacje tworzenia zasobów AssetGroupSignal 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 detaliczne są wyjątkowe, ponieważ istnieją 2 odrębne sposoby tworzenia grup plików, które pozwalają uzyskać prawidłowo wyświetlaną kampanię:

  • Grupy plików bez komponentów niestandardowych (lub tylko z komponentami HTML5 MEDIA_BUNDLE)
  • Grupy plików, które zawierają wszystkie wymagane komponenty (preferowane)

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

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

W kampaniach detalicznych pole Campaign.shopping_setting musi być wypełnione. Dodatkowo każdy element final_urls wymieniony w elemencie AssetGroup musi być zgodny z domeną witryny powiązaną z identyfikatorem konta Merchant Center podanym w elemencie Campaign.shopping_setting. Na koniec każda grupa AssetGroup musi mieć powiązane prawidłowe drzewo grup informacji o produktach składające się z co najmniej 1 zasobu AssetGroupListingGroupFilter. Musisz utworzyć co najmniej drzewo z jednym węzłem, aby uwzględnić wszystkie produkty z określonego 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 wyświetlać reklam, dopóki wszystkie te zasoby nie zostaną prawidłowo utworzone.

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

obraz

W kampaniach detalicznych Performance Max można używać wszystkich opcji dostępnych w standardowych kampaniach Performance Max, m.in. tworzenia sygnałów grup plików, celów konwersji kampanii i kryteriów kampanii. Jeśli podczas tworzenia zasobu AssetGroup zdecydujesz się dodać do niego AssetGroup komponenty niestandardowe (inne niż komponenty HTML5 MEDIA_BUNDLE), Twoje żądanie musi spełniać wszystkie minimalne wymagania dotyczące komponentów (w tym dotyczące komponentów marki na poziomie kampanii , jeśli włączone są wytyczne dotyczące marki). Innymi słowy, nie dołączaj żadnych komponentów niestandardowych lub dołącz wszystkie wymagane komponenty.

Kampania detaliczna Performance Max 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ć ze względu na swoją konfigurację. Możesz na przykład utworzyć samodzielny zasób Campaign z wartością advertising_channel_type równą PERFORMANCE_MAX. Chociaż żądanie utworzenia kampanii zostanie zrealizowane, kampania nie będzie mogła wyświetlać reklam, dopóki nie dodasz do niej co najmniej 1 AssetGroup. Jeśli żądania się powiodą, ale kampania lub grupy komponentów nie będą się wyświetlać, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason, aby ustalić przyczynę, zgodnie z opisem w przewodniku rozwiązywania problemów.
Nieprawidłowe żądanie
Żądanie, które nie zostanie zrealizowane, ponieważ spowodowałoby, że kampania lub zasób znalazłyby się w nieprawidłowym stanie. Na przykład interfejs Google Ads API zgłasza błąd, jeśli próbujesz utworzyć AssetGroup dla kampanii detalicznej (z wyjątkiem kampanii Performance Max w Usługach lokalnych) bez uwzględnienia minimalnej liczby wymaganych komponentów. Dlatego musisz uwzględnić zasoby AssetGroup i AssetGroupAsset w tym samym żądaniu. Oznacza to również, że wszystkie zasoby AssetGroupAsset muszą spełniać prawidłowe specyfikacje dla danego field_type, aby zapobiec niepowodzeniu całego żądania.

Grupowanie operacji za pomocą żądań modyfikacji

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

Kampania nie może wyświetlać reklam, dopóki nie utworzysz wszystkich wymaganych zasobów wymienionych w tym przewodniku. W przypadku wysyłania oddzielnych żądań używaj w kolejnych żądaniach rzeczywistych nazw zasobów, do których się odwołujesz. Wysyłając żądania modyfikacji zbiorczej zawierające wiele operacji, używaj nazw zasobów utworzonych za pomocą tymczasowych identyfikatorów.

Kolejność działań

Niezależnie od tego, czy do utworzenia kampanii Performance Max używasz zbiorczego żądania modyfikacji, musisz uporządkować żądania i operacje w taki sposób, aby nigdy nie odwoływać się do zasobu, zanim zostanie on utworzony. W przypadku żądań modyfikacji zbiorczej oznacza to, że operacje muszą być uporządkowane w taki sposób, aby zasoby, do których odwołują się inne zasoby, były wymienione przed tymi zasobami.

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

obraz

Serwer Google Ads grupuje kolejne operacje AssetGroupAssetOperations i sprawdza, czy po ostatniej operacji w grupie AssetGroup spełnia minimalne wymagania dotyczące komponentów. Jeśli w żądaniu przełączasz się między AssetOperations i AssetGroupAssetOperations, serwer interfejsu API oceni minimalne wymagania dotyczące komponentów po pierwszym AssetGroupAssetOperation i zwróci błąd bez kontynuowania pozostałych operacji w żądaniu. W efekcie żaden z komponentów wskazanych w prośbie nie zostanie dodany do Twojego konta Google Ads. Ponadto nie zostaną utworzone ani AssetGroup, ani żadne powiązane zasoby AssetGroupAsset.

Aktualizowanie grup komponentów

Po utworzeniu prawidłowego obiektu AssetGroup nie możesz wysyłać kolejnych żądań, które spowodowałyby, że grupa plików nie spełniałaby minimalnych wymagań dotyczących komponentów. Każde takie żądanie powoduje błąd. Jeśli na przykład utworzysz AssetGroup z jednym MARKETING_IMAGE (minimalne wymaganie), żądanie usunięcia tylko tego MARKETING_IMAGE AssetGroupAsset zwróci błąd. W kampaniach detalicznych Performance Max możesz jednak wrócić do AssetGroup polegania na komponentach generowanych automatycznie przez Google Merchant Center, usuwając w jednym żądaniu wszystkie niestandardowe linki AssetGroupAsset.

W przypadku grup plików w kampaniach detalicznych Performance Max utworzonych bez powiązanych komponentów niestandardowych kolejne żądania połączenia komponentów niestandardowych (innych niż komponenty HTML5 MEDIA_BUNDLE) muszą zapewniać, że w AssetGroup ustawiony jest co najmniej 1 komponent final_urls (najpierw należy go wypełnić, jeśli został pierwotnie pominięty), oraz muszą dostarczać wszystkie minimalne wymagane komponenty (w tym komponenty marki na poziomie kampanii, jeśli włączone są wytyczne dotyczące marki) w jednym żądaniu niepodzielnym. Nie łącz samych opcjonalnych komponentów reklamy, takich jak YOUTUBE_VIDEO, ani nie dodawaj komponentów reklamy stopniowo w osobnych żądaniach. Połączenie tylko opcjonalnych komponentów niestandardowych powoduje, że grupa komponentów jest w nieobsługiwanym stanie, co uniemożliwia wprowadzanie zmian w interfejsie Google Ads. Szczegółowe informacje znajdziesz w artykule Łączenie grup plików z komponentami w kampaniach detalicznych Performance Max.

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