Żądania na poziomie struktury

W tym przewodniku szczegółowo opisujemy wiele skomplikowanych procesów tworzenia struktury, i aktualizować kampanie Performance Max. Mogą być również przydatne podczas projektowania z integracją. Z tego przewodnika dowiesz się, jak żądania modyfikują kampanię Performance Max są przetwarzane i mogą być zasobem towarzyszącym kampanii Performance Max Przewodnika rozwiązywania problemów oraz Przewodnik po przetwarzaniu wsadowym w kampaniach Performance Max

Utwórz kampanie Performance Max

W interfejsie Google Ads API elementy kampanii Performance Max są przedstawiane jako dzięki połączeniu kilku unikalnych zasobów.

Standardowe kampanie Performance Max

Standardowe kampanie Performance Max wymagają minimalnego zestawu zasobów wyświetlić.

• Budżet kampanii
• Kampania
• Grupy plików
• Komponenty w grupie plików
• Assets

Warto zauważyć, że operacje tworzenia AssetGroup oraz AssetGroupAsset elementy muszą zostać uwzględnione razem w jednym żądaniu. zasoby typu AssetGroupAsset muszą połączyć się, aby spełnić wszystkie minimalne wymagania dotyczące zasobów wymagania i specyfikacje; czym różni się Kampanie detaliczne. Prośby do utworzenia AssetGroup bez wszystkich wymaganych elementów AssetGroupAsset skutkuje wartością error; zobacz Nieprawidłowy stan a nieprawidłowe żądania .

Istnieją różne możliwości tworzenia struktury żądań, które tworzą Kampanie Performance Max. Decyzja o sposobie grupowania operacji w dużej mierze zależą od celów i infrastruktury.

• Utwórz zasoby CampaignBudget, Campaign i Asset oddzielnie przed utworzeniem zasobów AssetGroup i AssetGroupAsset.
• Uwzględnij wszystkie te zasoby w jednym żądaniu mutacji.

Możesz utworzyć CampaignBudget, Campaign i Asset w osobnych wcześniejszych żądaniach, kampania Performance Max nie zostanie może być wyświetlana do czasu, aż zasoby AssetGroup i AssetGroupAsset będą również stworzona przez nas.

Wymagania minimalne dotyczące prawidłowej kampanii Performance Max

Możesz jeszcze bardziej dostosować kampanie Performance Max, tworząc dodatkowe zasobów, jak widać na schemacie.

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

Możesz dodać operacje tworzenia AssetGroupSignal zasobów w tym samym które tworzy zasoby AssetGroup i AssetGroupAsset. Możesz też utworzyć elementy typu AssetGroupSignal w osobnym żądaniu po utworzeniu AssetGroup.

Kampania Performance Max z dodatkowymi opcjami

Kampanie Performance Max dla branży handlu detalicznego

Kampanie sprzedażowe są wyjątkowe, ponieważ 2 oddzielne sposoby tworzenia grup komponentów, które zapewniają prawidłowe wyświetlanie kampania:

• 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 użyje komponentów przesłanych w dokumencie połączone konto Merchant Center, aby utworzyć reklam. Zalecamy jednak przesłanie komponentów, które będą obejmować wszystkie zasoby reklamowe. Kampanie Performance Max dla branży handlu detalicznego wymagają tego minimalnego zestawu: zasobów, aby wyświetlać reklamy.

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

Pamiętaj, że pole Campaign.shopping_settings musi zawierać w kampaniach detalicznych. Dodatkowo final_urls wymienione w każdym Wartość AssetGroup musi odpowiadać adresom URL powiązanym z identyfikatorem konta Merchant Center określone w Campaign.shopping_settings. Na koniec każde pole AssetGroup musi mają powiązane, prawidłowe drzewo grup informacji o produktach złożone z co najmniej jednego AssetGroupListingGroupFilter zasobów. Musisz utworzyć co najmniej jeden drzewo węzłów uwzględniające wszystkie produkty z określonego pliku danych Merchant Center.

Każdy z tych zasobów można utworzyć oddzielnie lub w pojedynczym żądaniu. Reklamy z kampanii będą się wyświetlać dopiero wtedy, gdy te zasoby czy zostały poprawnie utworzone.

Minimalne wymagania dotyczące prawidłowej kampanii detalicznej Performance Max

Kampanie detaliczne mogą korzystać ze wszystkich opcji dostępnych w kampaniach standardowych Kampanie Performance Max, w tym tworzenie sygnałów dotyczących grup plików, kampania celów konwersji i kryteriów kampanii. Jeśli zdecydujesz się dodać zasoby do AssetGroup podczas tworzenia zasobu AssetGroup, AssetGroup to zgodnie z minimalnymi wymaganiami dotyczącymi komponentów. Innymi słowy, możesz albo nie może zawierać żadnych zasobów lub nie uwzględniać wszystkich wymaganych zasobów.

Kampania Performance Max służąca do promowania sprzedaży detalicznej z dodatkowymi opcjami

Nieprawidłowy stan a nieprawidłowe żądania

Podczas pracy z kampaniami Performance Max za pomocą interfejsu Google Ads API ważna rozróżnienie 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ę. Dla: możesz na przykład utworzyć samodzielny zasób Campaign z parametrem advertising_channel_type z PERFORMANCE_MAX. Chociaż prośba o utworzenie kampania się powiedzie, nie będzie mogła wyświetlać reklam, dopóki nie dodasz co najmniej jednej AssetGroup do kampanii. Jeśli żądania są realizowane, ale kampania lub grupy plików się nie wyświetlają, możesz użyć CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus i AssetGroupPrimaryStatusReason w celu określenia przyczyny, zgodnie z opisem w rozwiązywanie problemów

Nieprawidłowe żądanie

Żądanie, które nie zostanie zrealizowane, ponieważ spowodowałoby wyświetlenie kampanii lub zmieni się na nieprawidłowy stan. Interfejs Google Ads API zgłasza np. błąd, jeśli spróbuj utworzyć AssetGroup dla kampanii niezwiązanej z handlem detalicznym bez dodawania minimalne wymagane zasoby. To jest dlaczego należy umieścić nagłówek AssetGroup i jego zasoby AssetGroupAsset w to samo żądanie. Oznacza to również, że wszystkie Twoje zasoby AssetGroupAsset muszą są zgodne ze specyfikacją danego elementu field_type, aby zapobiec nie została odrzucona.

Operacje grupowe z żądaniami mutacji

Kampanie Performance Max składają się z wielu zasobów, aby utworzyć te oddzielne zasoby w unikalnych żądaniach lub w pojedynczym żądanie zbiorczej modyfikacji. Jednak AssetGroups i powiązane ze sobą AssetGroupAssets w standardowych kampaniach Performance Max muszą być utworzone w pojedynczym żądaniu, jak już wspomniano.

Twoja kampania nie będzie wyświetlać reklam, dopóki nie utworzysz wszystkich wymagane zasoby wymienione w tym przewodniku. W przypadku wystawiania oddzielnych , użyj rzeczywistych nazw zasobów w odniesieniu do kolejnych żądań. Przy wysyłaniu żądań zbiorczych mutacji zawierających wiele operacji użyj nazwy zasobów utworzone za pomocą identyfikatorów tymczasowych.

Kolejność działań

Niezależnie od tego, czy do utworzenia kampanii Performance Max używasz żądania zmiany zbiorczej zgodnie z zasadami kampanii należy zamawiać żądania i działania w taki sposób, aby nigdy odwołuje się do zasobu przed jego utworzeniem. W przypadku mutacji zbiorczej żądań, oznacza to uporządkowanie działań w taki sposób, zasoby 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 modyfikacji, tworzy obiekt AssetGroup i jego zasoby AssetGroupAsset, wszystkie Pole AssetOperations powinno znajdować się przed wszystkimi elementami AssetGroupAssetOperations, ponieważ co pokazuje to na schemacie.

Serwer Google Ads grupuje następujące po sobie elementy (AssetGroupAssetOperations) i ocenia, czy AssetGroup spełnia minimalne wymagania dotyczące zasobów po ostatnią operację w tej grupie. Jeśli będziesz przełączać się między AssetOperations i AssetGroupAssetOperations w żądaniu, serwer interfejsu API oceni minimalne wymagania dotyczące zasobów po pierwszych AssetGroupAssetOperation i zwróci błąd bez kontynuowania pozostałych operacji w użytkownika. W rezultacie żaden z komponentów z żądania nie zostanie dodany do Twojego konta. koncie Google Ads. Poza tym ani AssetGroup, ani żaden z powiązanych Zostaną utworzone AssetGroupAsset zasoby.

Zaktualizuj grupy plików

Po utworzeniu prawidłowego AssetGroup nie możesz już wysyłać kolejnych próśb który spowodowałby nieprawidłowy stan, w którym minimalne wymagania dotyczące zasobów nie są już spełnione. Każde takie żądanie powoduje wyświetlenie błędu. Jeśli na przykład utwórz element AssetGroup z pojedynczym elementem MARKETING_IMAGE (wymagania minimalne)), wszelkie prośby o usunięcie tych zasad (AssetGroupAsset). jest powiązany z tym elementem MARKETING_IMAGE.

Jest to szczególnie ważne w przypadku grup plików w kampaniach handlu detalicznego. utworzony bez powiązanych zasobów. Kolejne prośby o dodanie zasobów do AssetGroup dzięki utworzeniu AssetGroupAsset zasobów zakończy się powodzeniem tylko wtedy, gdy spełnia wszystkie wymagania dotyczące komponentów. Inaczej mówiąc, nie możesz dodawać komponentów do te grupy plików.