Przekształcanie kampanii inteligentnych w kampanie Performance Max

W wersji v25 i nowszych możesz używać 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 wersję roboczą kampanii Performance Max, budżet, grupę plików i komponenty na podstawie konfiguracji kampanii inteligentnej podanej w żądaniu. Po wygenerowaniu nowych zasobów sprawdź je, zmodyfikuj i ulepsz, zanim włączysz kampanię, aby wyświetlać reklamy.

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

• Wartość status jest ustawiona na PAUSED.
• Możliwość wyświetlania jest widoczna w kolumnie primary_status.
• contains_eu_political_advertising jest domyślnie ustawiona na DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING (jeśli nie została już określona w kampanii inteligentnej). Jeśli Twoja kampania zawiera reklamy polityczne w UE, sprawdź i zaktualizuj to pole.

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

Wersje robocze komponentów

Nowej kampanii towarzyszy grupa obrazów zastępczych, które należy zastąpić przed jej włączeniem. Gdy pole image_enabled jest obsługiwane i ustawione na true w żądaniu, interfejs API automatycznie generuje obrazy zamiast używać obrazów zastępczych. Nowe zasoby możesz sprawdzić w polu assets odpowiedzi i zastąpić je, wykonując te czynności:

1. Zapoznaj się z przewodnikiem po wymaganiach dotyczących komponentów.
2. Prześlij nowe obrazy, postępując zgodnie z przykładem przesyłania komponentu z obrazem.
3. Połącz nowe komponenty z grupą plików kampanii roboczej, a następnie usuń AssetGroupAsset linki do obrazów zastępczych (w tym samym żądaniu modyfikacji niepodzielnej lub po połączeniu nowych komponentów, aby nadal były spełnione minimalne wymagania dotyczące komponentów). Aby to zrobić, postępuj zgodnie z instrukcjami łączenia grup plików z komponentami.

Parametry żądania

Uwaga: parametry gbp_enabled i image_enabled nie są obsługiwane i powodują błędy, jeśli w żądaniu mają wartość true. Pozostaw oba pola nieustawione lub ustaw je na false.

Komunikat GeneratePMaxDraftCampaignRequest akceptuje te pola:

• resource_name (wymagany): nazwa zasobu SmartCampaignSetting, który chcesz ponownie wygenerować na potrzeby kampanii inteligentnej, którą chcesz przekonwertować, w tym formacie:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (opcjonalny): jeśli ma wartość true, żądanie jest sprawdzane, ale nie jest wykonywane. W polu validated_info odpowiedzi zwracane są tylko błędy weryfikacji, ostrzeżenia lub możliwe problemy z konwersją bez tworzenia elementów wersji roboczej.

• gbp_enabled (Nieobsługiwane): opcjonalny. Czy przekształcić lokalizację w Profilu Firmy w Google połączoną z kampanią Performance Max. Pozostaw to pole nieskonfigurowane lub ustaw na false. Ustawienie go na true nie jest obsługiwane i zwraca błąd SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (nieobsługiwany): opcjonalny. Określa, czy generować wymagane obrazy do kampanii Performance Max (np. obrazy poziome, kwadratowe i logo). Pozostaw to pole nieskonfigurowane lub ustaw na 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 wersji roboczej kampanii Performance Max i powiązanych z nią elementów:

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

Zalecany przepływ pracy

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

1. Wygeneruj wersję roboczą kampanii: wywołaj metodę SmartCampaignSettingService.GeneratePMaxDraftCampaign, ustawiając tylko wymagane pole resource_name (pozostaw pola gbp_enabled i image_enabled nieustawione lub ustaw je na false). Zapisz zwrócone nazwy zasobów pmax_campaign, campaign_budget, asset_group i assets.
2. Sprawdź i dostosuj kampanię: ponieważ wersja robocza kampanii Performance Max została utworzona z użyciem status = PAUSED i creation_status = INCOMPLETE, sprawdź i skonfiguruj jej budżet, grupę plików i pliki.
3. Włącz kampanię i wstrzymaj pierwotną: gdy chcesz zacząć wyświetlać reklamy, zmień stan kampanii Performance Max (status) na ENABLED, a następnie zmień stan pierwotnej kampanii inteligentnej (status) na PAUSED, aby zapobiec wyświetlaniu duplikatów.

Uwaga: gdy w przyszłej wersji zostaną włączone funkcje gbp_enabled i image_enabled, będzie można też automatycznie przenosić lokalizacje z profilu firmy w Google i komponenty z obrazem.