Google Ad Manager offre un'API SOAP sia per la generazione di report sia per la manipolazione di 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.
Reporting nell'API Ad Manager
ReportService dell'API Ad Manager offre due modi per eseguire e scaricare i report:
- Creazione di una query nella UI ed esecuzione in base al suo ID.
- Creazione di un oggetto ReportQuery ad hoc.
Con entrambe le opzioni, il flusso di lavoro dell'API prevede quattro passaggi:
- Chiama runReportJob.
- Esegui il polling dello stato del report utilizzando getReportJobStatus.
- Ottieni l'URL del report completato utilizzando getReportDownloadUrlWithOptions.
- Scarica il report dall'URL restituito.
Per maggiori dettagli, consulta la guida ai report.
Fusi orari dei report
A differenza dell'API REST Ad Exchange Seller, nell'API Ad Manager i report vengono generati per impostazione predefinita nel fuso orario della tua rete. Per modificare questa impostazione, imposta il campo TimeZoneType.
Mappatura delle metriche e delle dimensioni di AdX in Ad Manager
Tutte le metriche e le dimensioni supportate dell'API REST Ad Exchange Seller sono ora presenti nell'API di reporting di Ad Manager. Alcuni nomi sono stati modificati e altri sono stati ritirati. Per i dettagli, consulta le tabelle di seguito.
Metriche/Colonne
Questa tabella mappa le metriche AdX alle colonne di Ad Manager.
| Metrica AdX | Colonna Ad Manager | Nome 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) | (deprecated) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Impressioni visualizzate con Visualizzazione attiva |
| ACTIVE_VIEW_VIEWABLE_RATIO | (deprecated) | (deprecated) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Tempo di visibilità medio (sec) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Impressioni dell'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 | (deprecated) | (deprecated) |
| 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 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 ignorati TrueView |
| 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 Ad Manager .
| Dimensione AdX | Dimensione Ad Manager | Nome dello strumento Query Tool di Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Proprietà Web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Località 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 | Inserzionisti |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Verticali dell'inserzionista |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agenzie |
| 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 acquirente |
| 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 |
| DATA | 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 | Sites |
| 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 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 degli annunci video |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Tipi di annunci video |
| SETTIMANA | 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 |