W v25 (od v25.2) możesz użyć metody
SmartCampaignSettingService.GeneratePMaxDraftCampaign
do przekształcenia kampanii inteligentnej w kampanię Performance Max. Ta metoda nie jest dostępna w przypadku wersji v24 i starszych.
Jak działa konwersja
Gdy wywołasz
SmartCampaignSettingService.GeneratePMaxDraftCampaign,
interfejs API wygeneruje roboczą kampanię Performance Max na podstawie konfiguracji
kampanii inteligentnej.
Wygenerowana wersja robocza kampanii Performance Max jest inicjowana z ustawieniem status na PAUSED (a jej kwalifikowalność do wyświetlania reklam jest odzwierciedlona w ustawieniu primary_status). Jeśli wszystkie konwertery funkcji nie przejdą weryfikacji w przypadku kampanii inteligentnej, żądanie zakończy się niepowodzeniem z błędem SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.
Dzięki temu możesz sprawdzić, zmodyfikować i ulepszyć wygenerowaną kampanię Performance Max, budżet, grupę plików i komponenty, zanim włączysz wyświetlanie reklam w tej kampanii. Wygenerowanie wersji roboczej kampanii Performance Max nie powoduje modyfikacji ani wstrzymania pierwotnej kampanii inteligentnej, która pozostaje aktywna do momentu, gdy ręcznie ją wstrzymasz.
Parametry żądania
Wiadomość GeneratePMaxDraftCampaignRequest akceptuje te pola:
resource_name(wymagany): nazwa zasobuSmartCampaignSetting, który ma zostać ponownie wygenerowany w przypadku kampanii inteligentnej, którą chcesz przekonwertować, w tym formacie:customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(opcjonalny): jeślitrue, żądanie jest weryfikowane, ale nie wykonywane. W odpowiedzi w poluvalidated_infozwracane są tylko błędy sprawdzania poprawności, ostrzeżenia lub możliwe problemy z konwersją bez tworzenia wersji roboczych obiektów.gbp_enabled(Nieobsługiwane): opcjonalny. Określa, czy przekonwertować lokalizację Profilu Firmy w Google połączoną z kampanią Performance Max. Pozostaw to pole nieskonfigurowane lub ustaw nafalse. Ustawienie go natruenie jest zaimplementowane wv25i zwraca błądSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.image_enabled(Nieobsługiwane): opcjonalny. Określa, czy generować wymagane obrazy do kampanii Performance Max (np. obrazy poziome, kwadratowe i logo). Pozostaw to pole nieskonfigurowane lub ustaw je nafalse. Ustawienie go natruenie jest zaimplementowane wv25i zwraca błądSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
Szczegóły odpowiedzi
Wiadomość GeneratePMaxDraftCampaignResponse zwraca nazwy zasobów wygenerowanej roboczej wersji kampanii Performance Max i powiązanych z nią elementów:
pmax_campaign: nazwa zasobuCampaignwygenerowanej wersji roboczej kampanii Performance Max.campaign_budget: nazwa zasobuCampaignBudgetpowiązana z wygenerowaną kampanią Performance Max.asset_group: nazwa zasobuAssetGrouppołączona z wygenerowaną kampanią Performance Max.assets: lista nazw zasobówAssetpołączonych z wygenerowaną kampanią Performance Max.validated_info: informacje o weryfikacji lub potencjalne problemy z konwersją zwrócone przez sprawdzenie konwersji (wypełniane zarówno wtedy, gdy parametrvalidate_onlyma wartośćtrue, jak i obok wygenerowanych nazw zasobów encji, gdy parametrvalidate_onlyma wartośćfalse).
Zalecany przepływ pracy
Aby przekształcić kampanię inteligentną, wykonaj te czynności:
- Wygeneruj roboczą wersję kampanii: wywołaj
SmartCampaignSettingService.GeneratePMaxDraftCampaigntylko z wymaganym parametremresource_name(pozostaw parametrygbp_enablediimage_enabledbez ustawienia lub ustaw nafalse). Zapisz zwrócone nazwy zasobówpmax_campaign,campaign_budget,asset_groupiassets. - Sprawdź i dostosuj kampanię: ponieważ wersja robocza kampanii Performance Max została utworzona za pomocą
status = PAUSED, sprawdź i skonfiguruj jej budżet, grupę plików i komponenty. - Włącz kampanię i wstrzymaj pierwotną: gdy będziesz gotowy(-a) do wyświetlania reklam, zmień stan kampanii Performance Max z
statusnaENABLED, a następnie zmień stan pierwotnej kampanii inteligentnej zstatusnaPAUSED, aby zapobiec wyświetlaniu duplikatów.