Informacje o wersjach

v0 (2026-08-01)

Nowe pola

Dodajemy synthetic_content_info do zasobów ad i asset oraz obsługujące je SyntheticContentInfo message, SyntheticContentAttestationStatus, i SyntheticContentSource enums.

v0 (2026-03-10)

Nowe segmenty

Dodajemy te segmenty:

v0 (2025-12-05)

Nowe dane

Podczas wysyłania zapytań do zasobu campaign dostępne są teraz te dane:

Dodajemy te dane konwersji z danymi koszyka:

Nowe segmenty

W zapytaniu można teraz określić segmentację według kodu pocztowego. Więcej informacji znajdziesz w sekcji segments.geo_target_postal_code.

v0 (2025-11-10)

Nowe pola URL

Dodajemy:

Nowe dane w przypadku UserLocationView

Podczas wysyłania zapytań do zasobu user_location_view dostępne są teraz te dane:

Poprawka nazwy zasobu

Wzorzec nazwy zasobu w przypadku tych zasobów etykiet obowiązujących został poprawiony, aby używać owner_customer_id. Dzięki temu zawiera on identyfikator klienta, który jest właścicielem etykiety:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (w AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Przykład: wzorzec CampaignEffectiveLabel zmienił się z customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} na customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (2025-06-12)

Ta aktualizacja zawiera nowe pola zasobu klienta. Aby korzystać ze wszystkich tych zmian, zaktualizuj bibliotekę klienta.

Nowe pola

Dodajemy:

aby ułatwić poruszanie się po hierarchii konta Search Ads 360.

v0 (2025-01-21)

Ta aktualizacja zawiera nowy parametr do konfigurowania rozszerzenia MCK.

Rozszerzenie MCK

Podczas wysyłania zapytań do bidding_strategy możesz teraz ustawić wartość logiczną (enable_mcc_expansion) w sekcji PARAMETERS.

Gdy ten parametr jest włączony, w odpowiedzi zwracane są dane ze wszystkich kont w hierarchii kont zakorzenionej w customer_id.

v0 (2024-11-08)

Ta aktualizacja zawiera nowe pola i nowe zasoby. Aby korzystać ze wszystkich tych zmian, zaktualizuj bibliotekę klienta.

Nowe pola

Dodajemy ad_group_ad.effective_labels i ad_group_criterion.effective_labels.

Etykiety obowiązujące to etykiety odziedziczone lub przypisane bezpośrednio.

Nowe zasoby

Widok lokalizacji użytkownika

Używanie go z segmentami geograficznymi umożliwia uzyskiwanie danych związanych z regionem, obszarem metropolitalnym i miastem.

Zobacz szczegóły zasobu user_location_view.

W związku z nowymi polami effective_labels dodaliśmy 2 nowe zasoby, które przechowują metadane powiązania między etykietami obowiązującymi a ad_group_ad (ad_group_ad_effective_label) lub ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

Ta aktualizacja zawiera nowe dane, zasoby, pola i nowe definicje mapowania. Aby korzystać ze wszystkich tych zmian, zaktualizuj bibliotekę klienta.

Dodane dane

cross_device_conversions_by_conversion_date i cross_device_conversions_value_by_conversion_date są zgodne z tymi zasobami: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view i shopping_performance_view.

Ponowne zdefiniowanie mapowań pól

W przypadku niektórych starszych raportów zmieniły się mapowania pól dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv.

Pole Wcześniej Nowa definicja
dfaActions metrics.all_conversions – metrics.cross_device_conversions metrics.all_conversions_by_conversion_date – metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value – metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date – metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions – metrics.cross_device_conversions metrics.all_conversions_by_conversion_date – metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

Lista starszych raportów, w których zmieniono mapowanie pól

Nowe pola

Dodajemy campaign.effective_labels i ad_group.effective_labels.

Etykiety obowiązujące to etykiety odziedziczone lub przypisane bezpośrednio.

Nowe zasoby

W związku z nowymi polami effective_labels nowe zasoby przechowują metadane powiązania między etykietami obowiązującymi a kampanią (campaign_effective_label) lub grupą reklam (ad_group_effective_label).

v0 (2024-08-23)

W tej aktualizacji metadane kolumny niestandardowej zawierają pole renderType .

Zobacz szczegóły CustomColumnRenderType.

Do zasobów campaign_label, ad_group_label, ad_group_ad_label i ad_group_criterion_label dodaliśmy nowe pole owner_customer_id.

Aby korzystać z tych nowych pól, zaktualizuj bibliotekę klienta.

v0 (2024-08-01)

Ta aktualizacja obejmuje segmentację godzinową i kilka nowych pól.

Segmentacja godzinowa

W zapytaniu można teraz określić segmentację godzinową. Więcej informacji znajdziesz w sekcji segments.hour.

Więcej informacji znajdziesz w sekcji customer_manager_link.start_time.

Dodano MULTIMEDIA_AD do ad_group_ad.ad.type

Dane i segmenty można teraz wybierać za pomocą typu MULTIMEDIA_AD. W tej wersji nie jest obsługiwane wysyłanie zapytań o atrybuty multimedialne.

Dodano typ kampanii SOCIAL do campaign.advertising_channel_type i podtyp SOCIAL_FACEBOOK_TRACKING_ONLY do campaign.advertising_channel_sub_type

Dane i segmenty można teraz wybierać za pomocą typu kampanii SOCIAL i podtypu SOCIAL_FACEBOOK_TRACKING_ONLY. W tej wersji nie jest obsługiwane wysyłanie zapytań o atrybuty SOCIAL lub SOCIAL_FACEBOOK_TRACKING_ONLY.

Dodano obsługę average_quality_score

Więcej informacji znajdziesz w sekcji dane.

v0 (2024-04-18)

Ta aktualizacja obejmuje zasób Accessible Bidding Strategy.

Dostępna strategia ustalania stawek

Reprezentuje widok strategii ustalania stawek, których właścicielem jest klient i które są z nim udostępniane. W przeciwieństwie do BiddingStrategy ten zasób obejmuje strategie, których właścicielami są menedżerowie klienta i które są udostępniane temu klientowi, a także strategie, których właścicielem jest ten klient. Ten zasób nie zawiera danych i udostępnia tylko ograniczony podzbiór atrybutów BiddingStrategy.

Zobacz szczegóły zasobu accessible_bidding_strategy.

v0 (2024-02-12)

Ta aktualizacja obejmuje dostęp do kolumn niestandardowych i niestandardowych zmiennych Floodlight.

Kolumny niestandardowe

W zapytaniu można teraz określić niestandardowe kolumny konwersji i niestandardowe kolumny z formułą. Więcej informacji znajdziesz w dokumentacji kolumn niestandardowych.

Niestandardowe zmienne Floodlight

W zapytaniu można teraz określić niestandardowe zmienne Floodlight w przypadku statystyk po 30 stycznia 2024 r. Więcej informacji znajdziesz w dokumentacji niestandardowych zmiennych Floodlight.

v0 (2023-11-09)

Ta aktualizacja obejmuje te zasoby. Kliknij linki, aby zobaczyć pola, o które można wysyłać zapytania w przypadku tych zasobów, oraz dane i segmentacje, których można z nimi używać.

Grupa plików

Zobacz szczegóły zasobu asset_group.

Komponent grupy plików

Zobacz szczegóły zasobu asset_group_asset.

Filtr grupy informacji o produktach w grupie plików

Zobacz asset_group_listing_group_filter szczegóły zasobu.

Sygnał grupy plików

Zobacz szczegóły zasobu asset_group_signal.

Widok najlepszych kombinacji w grupie plików

Zobacz asset_group_top_combination_view.

Widok sprzedaży z danymi koszyka

Zobacz szczegóły zasobu cart_data_sales_view.

Konwersja

Zobacz szczegówały zasobu conversion.

Widok skuteczności zakupów

Zobacz shopping_performance_view shopping_performance_view.

Odwiedź

Zobacz szczegó}ły zasobu visit.

v0 (2023-08-15)

Ta aktualizacja obejmuje te zasoby i nowy parametr do konfigurowania przeliczania walut w przypadku danych.

Kliknij linki, aby zobaczyć pola, o które można wysyłać zapytania w przypadku tych zasobów, oraz dane i segmentacje, których można z nimi używać.

Komponent grupy reklam

Zobacz szczegóły zasobu ad_group_asset.

Zestaw komponentów grupy reklam

Zobacz szczegóły zasobu ad_group_asset_set.

Komponent

Zobacz szczegóby zasobu asset.

Zestaw komponentów

Zobacz szczegóły zasobu asset_set.

Zasób w zbiorze zasobów

Zobacz szczegózkowy opis zasobu asset_set_asset.

Komponent kampanii

Zobacz szczegóły zasobu campaign_asset.

Zestaw komponentów kampanii

Zobacz szczegóły zasobu campaign_asset_set.

Zasób klienta

Zobacz szczegóły zasobu customer_asset.

Zestaw komponentów klienta

Zobacz szczegóły zasobu customer_asset_set.

Przeliczanie walut

Walutę do obliczania danych można określić za pomocą metrics_currency w sekcji PARAMETERS.

Wyświetlanie listy dostępnych klientów

Wyświetl wszystkie dostępne konta za pomocą metody ListAccessibleCustomers.

v0 (2023-05-15)

Ta aktualizacja obejmuje ten zasób. Kliknij linki, aby zobaczyć pola, o które można wysyłać zapytania w przypadku tego zasobu, oraz dane i segmentacje, których można z nim używać.

Reklama z grupy reklam

Zobacz szczegóły zasobu ad_group_ad.

v0 (2023-04-06)

Ta aktualizacja obejmuje te zasoby. Kliknij linki, aby zobaczyć pola, o które można wysyłać zapytania w przypadku każdego zasobu, oraz dane i segmentacje, których można z nim używać.

Widok list odbiorców w grupach reklam

Zobacz szczegóły zasobu ad_group_audience_view.

Etykieta kryterium w grupie reklam

Zobacz szczegóły zasobu ad_group_criterion_label.

Etykieta grupy reklam

Zobacz szczegótkowy opis zasobu ad_group_label.

Widok zakresu wiekowego

Zobacz szczegóły zasobu age_range_view.

Kryterium kampanii

Zobacz szczegóły zasobu campaign_criterion.

Etykieta kampanii

Zobacz szczegóły zasobu campaign_label.

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce

Zobacz szczegóły zasobu dynamic_search_ads_search_term_view.

Widok strony

Zobacz szczegódzły zasobu webpage_view.

Etykieta

Zobacz szczegóły zasobu label.

v0 (2022-12-05)

Wersja v0 obejmuje te zasoby i usługi. Kliknij linki, aby zobaczyć pola, o które można wysyłać zapytania w przypadku każdego zasobu, oraz dane i segmentacje, których można z nim używać.

Grupa reklam

Zobacz szczegóły zasobu ad_group.

Określanie stawek

Zobacz szczegóły zasobu bidding_strategy.

Kampanie

Zobacz szczegóbły zasobu campaign.

Działanie powodujące konwersję

Zobacz szczegó0ły zasobu conversion_action.

Klient

Zobacz szczegózej zasobu customer.

Słowo kluczowe

Zobacz szczegóły zasobu keyword_view.

Grupa produktów

Zobacz szczegóły zasobu product_group_view.

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service służy do pobierania wielu zasobów w jednym zapytaniu. Zasoby, o które można wysyłać zapytania, to include:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • Dane, takie jak wyświetlenia i kliknięcia, można też pobierać za pomocą SearchAds360Service w przypadku tych zasobów:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service umożliwia segmentację według pól, np. pól daty. Więcej informacji.