Dołącz do nas na żywo na Discordzie 15 października o 16:00 czasu polskiego na serwerze społeczności Google Advertising and Measurement oraz na YouTube. Omówimy nowe funkcje dodane w wersji 26 interfejsu Google Ads API.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Przekształcanie kampanii inteligentnych w kampanie Performance Max

W wersji v25 i nowszych możesz użyć metody SmartCampaignSettingService.GeneratePMaxDraftCampaign, aby przekształcić kampanię inteligentną w kampanię Performance Max. Ta metoda nie jest dostępna w wersji v24 i starszych.

Jak działa konwersja

Gdy wywołasz metodę SmartCampaignSettingService.GeneratePMaxDraftCampaign, interfejs API wygeneruje roboczą kampanię Performance Max, budżet, grupę plików i komponenty na podstawie konfiguracji kampanii inteligentnej podanej w żądaniu. Po wygenerowaniu nowych zasobów należy je sprawdzić, zmodyfikować i ulepszyć, zanim włączysz kampanię do wyświetlania reklam.

Wygenerowana robocza kampania Performance Max jest inicjowana z tymi wartościami stanu:

status jest ustawiony na PAUSED.
Jej kwalifikowanie się do wyświetlania jest odzwierciedlone w primary_status.
contains_eu_political_advertising jest domyślnie ustawione na DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING (jeśli nie zostało już określone w kampanii inteligentnej). Sprawdź i zaktualizuj to pole, jeśli Twoja kampania zawiera reklamy polityczne w UE.

Dzięki temu możesz sprawdzić, zmodyfikować i ulepszyć wygenerowaną kampanię Performance Max, budżet, grupę plików i komponenty, zanim włączysz kampanię do wyświetlania reklam.

Wersje robocze komponentów

Nowej kampanii towarzyszy grupa obrazów zastępczych, które należy zastąpić, zanim nowa kampania zostanie włączona. Gdy pole image_enabled jest obsługiwane i w żądaniu ma wartość true, interfejs API automatycznie generuje obrazy zamiast używać obrazów zastępczych. Nowe komponenty możesz sprawdzić w polu assets odpowiedzi i zastąpić je, wykonując te czynności:

Zapoznaj się z przewodnikiem po wymaganiach dotyczących komponentów.
Prześlij nowe obrazy, korzystając z przykładu przesyłania komponentu z obrazem.
Połącz nowe komponenty z grupą plików roboczej wersji kampanii, a następnie usuń AssetGroupAsset linki do obrazów zastępczych (w tym samym atomowym żądaniu modyfikacji lub po połączeniu nowych komponentów, aby zachować minimalne wymagania dotyczące komponentów) zgodnie z przewodnikiem po łączeniu grup plików z komponentami.

Parametry żądania

Komunikat GeneratePMaxDraftCampaignRequest akceptuje te pola:

resource_name (Wymagane): nazwa zasobu SmartCampaignSetting, który ma zostać wygenerowany ponownie w przypadku kampanii inteligentnej, którą chcesz przekształcić, w tym formacie:
```
customers/customer_id/smartCampaignSettings/campaign_id
```
validate_only (Opcjonalne): jeśli ma wartość true, żądanie jest sprawdzane, ale nie wykonywane. W polu validated_info odpowiedzi zwracane są tylko błędy, ostrzeżenia lub możliwe problemy z konwersją bez tworzenia roboczych encji.
gbp_enabled (Nieobsługiwane): opcjonalne. Czy przekonwertować lokalizację profilu firmy w Google połączoną z kampanią Performance Max. Pozostaw to pole nieustawione lub false; ustawienie go na true nie jest obsługiwane i zwraca błąd SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
image_enabled (Nieobsługiwane): opcjonalne. Czy wygenerować wymagane obrazy kampanii Performance Max (np. poziome, kwadratowe i logo). Pozostaw to pole nieustawione lub false; ustawienie go na true nie jest obsługiwane i zwraca błąd SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Szczegóły odpowiedzi

Komunikat GeneratePMaxDraftCampaignResponse zwraca nazwy zasobów wygenerowanej roboczej kampanii Performance Max i powiązanych z nią encji:

pmax_campaign: nazwa zasobu Campaign wygenerowanej roboczej kampanii Performance Max.
campaign_budget: nazwa zasobu CampaignBudget połączonego z wygenerowaną kampanią Performance Max.
asset_group: nazwa zasobu AssetGroup połączonego z wygenerowaną kampanią Performance Max.
assets: lista nazw zasobów Asset połączonych z wygenerowaną kampanią Performance Max.
validated_info: informacje o sprawdzaniu poprawności lub możliwe problemy z konwersją zwracane przez sprawdzenie konwersji (wypełniane zarówno wtedy, gdy validate_only ma wartość true, jak i obok nazw zasobów wygenerowanych encji, gdy validate_only ma wartość false).

Zalecany przepływ pracy

Aby przekształcić kampanię inteligentną, wykonaj te czynności:

Wygeneruj roboczą kampanię: wywołaj metodę SmartCampaignSettingService.GeneratePMaxDraftCampaign , ustawiając tylko wymagane pole resource_name (pozostaw pola gbp_enabled i image_enabled nieustawione lub ustaw na false). Zapisz zwrócone nazwy zasobów pmax_campaign, campaign_budget, asset_group i assets.
Sprawdź i dostosuj kampanię: ponieważ robocza kampania Performance Max jest tworzona ze stanem status = PAUSED i creation_status = INCOMPLETE, sprawdź i skonfiguruj jej budżet, grupę plików i komponenty.
Włącz kampanię i wstrzymaj pierwotną: gdy wszystko będzie gotowe do wyświetlania reklam, zmień stan kampanii Performance Max status na ENABLED, a następnie zmień stan pierwotnej kampanii inteligentnej status na PAUSED, aby zapobiec duplikowaniu wyświetlania.