Interfejs Search Ads 360 Reporting API jest oparty na nowoczesnej platformie i wprowadza wiele nowych rozwiązań. Opisujemy je w kolejnych sekcjach.
Zasoby
Obiekty zasobów zastępują typy raportów. Zamiast wysyłać prośby o wstępnie zdefiniowane typy raportów, możesz teraz wysyłać zapytania do wszystkich zasobów za pomocą nowego języka zapytań podobnego do SQL. Więcej informacji znajdziesz w artykule Struktura interfejsu Search Ads 360 Reporting API.
Raportowanie wyszukiwania
W nowym interfejsie API wyszukiwarka ma własną usługę. Usługa wyszukiwania zastępuje starszą usługę Raporty. Wszystkie zapytania przechodzą przez interfejs SearchAds360Service, który udostępnia 2 metody – SearchStream i Search – wyszukiwania i pobierania danych raportowania oraz danych. Obie metody wyszukiwania zwracają wszystkie SearchAds360Rowobiekty pasujące do zapytania. Więcej informacji znajdziesz w artykule Tworzenie raportów wyszukiwania.
Metadane zasobu
SearchAds360FieldService umożliwia dynamiczne wysyłanie żądań dotyczących katalogu zasobów, pól zasobów, kluczy segmentacji i danych dostępnych w metodach wyszukiwania SearchAds360Service. Więcej informacji znajdziesz w artykule Pobieranie metadanych zasobów.
Nazwy pól
W API wprowadzono nazwy pól zagnieżdżonych rozdzielone notacją z użyciem kropki. Na przykład: campaign.id i ad_group.id. Możesz też tworzyć kolejne zagnieżdżenia, 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 opiera się na oddzielnych polach w różnych rodzajach obiektów, które dotyczą podobnych pojęć. Na przykład raporty campaign 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ń w celu pobierania konkretnych danych raportowania najlepiej dopasowanych do Twojej firmy. Więcej informacji znajdziesz w artykule Język zapytań Search Ads 360.
Otrzymywanie próśb
W nowym interfejsie API wyszukiwanie ma własną usługę (SearchAds360Service), ale GET
żądania nadal istnieją w usłudze każdego podmiotu. Możesz na przykład uzyskać informacje o kolumnie niestandardowej z 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 nazywają się kolumnami niestandardowymi.
Więcej informacji o kolumnach niestandardowych
Nowy
CustomColumnService
umożliwia korzystanie z kolumn niestandardowych. Jeśli masz odpowiednie uprawnienia, możesz poprosić o CustomColumn zasoby należące do dowolnego konta w drzewie kont.
Zarządzanie kontem
W nowej wersji Search Ads 360 obowiązuje hierarchia kont: konta 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. Więcej informacji znajdziesz w artykule Konta menedżera Search Ads 360.
Możesz wysłać zapytanie dotyczące struktury konta, a potem przesłać prośby dotyczące każdego konta, z którego chcesz uzyskać dane raportowania.
W wyniku zmiany hierarchii kont pola związane z koncepcją reklamodawcy/agencji zostały zastąpione odpowiednimi alternatywami, aby w miarę możliwości zapewnić funkcjonalną równoważność. 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 do uzyskania dostępu do podrzędnego konta menedżera lub konta klienta używasz konta menedżera. Więcej informacji znajdziesz w sekcji
Nagłówek identyfikatora klienta logowania.
Obsługa wersji
Interfejs Search Ads 360 Reporting API korzysta z wersjonowania semantycznego. Wersje główne i podrzędne są oznaczone jako vMAJOR_MINOR. Więcej informacji znajdziesz w sekcji Wersje.