Przekształcanie kampanii inteligentnych w kampanie Performance Max

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 zasobu SmartCampaignSetting, który ma zostać ponownie wygenerowany w przypadku kampanii inteligentnej, którą chcesz przekonwertować, w tym formacie:

    customers/customer_id/smartCampaignSettings/campaign_id
    
  • validate_only (opcjonalny): jeśli true, żądanie jest weryfikowane, ale nie wykonywane. W odpowiedzi w polu validated_info zwracane 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 na false. Ustawienie go na true nie jest zaimplementowane w v25 i zwraca błąd SmartCampaignError.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 na false. Ustawienie go na true nie jest zaimplementowane w v25 i zwraca błąd SmartCampaignError.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 zasobu Campaign wygenerowanej wersji roboczej kampanii Performance Max.
  • campaign_budget: nazwa zasobu CampaignBudget powiązana z wygenerowaną kampanią Performance Max.
  • asset_group: nazwa zasobu AssetGroup połączona z wygenerowaną kampanią Performance Max.
  • assets: lista nazw zasobów Asset połą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 parametr validate_only ma wartość true, jak i obok wygenerowanych nazw zasobów encji, gdy parametr validate_only ma wartość false).

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

  1. Wygeneruj roboczą wersję kampanii: wywołaj SmartCampaignSettingService.GeneratePMaxDraftCampaign tylko z wymaganym parametrem resource_name (pozostaw parametry gbp_enabled i image_enabled bez ustawienia lub ustaw 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 za pomocą status = PAUSED, sprawdź i skonfiguruj jej budżet, grupę plików i komponenty.
  3. Włącz kampanię i wstrzymaj pierwotną: gdy będziesz gotowy(-a) do wyświetlania reklam, zmień stan kampanii Performance Max z status na ENABLED, a następnie zmień stan pierwotnej kampanii inteligentnej z status na PAUSED, aby zapobiec wyświetlaniu duplikatów.