Google Ad Manager udostępnia interfejs API SOAP służący zarówno do raportowania, jak i do manipulowania elementami trafikowania, takimi jak LineItems.
Biblioteki klienckie są dostępne w kilku językach. Podobnie jak AdX Seller API, interfejs Ad Managera API używa do uwierzytelniania protokołu OAuth2.
Aby dowiedzieć się, jak rozpocząć pracę z pierwszym żądaniem do interfejsu API, zapoznaj się z sekcją Pierwsze kroki.
Raportowanie w interfejsie API Ad Managera
ReportService w interfejsie Ad Manager API umożliwia generowanie i pobieranie raportów na 2 sposoby:
- Tworzenie zapytania w interfejsie użytkownika i uruchamianie go na podstawie jego identyfikatora.
- Tworzenie doraźnych ReportQuery.
W przypadku każdej z tych opcji przepływ pracy interfejsu API składa się z 4 kroków:
- Wywołaj runReportJob.
- Przeprowadź sondowanie stanu raportu, korzystając z metody getReportJobStatus.
- Pobierz adres URL gotowego raportu za pomocą polecenia getReportDownloadUrlWithOptions.
- Pobierz raport ze zwróconego adresu URL.
Więcej informacji znajdziesz w przewodniku po raportowaniu.
Strefy czasowe raportowania
W odróżnieniu od interfejsu API REST Ad Exchange dla sprzedawców w raportach interfejsu Ad Manager API domyślnie ustawiona jest strefa czasowa Twojej sieci. Aby to zmienić, skonfiguruj pole TimeZoneType.
Mapowanie danych i wymiarów z AdX na Ad Managera
Wszystkie obsługiwane dane i wymiary interfejsu Ad Exchange dla sprzedawców typu REST API są teraz dostępne w interfejsie API do raportowania Ad Managera. Niektóre nazwy zmieniły się, a kilka zostało wycofanych. Szczegółowe informacje znajdziesz w tabelach poniżej.
Wskaźniki / kolumny
Ta tabela mapuje dane AdX na kolumny Ad Managera.
| Dane AdX | Kolumna Ad Managera | Nazwa Narzędzia do wysyłania zapytań Ad Managera |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Wyświetlenia dostępne w Widoku aktywnym |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Wyświetlenia zmierzone w widoku aktywnym |
| ACTIVE_VIEW_MEASURABLE_RATIO | (wycofano) | (wycofano) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Wyświetlenia widoczne w Widoku aktywnym |
| ACTIVE_VIEW_VIEWABLE_RATIO | (wycofano) | (wycofano) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Średni czas widoczności (w sekundach) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Wyświetlenia reklam |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM reklamy |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Żądania reklamy |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Pokrycie, |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR żądania reklamy |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM żądania reklamy |
| KLIKNIĘCIA | AD_EXCHANGE_CLICKS | Kliknięcia |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Żądania reklam w umowie |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Odpowiedzi na stawkę w umowie |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Współczynnik dopasowania umowy |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Dopasowane żądania w umowie |
| PRZYCHODY | AD_EXCHANGE_ESTIMATED_REVENUE | Szacunkowe przychody |
| INDIVIDUAL_AD_IMPRESSIONS | (wycofano) | (wycofano) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR reklamy |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (nowa rekomendacja) AD_EXCHANGE_AD_ECPM | (nowa rekomendacja) eCPM reklamy |
| LIFT_RATE | AD_EXCHANGE_LIFT | Wzrost |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Dopasowane żądania |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | Dopasowany eCPM |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Współczynnik porzuceń filmu |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Współczynnik porzuceń filmu |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | 1 kwartyl filmu |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | 3 kwartyl filmu |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Współczynnik pominięć reklam TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Obejrzenia reklam TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | Współczynnik oglądalności reklam TrueView |
Wymiary
Ta tabela mapuje wymiary AdX na wymiary Ad Managera.
| Wymiar AdX | Wymiar Ad Manager | Nazwa Narzędzia do wysyłania zapytań Ad Managera |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Usługa internetowa |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Lokalizacje reklam |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Tagów |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Niedostępny) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Rozmiary zasobów reklamowych |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Domeny reklamodawców |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Reklamodawcy |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Branże reklamodawcy |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agencje |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Niedostępny) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Marki |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Niedostępny) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Typy marki |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Niedostępny) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Sieci kupujących |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Niedostępny) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Kraje |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Rozmiary kreacji |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Niedostępny) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Niedostępny) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Kanały |
| DATA | AD_EXCHANGE_DATE | Dni |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Identyfikatory umów |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Nazwy umów |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Niedostępny) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Jednostki reklamowe DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Źródła żądań |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Witryny |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | Platformy DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Typy reklam rozwijanych |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Własność zasobów reklamowych |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Nazwy partnerów sieci |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Nazwy aplikacji |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Nazwy operatorów |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Urządzenia |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Typy zasobów reklamowych |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Systemy operacyjne |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Przepustowość |
| MIESIĄC | AD_EXCHANGE_MONTH | Miesiące |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Kategorie urządzeń |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Niedostępny) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Produkty |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Niedostępny) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Typy kierowania |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Niedostępny) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Typy transakcji |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Niedostępny) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | Adresy URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Niedostępny) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Czasy trwania reklam wideo |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Typy reklam wideo |
| TYDZIEŃ | AD_EXCHANGE_WEEK | Tygodnie |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Niedostępny) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Reguły cenowe |