Ogłaszamy wersję 24 interfejsu Google Ads API

Środa, 22 kwietnia 2026 r.

Ogłaszamy dziś wydanie wersji 24 interfejsu Google Ads API. Aby korzystać z nowych funkcji w wersji 24, musisz uaktualnić biblioteki klienta i kod klienta. Opublikowaliśmy wszystkie zaktualizowane biblioteki klienta i przykłady kodu.

Dołącz do nas, aby zobaczyć prezentację na żywo tej wersji podczas wydarzenia „Najważniejsze informacje o interfejsie Google Ads API” na Discordzie, transmisji Ads Developers na YouTube na żywo lub wydarzenia na żywo na LinkedInie, które odbędzie się jutro (23 kwietnia o godz. 10:00 czasu ET). To wydarzenie również zostanie nagrane i opublikowane na YouTube dla tych, którzy nie mogą wziąć udziału w wydarzeniach na żywo. Jeśli masz pytania lub chcesz omówić ten post, skontaktuj się z nami na kanale #ads-api na Discordzie.

Nowe funkcje

Obsługa konwersji z danymi koszyka: konwersje z danymi koszyka poszerzają zakres śledzenia konwersji w Twojej witrynie lub aplikacji. Korzystając z konwersji z danymi koszyka, możesz podawać szczegóły dotyczące produktów sprzedanych w ramach poszczególnych transakcji. Dzięki temu zyskujesz na swoim koncie i w kampaniach Google Ads dostęp do zaawansowanych funkcji sprzedaży, raportowania zysków oraz do statystyk, takich jak liczba zamówień, średnia wielkość koszyka, przychody i zysk brutto.

Interfejs Google Ads API w wersji 24 obsługuje tę funkcję w następujący sposób:

  • Dodaliśmy nowy zasób CartDataSalesView, który umożliwia segmentowanie danych o konwersjach nie tylko według klikniętego produktu, ale też według sprzedanego produktu, za pomocą segmentów takich jak product_sold_brand. Dzięki temu reklamodawcy mogą wyświetlać statystyki dotyczące produktów, które klienci faktycznie kupili po kliknięciu reklamy, nawet jeśli reklama dotyczyła innego produktu.
  • Dodaliśmy kilka „wszystkich” danych nieużywanych do określania stawek, które obejmują też konwersje, pod których kątem kampanie nie są aktywnie optymalizowane, np. all_cost_of_goods_sold_micros. Nowe dane są dodawane do wszystkich zasobów obsługujących odpowiednie dane podlegające określeniu stawki.
  • Dodaliśmy segment conversion_attribution_event_type do zasobu ShoppingPerformanceView, dzięki czemu można go wybrać z danymi koszyka i innymi danymi konwersji. Ten segment wskazuje, czy konwersja jest przypisana do kliknięcia czy do wyświetlenia. Jest on niezbędny do rozpoznawania statystyk danych koszyka generowanych przez konwersje po wyświetleniu.

Zaktualizowane funkcje

Wersja v24 wprowadza aktualizacje dotychczasowych funkcji, które wymagają zmian w kodzie podczas uaktualniania. Tutaj opisujemy najważniejsze z nich. Pełną listę zmian znajdziesz w informacjach o wersji.

Ustawienia wykluczeń treści wideo w kampaniach: uprościliśmy konfigurowanie ustawień wykluczeń treści wideo w poszczególnych kampaniach. To ustawienie jest dostępne na poziomie klienta i dotyczy wszystkich kampanii. Te ustawienia wykluczania treści zapewniają dodatkową kontrolę i pomagają w wykluczaniu rodzajów treści, które są zgodne z naszymi zasadami, ale mogą być nieodpowiednie dla Twojej marki lub działalności. Więcej informacji o ustawieniach wykluczeń treści wideo znajdziesz na stronie https://support.google.com/google-ads/answer/7515513.

Zmiany w AudienceInsightsService: w ramach refaktoryzacji kodu przenieśliśmy pole żądania InsightsAudience.topic_audience_combinations do przestrzeni nazw common. W niektórych językach programowania może być konieczne zaktualizowanie dyrektyw importu.

Zmiany w ReachPlanService: w ramach refaktoryzacji kodu przenieśliśmy pole youtube_select_lineups z usługi ReachPlanService.ListPlannableProducts. Grupy najpopularniejszych kanałów są teraz dostępne w polu youtube_select_lineup_targeting. Lineupy YouTube Select to usługi z rezerwacją dostępne dla kwalifikujących się klientów, które są kierowane na 1% najpopularniejszych kanałów w YouTube, których widzami są najwięksi pasjonaci na danym rynku. Więcej informacji

Zmiany w ContentCreatorInsightsService: w ramach refaktoryzacji kodu usunęliśmy pole is_brand_connect_creator z usług ContentCreatorInsightsService.GenerateCreatorInsights i ContentCreatorInsightsService.GenerateTrendingInsights.
Użytkownicy powinni zamiast tego szukać twórcy, który ma dostępną opcję CREATOR_PARTNERSHIPS w partnership_opportunities. Program współpracy z twórcami YouTube w Google Ads to miejsce, w którym możesz znaleźć twórców YouTube i podjąć z nimi współpracę w zakresie treści sponsorowanych, a także skutecznie zarządzać współpracą z twórcami. Więcej informacji

Zmiany w KeywordPlanIdeaService: aby zapewnić bardziej spójne i niezawodne działanie, ujednoliciliśmy naszą infrastrukturę prognozowania. W interfejsie Google Ads API w wersji 24 wprowadziliśmy zaktualizowaną metodę GenerateKeywordForecastMetrics, która upraszcza proces planowania, ponieważ koncentruje się na danych mających najbardziej bezpośredni wpływ na skuteczność. W najbliższych dniach opublikujemy post na blogu z bardziej szczegółowymi informacjami o tej zmianie.

Zmiany w zasobie campaign_budget: usunęliśmy segment ad_sub_network_type z zasobu campaign_budget, ponieważ jest on niezgodny z tym widokiem.

Zmiany w widokach komponentów: usunęliśmy segment click_type z widoków ad_group_asset, campaign_asset i customer_asset. Ta zmiana jest zgodna z niedawną zmianą usługi, która usunęła ten segment z Google Ads, aby uniknąć nieprawidłowego przedstawiania danych. Możesz użyć segmentacji click_type z zasobu ad_group_ad, aby uzyskać szczegółowe informacje o skuteczności reklamy i komponencie, z którym została wyświetlona.

Zmiany w elastycznej reklamie wideo: VideoResponsiveAdInfo można teraz wyciszyć. W ramach tej zmiany oznaczyliśmy pola videos, business_name i logo_images jako wymagane w obiektach DemandGenVideoResponsiveAdInfo i VideoResponsiveAdInfo.

Zmiany w ShareablePreviewService: zaktualizowaliśmy ShareablePreviewService.GenerateShareablePreviews, aby nie używać już częściowego niepowodzenia. Jeśli żądanie nie powiedzie się w przypadku któregoś z identyfikatorów, zostanie zwrócony błąd. Więcej informacji

Te materiały pomogą Ci zacząć:

Jeśli potrzebujesz pomocy technicznej, wejdź na stronę https://support.google.com/google-ads/contact/google_ads_api.

portret autora, – , zespół ds. interfejsu Google Ads API

Etykiety: google-ads-api, release