Interfejs Search Ads 360 Reporting API jest oparty na nowoczesnej platformie i wprowadza wiele nowych koncepcji. Opisujemy je w kolejnych sekcjach.
Zasoby
Obiekty zasobów zastępują typy raportów. Zamiast wysyłać żądania wstępnie zdefiniowanych typów raportów, możesz teraz wykonywać zapytania dotyczące wszystkich zasobów za pomocą nowego języka zapytań podobnego do SQL. Więcej informacji znajdziesz w artykule o strukturze interfejsu Search Ads 360 Reporting API.
Raporty wyszukiwania
Wyszukiwarka ma własną usługę w nowym interfejsie API. Wyszukiwarka zastępuje starszą wersję usługi Raporty. Wszystkie zapytania przechodzą przez usługę SearchAds360Service, która udostępnia 2 metody wyszukiwania i pobierania danych oraz danych raportowania: SearchStream i Search. 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ć dalej, na przykład ad_group.campaign.id. Więcej informacji znajdziesz w artykule o strukturze interfejsu Search Ads 360 Reporting API.
Raportowanie w poprzedniej wersji Search Ads 360 API opierało się na osobnych polach dotyczących różnych elementów na potrzeby podobnych koncepcji. 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ń pobierających konkretne dane raportowania dopasowane do potrzeb Twojej firmy. Więcej informacji znajdziesz w artykule Język zapytań Search Ads 360.
Otrzymuj żądania
W nowym interfejsie API wyszukiwanie ma własną usługę (SearchAds360Service), ale żądania GET nadal występują w przypadku konkretnej usługi każdej z nich. Informacje o kolumnach niestandardowych możesz na przykład uzyskać z komponentu CustomColumnService. Więcej informacji znajdziesz w artykule Zmiany formatów 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 W nowej wersji CustomColumnService możesz włączyć kolumny niestandardowe. Jeśli masz niezbędne uprawnienia, możesz poprosić o zasoby typu CustomColumn należące do dowolnego konta w drzewie konta.
Zarządzanie kontem
Konta w nowej wersji Search Ads 360 uporządkowane są w hierarchię kont menedżera, podrzędnych kont menedżera i kont klientów. Konto menedżera odpowiada kontu agencji, a podrzędne konta menedżera – konta reklamodawcy z poprzedniej wersji Search Ads 360. Więcej informacji znajdziesz w artykule Konta menedżera Search Ads 360.
Możesz zapytać drzewo konta, a potem przesłać prośby dotyczące każdego konta, z którego chcesz korzystać w raportach.
Ze względu na zmianę w hierarchii konta pola powiązane z koncepcją reklamodawcy/agencji zostały zastąpione odpowiednimi rozwiązaniami alternatywnymi, aby zapewnić spójność funkcjonalną wszędzie tam, gdzie jest to możliwe. Listę pól, których dotyczy problem i ich odpowiedników, znajdziesz w sekcji Mapowania pól.
Nagłówek identyfikatora klienta logowania
login-customer-id to nowy nagłówek, który jest wymagany, gdy za pomocą konta menedżera uzyskujesz dostęp do podrzędnego konta menedżera lub konta klienta. Więcej informacji znajdziesz w sekcji Nagłówek identyfikatora klienta logowania.
Obsługa wersji
Interfejs Search Ads 360 Reporting API używa semantycznej obsługi wersji.
Istnieją wersje główne i podrzędne w formacie vMAJOR_MINOR. Więcej informacji znajdziesz w sekcji Obsługa wersji.