W tym przewodniku szczegółowo opisujemy wiele skomplikowanych działań związanych z tworzeniem i aktualizowaniem kampanii Performance Max. Może się przydać przy projektowaniu integracji. Z tego przewodnika dowiesz się, jak są przetwarzane żądania, które modyfikują kampanie Performance Max, i mogą służyć jako zasoby towarzyszące podane w przewodniku po rozwiązywaniu problemów z kampaniami Performance Max i w poradniku dotyczącym przetwarzania wsadowego w kampaniach Performance Max.
Utwórz kampanie Performance Max
W interfejsie Google Ads API elementy kampanii Performance Max są przedstawione jako połączenie kilku unikalnych zasobów.
Standardowe kampanie Performance Max
Standardowe kampanie Performance Max wymagają minimalnego zestawu zasobów do wyświetlania reklam.
Pamiętaj, że operacje tworzenia elementów AssetGroup
i AssetGroupAsset
muszą zostać uwzględnione razem w jednym żądaniu, a zasoby AssetGroupAsset
muszą łączyć się tak, aby spełniały wszystkie minimalne wymagania dotyczące komponentów i specyfikacje. Zobacz, czym różni się to w przypadku kampanii detalicznych. Żądania utworzenia obiektu AssetGroup
bez wszystkich wymaganych elementów AssetGroupAsset
skutkują błędem. Więcej informacji o tym znajdziesz w sekcji Nieprawidłowy stan a nieprawidłowe żądania.
Istnieją różne opcje tworzenia struktury żądań, które tworzą kampanie Performance Max. Decyzja o sposobie grupowania operacji i struktury żądań zależy w dużej mierze od Twoich celów i infrastruktury.
- Utwórz zasoby
CampaignBudget
,Campaign
iAsset
w osobnych żądaniach przed utworzeniem zasobówAssetGroup
iAssetGroupAsset
. - Uwzględnij wszystkie te zasoby w jednym żądaniu mutacji.
Możesz utworzyć zasoby CampaignBudget
, Campaign
i Asset
w osobnych wcześniejszych żądaniach, ale kampania Performance Max nie będzie mogła wyświetlać reklam, dopóki nie utworzysz też zasobów AssetGroup
i AssetGroupAsset
.
Wymagania minimalne dotyczące prawidłowej kampanii Performance Max
Kampanie Performance Max możesz jeszcze bardziej dostosowywać, tworząc dodatkowe zasoby, tak jak na ilustracji.
W tym samym żądaniu, które tworzy zasoby AssetGroup
i AssetGroupAsset
, możesz dodać operacje tworzenia zasobów AssetGroupSignal
.
Elementy AssetGroupSignal
możesz też utworzyć w osobnej prośbie po utworzeniu AssetGroup
.
Kampania Performance Max z dodatkowymi opcjami
Kampanie Performance Max dla branży handlu detalicznego
Kampanie detaliczne wyróżniają się tym, że istnieją 2 różne sposoby tworzenia grup plików, które prowadzą do prawidłowego wyświetlania kampanii:
- Grupy plików bez komponentów
- Grupy plików zawierające WSZYSTKIE wymagane komponenty (zalecane)
Jeśli zdecydujesz się wykluczyć komponenty z grup plików, Google automatycznie utworzy reklamy na podstawie komponentów przesłanych na połączonym koncie Merchant Center. Zalecamy jednak przesłanie komponentów, które będą obejmować wszystkie zasoby reklamowe. Kampanie Performance Max dla sprzedawców detalicznych wymagają tego minimalnego zestawu zasobów, aby mogły wyświetlać reklamy.
CampaignBudget
Campaign
(z wypełnionym polemShoppingSettings
)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 odpowiadać adresom URL powiązanym z identyfikatorem konta Merchant Center określonym w dokumencie Campaign.shopping_settings
. Każdy element AssetGroup
musi też mieć powiązane, prawidłowe drzewo grup informacji o produktach, które składa się z co najmniej 1 zasobu AssetGroupListingGroupFilter
. Musisz utworzyć co najmniej 1 drzewo węzła do uwzględnienia wszystkich produktów w określonym 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 detalicznej Performance Max
W kampaniach detalicznych dostępne są wszystkie opcje dostępne w standardowych kampaniach Performance Max, m.in. tworzenie sygnałów grup plików, celów konwersji kampanii i kryteriów kampanii. Jeśli podczas tworzenia zasobu AssetGroup
zdecydujesz się dodać zasoby do AssetGroup
, Twój AssetGroup
będzie spełniać minimalne wymagania dotyczące zasobów. Inaczej mówiąc, możesz nie uwzględnić
żadnych komponentów albo wszystkie wymagane zasoby.
Kampania Performance Max służąca do promowania sprzedaży detalicznej z dodatkowymi opcjami
Nieprawidłowy stan a nieprawidłowe żądania
W przypadku kampanii Performance Max za pomocą interfejsu Google Ads API istnieje istotna różnica między nieprawidłowymi stanami a nieprawidłowymi żądaniami.
- Nieprawidłowy stan
- Kampania nie kwalifikuje się do wyświetlania reklam ze względu na jej konfigurację. Możesz na przykład utworzyć samodzielny zasób
Campaign
z wartościąadvertising_channel_type
o wartościPERFORMANCE_MAX
. Chociaż żądanie utworzenia kampanii się uda, nie będzie mogła wyświetlać reklam, dopóki nie dodasz do kampanii co najmniej 1 elementuAssetGroup
. Jeśli Twoje żądania zostaną zrealizowane, ale kampania lub grupy komponentów nie będą się wyświetlać, możesz użyćCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
iAssetGroupPrimaryStatusReason
, aby określić przyczynę, zgodnie z informacjami podanymi w przewodniku na temat rozwiązywania problemów. - Nieprawidłowe żądanie
- Żądanie, które nie zostałoby zrealizowane, ponieważ stan kampanii lub zasobu spowodowałoby ich nieprawidłowy stan. Interfejs Google Ads API zgłasza błąd, jeśli np. próbujesz utworzyć identyfikator
AssetGroup
na potrzeby kampanii innej niż handel detaliczny bez uwzględnienia minimalnej wymaganej liczby zasobów. Właśnie dlatego w tym samym żądaniu musisz uwzględnić zasóbAssetGroup
i jego zasobyAssetGroupAsset
. Oznacza to też, że wszystkie zasobyAssetGroupAsset
muszą spełniać prawidłowe specyfikacje w przypadku danego elementufield_type
, aby zapobiec odrzuceniu całego żądania.
Operacje grupowe z żądaniami mutacji
Kampanie Performance Max składają się z wielu zasobów, które możesz utworzyć w ramach unikalnych żądań lub w pojedynczym żądaniu zmiany zbiorczej. Jednak element AssetGroups
i powiązane z nim AssetGroupAssets
w standardowych kampaniach Performance Max trzeba utworzyć w pojedynczym żądaniu, jak już podano.
Twoja kampania nie będzie wyświetlać reklam, dopóki nie utworzysz wszystkich wymaganych materiałów wymienionych w tym przewodniku. Wysyłając oddzielne żądania, w kolejnych żądaniach używaj rzeczywistych nazw zasobów w odniesieniu do przywołanych zasobów. Wysyłając żądania zbiorcze mutacji, które zawierają wiele operacji, używaj nazw zasobów utworzonych przy użyciu 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 żądań zbiorczej mutacji oznacza to uporządkowanie operacji w taki sposób, że odwołania do zasobów są wymienione przed zasobami, które się do nich odwołują.
Jeśli zdecydujesz się utworzyć zasoby zasobów w ramach tego samego żądania zbiorczej mutacji, które tworzy zasób AssetGroup
i jego zasoby AssetGroupAsset
, wszystkie zasoby AssetOperations
powinny znajdować się przed wszystkimi obiektami AssetGroupAssetOperations
, jak pokazano na diagramie.
Serwer Google Ads zbiera razem kolejne elementy AssetGroupAssetOperations
i ocenia, czy po ostatniej operacji w tej grupie AssetGroup
spełnia minimalne wymagania dotyczące zasobów. Jeśli w żądaniu będziesz przełączać się między AssetOperations
i AssetGroupAssetOperations
, serwer interfejsu API oceni minimalne wymagania dotyczące zasobów po pierwszym AssetGroupAssetOperation
i zwróci błąd bez wykonywania pozostałych operacji w żądaniu. W efekcie żaden z komponentów z prośby nie zostanie dodany do Twojego konta Google Ads. Nie zostanie utworzony zasób AssetGroup
ani żaden z powiązanych zasobów AssetGroupAsset
.
Zaktualizuj grupy plików
Po utworzeniu prawidłowego obiektu AssetGroup
nie możesz już wysyłać kolejnych żądań, w wyniku których minimalne wymagania dotyczące zasobów nie będą już spełnione. Każde takie żądanie powoduje wyświetlenie błędu. Jeśli np. utworzysz AssetGroup
z pojedynczym elementem MARKETING_IMAGE
(wymagania minimalne), wszelkie żądania usunięcia obiektu AssetGroupAsset
powiązanego z tym elementem MARKETING_IMAGE
będą zwracać błąd.
Jest to szczególnie ważne w przypadku grup komponentów w kampaniach detalicznych, które zostały utworzone bez powiązanych komponentów. Kolejne prośby o dodanie zasobów do AssetGroup
przez utworzenie zasobów AssetGroupAsset
zakończą się powodzeniem tylko wtedy, gdy będą spełnione wszystkie wymagania dotyczące zasobów. Inaczej mówiąc, nie możesz dodawać komponentów do tych grup stopniowo.