Google Ad Manager offre un'API SOAP per generare rapporti e manipolare entità di gestione del traffico, come LineItems.
Le librerie client sono disponibili in diversi linguaggi. Come l'API AdX Seller, l'API Ad Manager utilizza OAuth2 per l'autenticazione.
Per iniziare con la tua prima richiesta API, consulta la Guida introduttiva.
Generare report nell'API Ad Manager
ReportService dall'API di Ad Manager offre due modi per eseguire e scaricare i report:
- Creazione di una query nell'interfaccia utente ed esecuzione in base al relativo ID.
- Creare una ReportQuery ad hoc.
In entrambi i casi, il flusso di lavoro dell'API prevede quattro passaggi:
- Chiama runReportJob.
- Eseguire un sondaggio per lo stato del report utilizzando getReportJobStatus.
- Recupera l'URL del report completato utilizzando getReportDownloadUrlWithOptions.
- Scarica il report dall'URL restituito.
Per ulteriori dettagli, consulta la guida ai report.
Fusi orari dei report
A differenza dell'API REST di Ad Exchange Seller, nei report dell'API Ad Manager viene usato per impostazione predefinita il fuso orario della tua rete. Per modificare questa impostazione, imposta il campo TimeZoneType.
Mappatura di metriche e dimensioni da AdX ad Ad Manager
Tutte le metriche e le dimensioni supportate dell'API REST di Ad Exchange Seller sono ora presenti nell'API di reporting di Ad Manager. Alcuni nomi sono cambiati e altri sono stati ritirati. Per informazioni dettagliate, consulta le tabelle seguenti.
Metriche / colonne
In questa tabella vengono mappate le metriche AdX alle colonne Ad Manager.
| Metrica AdX | Colonna Ad Manager | Nome del Query Tool di Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Impressioni attivate con Visualizzazione attiva |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Impressioni misurate con Visualizzazione attiva |
| ACTIVE_VIEW_MEASURABLE_RATIO | (deprecato) | (deprecato) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Impressioni visualizzate con Visualizzazione attiva |
| ACTIVE_VIEW_VIEWABLE_RATIO | (deprecato) | (deprecato) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Tempo di visibilità medio (secondi) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Impressioni annuncio |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM dell'annuncio |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Richieste di annunci |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Copertura |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR richieste di annunci |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM richieste di annunci |
| CLIC | AD_EXCHANGE_CLICKS | Clic |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Richieste di annunci per deal |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Risposte all'offerta per deal |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Tasso di corrispondenza deal |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Richieste con corrispondenza deal |
| ENTRATE | AD_EXCHANGE_ESTIMATED_REVENUE | Entrate stimate |
| INDIVIDUAL_AD_IMPRESSIONS | (deprecato) | (deprecato) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR annuncio |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (nuovo consiglio) AD_EXCHANGE_AD_ECPM | (nuovo consiglio) eCPM dell'annuncio |
| LIFT_RATE | AD_EXCHANGE_LIFT | Incremento |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Richieste con corrispondenza |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM con corrispondenza |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Tasso di abbandono del video |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Tasso di abbandono video |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Quartile 1 video |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Quartile 3 video |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Tasso di annunci video TrueView ignorati |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Visualizzazioni TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | VTR TrueView |
Dimensioni
Questa tabella mappa le dimensioni AdX alle dimensioni di Ad Manager .
| Dimensione AdX | Dimensione Ad Manager | Nome del Query Tool di Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Proprietà Web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Posizioni degli annunci |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Tag |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Non disponibile) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Dimensioni inventario |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Domini degli inserzionisti |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Advertisers |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Verticali dell'inserzionista |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agencies |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Non disponibile) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Brand |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Non disponibile) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Tipi di branding |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Non disponibile) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Reti di acquirenti |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Non disponibile) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Paesi |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Dimensioni delle creatività |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Non disponibile) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Non disponibile) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Canali |
| DATE | AD_EXCHANGE_DATE | Giorni |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | ID deal |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Nomi deal |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Non disponibile) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Unità pubblicitarie DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Origini richiesta |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Siti |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | Piattaforme lato domanda |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Tipi espandibili |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Proprietario dell'inventario |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Nomi dei partner di rete |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Nomi app |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Nomi operatori |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Dispositivi |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Tipi di inventario |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Sistemi operativi |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Larghezza di banda |
| MONTH | AD_EXCHANGE_MONTH | Mesi |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Categorie di dispositivi |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Non disponibile) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Prodotti |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Non disponibile) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Tipi di targeting |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Non disponibile) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Tipi di transazioni |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Non disponibile) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Non disponibile) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Durate annunci video |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Tipi di annunci video |
| WEEK | AD_EXCHANGE_WEEK | Settimane |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Non disponibile) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Regole per la determinazione del prezzo |