Struktura interfejsu API do raportowania Search Ads 360

Główne komponenty interfejsu Search Ads 360 Reporting API to zasoby i usługi. Zasoby reprezentują elementy Search Ads 360, a usługa służy do ich pobierania.

Hierarchia obiektów

Konto Search Ads 360 to hierarchia obiektów.

  • Zasób najwyższego poziomu na koncie to klient.

  • Każde konto zawiera co najmniej 1 aktywną kampanię.

  • Każda Campaign zawiera co najmniej 1 grupę reklam, która grupowanie reklam w logiczne kolekcje.

  • Każda AdGroup zawiera co najmniej 1 reklamę grupy reklam.

  • Do grupy reklam lub kampanii możesz dołączyć co najmniej 1 element AdGroupCriterion lub CampaignCriterion. Kryteria określają sposób uruchamiania reklam.

    • Istnieje wiele typów kryteriów, np. słowa kluczowe, przedziały wiekowe i lokalizacje. Kryteria zdefiniowane na poziomie kampanii wpływają na wszystkie inne zasoby w ramach kampanii. Możesz też określić budżety i daty obowiązujące w całości kampanii.

Zasoby

Zasoby reprezentują elementy na koncie Search Ads 360. Przykładowe zasoby to Customer, Campaign i AdGroup.

Identyfikatory obiektów

Każdy obiekt w Search Ads 360 jest identyfikowany na podstawie własnego identyfikatora. Niektóre identyfikatory są unikalne globalnie, czyli obejmują wszystkie konta Search Ads 360, a inne są unikalne tylko w ograniczonym zakresie.

Zakres unikalności identyfikatora obiektu
Identyfikator budżetu Cały świat
Identyfikator kampanii Cały świat
Identyfikator grupy reklam Cały świat
Identyfikator reklamy Grupa reklam

Każda para AdGroupId / AdId jest niepowtarzalna globalnie.
Identyfikator kryterium grupy reklam Grupa reklam

Każda para AdGroupId / CriterionId jest niepowtarzalna globalnie.
CampaignCriterion ID Kampania

Każda para CampaignId / CriterionId jest globalnie unikalna.
Rozszerzenia reklam Kampania

Każda para CampaignId / AdExtensionId jest niepowtarzalna globalnie.
Identyfikator kanału RSS Cały świat
Identyfikator elementu kanału Cały świat
Identyfikator atrybutu w pliku danych Kanał
Identyfikator mapowania kanału Cały świat
Identyfikator etykiety Cały świat
Identyfikator listy użytkowników Cały świat

Te reguły identyfikatorów mogą być przydatne podczas projektowania lokalnego miejsca na dane dla obiektów Search Ads 360.

Typy obiektów

Niektóre obiekty mogą służyć do różnych typów obiektów. W takim przypadku obiekt zawiera pole type, które opisuje jego zawartość. Na przykład: AdGroupAd może oznaczać reklamę tekstową, reklamę hoteli lub reklamę lokalną. Wartość typu możesz sprawdzić w polu AdGroupAd.ad.type. Jego wartość jest zwracana w wyliczeniu AdType.

Nazwy zasobów

Każdy zasób jest jednoznacznie identyfikowany przez ciąg znaków resource_name, który łączy zasób i jego elementy nadrzędne w ścieżkę.

Nazwy zasobów kampanii mają np. postać:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Kampania o identyfikatorze 987654 na koncie Search Ads 360 o identyfikatorze klienta 1234567 ma resource_name:

customers/1234567/campaigns/987654

Usługi

Usługi umożliwiają pobieranie elementów i metadanych Search Ads 360. Dostępne są 3 typy usług:

Usługa wyszukiwania
SearchAds360Service to jedna, zintegrowana usługa służąca do pobierania wszystkich obiektów zasobów i statystyk skuteczności. Umożliwia to 2 metody: Search i SearchStream. Obie metody wymagają zapytania, które określa zasób, do którego ma być kierowane zapytanie, atrybuty zasobu i dane o skuteczności do pobrania, predykaty do użycia do filtrowania żądania oraz segmenty do użycia do dalszego podziału statystyk skuteczności. Więcej informacji znajdziesz w artykułach Tworzenie raportów wyszukiwania i Język zapytań Search Ads 360.
Usługa w terenie
SearchAds360FieldService zwraca metadane zasobów, takie jak dostępne atrybuty zasobu i jego typ danych. Możesz poprosić o katalog zasobów, pól zasobów, kluczy segmentacji i danych dostępnych w metodach wyszukiwania SearchAds360Service. Aby dowiedzieć się więcej, zapoznaj się z artykułem Pobieranie metadanych zasobów.
Usługi dotyczące poszczególnych elementów

Te usługi udostępniają metodę żądania GET, która umożliwia pobranie pojedynczego wystąpienia zasobu. Jest to przydatne do sprawdzania struktury zasobu.

Przykłady usług związanych z konkretnymi podmiotami:

  • CustomColumnService, która zwraca żądaną kolumnę niestandardową ze wszystkimi szczegółami.