Interfejs Search Ads 360 Reporting API jest oparty na nowoczesnej platformie i wprowadza wiele nowych rozwiązań. Opisują je kolejne sekcje.
Zasoby
Obiekty zasobów zastępują typy raportów. Zamiast żądać wstępnie zdefiniowanych typów raportów, możesz teraz wysyłać zapytania o wszystkie zasoby za pomocą nowego języka zapytań podobnego do SQL. Więcej informacji znajdziesz w artykule o strukturze interfejsu Search Ads 360 Reporting API.
Raportowanie wyszukiwania
Wyszukiwarka ma własną usługę w nowym interfejsie API. Wyszukiwarka zastępuje starszą wersję usługi Raporty. Wszystkie zapytania są przesyłane przez interfejs SearchAds360Service, który udostępnia 2 metody, SearchStream i Search, służące do wyszukiwania i pobierania danych i informacji raportowania. Obie metody wyszukiwania zwracają wszystkie obiekty SearchAds360Row pasujące do zapytania. Więcej informacji znajdziesz w artykule Tworzenie raportów wyszukiwania.
Metadane zasobu
SearchAds360FieldService umożliwia dynamiczne wysyłanie żądań do katalogu dotyczących zasobów, pól zasobów, kluczy podziału na segmenty i wskaźników dostępnych w metodach wyszukiwania SearchAds360Service. Więcej informacji znajdziesz w artykule Pobieranie metadanych zasobów.
nazwy pól,
Interfejs API wprowadza zagnieżdżone nazwy pól rozdzielone kropką. Na przykład: campaign.id i ad_group.id. Możesz też zagnieżdżać kolejne elementy,
np. ad_group.campaign.id. Więcej informacji znajdziesz w artykule Struktura interfejsu Search Ads 360 Reporting API.
Raportowanie w poprzedniej wersji interfejsu Search Ads 360 API jest oparte na osobnych polach w różnych elementach w przypadku podobnych pojęć. Na przykład zarówno raporty campaign, jak i adgroup zawierają osobne pole campaignId.
Język zapytań
Interfejs API wprowadza język zapytań Search Ads 360. Jest to elastyczny język podobny do SQL, który umożliwia definiowanie zapytań służących do pobierania konkretnych danych raportowania najlepiej dopasowanych do Twojej firmy. Aby dowiedzieć się więcej, zapoznaj się z językiem zapytań Search Ads 360.
Uzyskaj żądania
W nowym interfejsie API wyszukiwanie ma własną usługę (SearchAds360Service), ale nadal występują żądania GET dotyczące poszczególnych usług poszczególnych encji. Informacje o kolumnach niestandardowych znajdziesz np. w sekcji CustomColumnService. Więcej informacji znajdziesz w artykule Zmiany formatu w interfejsie Search Ads 360 Reporting API.
Kolumny niestandardowe
W nowej wersji Search Ads 360 kolumny z formułami i konwersje niestandardowe są nazywane kolumnami niestandardowymi. Więcej informacji o kolumnach niestandardowych Nowa funkcja CustomColumnService umożliwia tworzenie kolumn niestandardowych. Jeśli masz odpowiednie uprawnienia, możesz poprosić o zasoby CustomColumn należące do dowolnego konta w drzewie kont.
Zarządzanie kontem
W nowej wersji Search Ads 360 obowiązuje hierarchia kont: konto menedżera, podrzędne konta menedżera i konta klientów. Konto menedżera reprezentuje konto agencji, a podrzędne konta menedżera odpowiadają kontom reklamodawcy w poprzedniej wersji Search Ads 360. Aby dowiedzieć się więcej, przeczytaj artykuł Konta menedżera Search Ads 360.
Możesz przesłać zapytanie do drzewa kont, a potem przesłać żądania dotyczące każdego konta, z którego chcesz raportować dane.
W efekcie zmian w hierarchii kont pola związane z koncepcją reklamodawcy/agencji zostały zastąpione odpowiednimi alternatywami, aby zapewnić równość funkcjonalności w miarę możliwości. Listę pól, których dotyczy problem, i ich zamienników znajdziesz w sekcji Mapowania pól.
Nagłówek identyfikatora klienta logowania
login-customer-id to nowy nagłówek, który jest wymagany, gdy używasz konta menedżera do uzyskiwania dostępu do podrzędnego konta menedżera lub konta klienta. Więcej informacji znajdziesz w sekcji Nagłówek logowania z identyfikatorem klienta.
Obsługa wersji
Interfejs Search Ads 360 Reporting API korzysta z semantycznej obsługi wersji.
Istnieją główne i podrzędne wersje w formacie vMAJOR_MINOR. Więcej informacji znajdziesz w sekcji Zarządzanie wersjami.