Żądania na poziomie struktury

Ten przewodnik zawiera szczegółowe informacje o złożoności tworzenia żą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 w kampaniach 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.

• 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
• Assets

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 zasobu 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 osobnych 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

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

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

W tym samym żądaniu, które tworzy zasoby AssetGroup i AssetGroupAsset, możesz uwzględnić operacje tworzenia zasobów AssetGroupSignal. Możesz też utworzyć elementy AssetGroupSignal w osobnym żądaniu po utworzeniu elementu 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 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 zapewnić maksymalny zasięg kampanii we wszystkich zasobach 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żda wartość final_urls podana w atrybucie AssetGroup musi być zgodna z domeną witryny powiązaną z identyfikatorem konta Merchant Center podanym w atrybucie Campaign.shopping_setting. Na koniec każdy obiekt 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

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

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 przejście kampanii lub zasobu w nieprawidłowy stan. Na przykład interfejs Google Ads API zgłasza błąd, jeśli próbujesz utworzyć AssetGroup w kampanii innej niż detaliczna (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 w standardowych kampaniach Performance Max obiekty AssetGroups i powiązane z nimi obiekty AssetGroupAssets muszą być tworzone w ramach jednego żądania niepodzielnego, jak wspomniano powyżej.

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 żądania zbiorczej 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 Asset 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.

Serwer Google Ads grupuje kolejne operacje AssetGroupAssetOperations i sprawdza, czy po ostatniej operacji w danej grupie AssetGroup spełnia minimalne wymagania dotyczące komponentów. Jeśli w żądaniu używasz naprzemiennie AssetOperations i AssetGroupAssetOperations, serwer interfejsu API oceni minimalne wymagania dotyczące komponentów po pierwszym AssetGroupAssetOperation i zwróci błąd bez wykonywania pozostałych operacji w żądaniu. W efekcie żaden z komponentów wskazanych w prośbie nie zostanie dodany do Twojego konta Google Ads. Nie zostaną też utworzone zasoby 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 wszystkie niestandardowe linki AssetGroupAsset w jednym żądaniu.

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 obiekcie AssetGroup ustawiono co najmniej 1 komponent final_urls (najpierw go wypełniając, 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.