Informacje o wersjach

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

Najnowsza wersja interfejsu API: 2

1 marca 2025 r.

Nowe funkcje

Znane problemy

wycofanie raportu o dostępności zasobów reklamowych TrueView w YouTube i powiązanych z nim wymiarów, zgodnie z poprzednim ogłoszeniem w Centrum pomocy Display & Video 360.

v2

  • Wycofane zostały te wartości wyliczenia:

    Typ wyliczeniowyWartości
    ReportType INVENTORY_AVAILABILITY

  • Wycofane zostały te filtry:

    Wartości filtra

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • Wycofane zostały te dane:

    Wartości danych

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 listopada 2024 r.

Nowe funkcje

Uruchomiono FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. Dzięki temu możesz 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 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 zaufania.

v2

  • Dodaliśmy te filtry:

    Typ filtraDostępne wartości
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: uwzględnianie danych o niższym poziomie zaufania. (wartość domyślna po 4 lutego 2025 r.)

    1: uwzględniaj tylko dane o wysokim poziomie zaufania. (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 za pomocą 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 również zostało 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 danych 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 zaktualizowaliśmy zasoby zapytań i raportów, usuwając niepotrzebne pola, zmieniając organizację istniejących pól i zmieniając ich typy. 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.