Informacje o wersjach

wersja 0 (10.11.2025)

Nowe pola URL

Dodajemy

Nowe dane w przypadku UserLocationView

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

Korekta nazwy zasobu

Wzorzec nazwy zasobu dla tych zasobów etykiety skutecznej 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 dla CampaignEffectiveLabel zmienił się z customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} na customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12.06.2025)

Ta aktualizacja zawiera nowe pola zasobu customer. Aby w pełni wykorzystać te zmiany, zaktualizuj bibliotekę klienta.

Nowe pola

Dodajemy

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

wersja 0 (21 stycznia 2025 r.)

Ta aktualizacja zawiera nowy parametr do konfigurowania rozszerzenia MCK.

Rozszerzenie MCK

Podczas wysyłania zapytania 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, której korzeniem jest konto customer_id.

v0 (2024-11-08)

Ta aktualizacja zawiera nowe pola i nowe zasoby. Aby w pełni wykorzystać te zmiany, zaktualizuj bibliotekę klienta.

Nowe pola

Dodajemy ad_group_ad.effective_labels i ad_group_criterion.effective_labels.

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

Nowe zasoby

Widok lokalizacji użytkownika

Używanie go z segmentami geograficznymi może dostarczać danych związanych z regionem, obszarem miejskim i miastem.

Zobacz szczegóły zasobu user_location_view.

W związku z nowymi polami effective_labels istnieją 2 nowe zasoby, które przechowują metadane powiązania między etykietami obowiązującymi a reklamą w grupie reklam (ad_group_ad_effective_label) lub kryterium grupy reklam (ad_group_criterion_effective_label).

v0 (2024-10-07)

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

Dodano dane

cross_device_conversions_by_conversion_datecross_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_viewshopping_performance_view.

Ponowne zdefiniowanie mapowań pól

W przypadku niektórych starszych raportów zmieniło się mapowanie 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.

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

Nowe zasoby

Nowe zasoby powiązane z nowymi polami effective_labels przechowują metadane dotyczące 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 dodają pole renderType.

Zobacz szczegóły CustomColumnRenderType.

Do zasobów campaign_label, ad_group_label, ad_group_ad_label i ad_group_criterion_label dodano 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 artykule customer_manager_link.start_time.

Dodano MULTIMEDIA_AD do pola ad_group_ad.ad.type

Dane i segmenty można teraz wybierać w przypadku typu MULTIMEDIA_AD. W tej wersji nie można wysyłać zapytań o atrybuty multimediów.

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

Dane i segmenty można teraz wybierać w przypadku kampanii typu SPOŁECZNOŚCIOWE i podtypu SOCIAL_FACEBOOK_TRACKING_ONLY. W tej wersji nie jest obsługiwane wysyłanie zapytań dotyczących konkretnych atrybutów SOCIAL ani SOCIAL_FACEBOOK_TRACKING_ONLY.

Dodaliśmy obsługę parametru average_quality_score

Więcej szczegółów znajdziesz w sekcji dane.

wersja 0 (18.04.2024)

Ta aktualizacja obejmuje zasób Strategia ustalania stawek z ułatwieniami dostępu.

Dostępna strategia ustalania stawek

Reprezentuje widok strategii ustalania stawek, które należą do klienta i są z nim współdzielone. W przeciwieństwie do zasobu BiddingStrategy ten zasób zawiera strategie należące do menedżerów klienta i udostępnione temu klientowi – oprócz strategii należących do tego klienta. Ten zasób nie udostępnia danych i zawiera tylko ograniczony podzbiór atrybutów BiddingStrategy.

Zobacz szczegóły zasobu accessible_bidding_strategy.

v0 (12.02.2024)

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

Kolumny niestandardowe

W zapytaniu można teraz określać 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ślać 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 szczegóły zasobu asset_group_listing_group_filter.

Sygnał grupy plików

Zobacz szczegóły zasobu asset_group_signal.

Widok najlepszych kombinacji w grupie plików

Zobacz szczegóły zasobu asset_group_top_combination_view.

Widok sprzedaży danych koszyka

Zobacz szczegóły zasobu cart_data_sales_view.

Konwersja

Zobacz szczegóły zasobu conversion.

Widok Skuteczność Zakupów

Zobacz szczegóły zasobu shopping_performance_view.

Odwiedź

Zobacz szczegóły zasobu wizyta.

v0 (2023-08-15)

Ta aktualizacja obejmuje te zasoby i nowy parametr do konfigurowania konwersji 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óły zasobu asset.

Zestaw komponentów

Zobacz szczegóły zasobu asset_set.

Zasób w zbiorze komponentów

Zobacz szczegóły 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żesz określić za pomocą parametru metrics_currency w sekcji PARAMETERS.

Wyświetlanie listy dostępnych klientów

Wyświetl listę wszystkich dostępnych kont 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 używać w jego przypadku.

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, które można wysyłać w zapytaniach dotyczących poszczególnych zasobów, oraz dane i segmentacje, których można używać w przypadku danego zasobu.

Widok listy odbiorców grupy 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óły zasobu ad_group_label.

Widok przedziału wiekowego

Zobacz szczegóły zasobu age_range_view.

Campaign Criterion

Zobacz szczegóły zasobu campaign_criterion.

Etykieta kampanii

Wyświetlanie szczegółów zasobu campaign_label

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce

Zobacz szczegóły zasobu dynamic_search_ads_search_term_view.

Wyświetlenie strony internetowej

Szczegółowe informacje o zasobie webpage_view znajdziesz w tym artykule.

Etykieta

Zobacz szczegóły zasobu etykieta.

v0 (2022-12-05)

Wersja 0 obejmuje te zasoby i usługi: Kliknij linki, aby zobaczyć pola, które można wysyłać w zapytaniach dotyczących poszczególnych zasobów, oraz dane i segmentacje, których można używać w przypadku danego zasobu.

Grupa reklam

Zobacz szczegóły zasobu ad_group.

Określanie stawek

Zobacz szczegóły zasobu bidding_strategy.

Kampanie

Wyświetl szczegóły zasobu kampanii.

Działanie powodujące konwersję

Zobacz szczegóły zasobu conversion_action.

Klient

Zobacz szczegóły 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 ramach jednego zapytania. Zasoby, o które można wysyłać zapytania, to:

    • 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