Informacje o wersjach

Ta strona zawiera informacje o wersji interfejsu Bid Manager API w Google.

Najnowsza wersja interfejsu API: 2

20 listopada 2024 r.

Nowe funkcje

Uruchomiono FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. Pozwala to uwzględniać dane o niższym poziomie zaufania w przypadku danych z tymi prefiksami:

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

Używając tego filtra, musisz uwzględnić jeden z odpowiednich rodzajów danych.

Po wprowadzeniu tej zmiany zapytania, które nie zawierają tego filtra, będą domyślnie stosować poprzednie domyślne zachowanie, czyli uwzględniać tylko dane o wysokim poziomie zaufania. Od 4 lutego 2025 roku zapytania, które nie zawierają tego filtra, będą domyślnie uwzględniać dane o niższym poziomie pewności.

v2

  • Dodaliśmy te filtry:

    Typ filtraDostępne wartości
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: uwzględnij dane o mniejszym stopniu pewności. (domyślnie po 4 lutego 2025 r.)

    1: uwzględniaj tylko dane o wysokiej wiarygodności. (wartość domyślna przed 4 lutego 2025 r.)

1 października 2024 r.

Nowe funkcje

Brak.

Znane problemy

v2

Wycofanie wymiaru raportowania modelowania anonimowych zasobów reklamowych (AIM)

Wymiar FILTER_ANONYMOUS_INVENTORY_MODELING to zachód słońca.

Tworzenie lub uruchamianie zasobów Query przy użyciu wartości sunset w params.groupBy powoduje błąd 400.

Dane DST/ROC (ustawowe koszty operacyjne) i całkowity koszt mediów są niezgodne z raportami YOUTUBE.

W raportach YOUTUBE nie można już używać tych wartości danych:

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

Tworzenie lub uruchamianie zasobów Query z params.typeYOUTUBE i odpowiednią wartością wskaźnika w params.metrics powoduje błąd 400.

1 maja 2024 r.

Nowe funkcje

Brak.

Znane problemy

v2

Wycofanie raportów Pełna ścieżka i Atrybucja ścieżki

Raporty Pełna ścieżka i Atrybucja ścieżki zostały wycofane. Pobieranie lub tworzenie tych typów zasobów Query i Report powoduje błąd.

Te wartości ReportType są wycofywane:

  • FULL_PATH
  • PATH_ATTRIBUTION

Pole pathQueryOptions obiektu Options jest też wycofane.

28 lutego 2024 r.

Nowe funkcje

Brak.

Znane problemy

v2

Wycofanie wartości danych o konwersjach na różnych urządzeniach

Dane o konwersjach na różnych urządzeniach są wycofywane. Obejmują one te wartości interfejsu Bid Manager API:

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 lipca 2022 r.

Nowe funkcje

Opublikowano wersję 2 interfejsu Bid Manager API.

Wprowadziliśmy zmiany strukturalne w interfejsie API, m.in. zaktualizowaliśmy punkt końcowy usługi i zmieniliśmy nazwy usług i metod.

Znacznie zaktualizowano zasoby zapytań i raportów poprzez usunięcie zbędnych pól, reorganizację istniejących pól i zmianę ich typów. Obejmuje to zmianę typów pól na obiekty o nazwie zamiast ogólnej definicji „zagnieżdżonego obiektu”.

Wymagane jest wykonywanie zapytań ad hoc za pomocą metody queries.run zamiast ich automatycznego wykonywania po utworzeniu.

Parametr zapytania asynchronous o wartości queries.run został zastąpiony parametrem synchronous.

Uproszczone pobieranie raportów dzięki tym zmianom:

Zaktualizowaliśmy komunikaty o błędach zwracane przez interfejs API, aby były bardziej szczegółowe i zawierały więcej preskryptywnych rozwiązań.

Aby przejść z wersji 1.1 na wersję 2, postępuj zgodnie z instrukcjami podanymi w przewodniku po migracji do wersji 2.

v2

Znane problemy

Brak.

Poprzednie wersje

Informacje o poprzednich wersjach interfejsu Bid Manager API, które zostały wycofane, znajdziesz w archiwalnych informacjach o wersjach.