Google Ad Manager, LineItems gibi trafik varlıklarını hem raporlama hem de değiştirme için SOAP API'si sunar.
İstemci kitaplıkları çeşitli dillerde kullanılabilir. AdX Satıcı API'si gibi Ad Manager API'si de kimlik doğrulama için OAuth2'yi kullanır.
İlk API isteğinizi başlatmak için Başlarken bölümüne bakın.
Ad Manager API'sinde raporlama
Ad Manager API'si ReportService, raporları çalıştırmak ve indirmek için iki yol sunar:
- Kullanıcı arayüzünde bir sorgu oluşturma ve bu sorguyu kimliğine göre çalıştırma.
- Özel bir ReportQuery oluşturma.
Her iki seçenekte de API iş akışı dört adımdan oluşur:
- runReportJob'u çağırın.
- getReportJobStatus değerini kullanarak rapor durumu için anket yapın.
- getReportDownloadUrlWithOptions'ı kullanarak tamamlanan raporun URL'sini alın.
- Döndürülen URL'den raporu indirin.
Daha ayrıntılı bilgi için raporlama kılavuzuna bakın.
Raporlama Saat Dilimleri
Ad Exchange Satıcı REST API'sinin aksine, Ad Manager API raporlarında varsayılan olarak ağınızın saat dilimi kullanılır. Bunu değiştirmek için TimeZoneType alanını ayarlayın.
AdX'ten Ad Manager'a Metrik ve Boyut Eşleme
Desteklenen tüm Ad Exchange Satıcı REST API metrikleri ve boyutları artık Ad Manager raporlama API'sinde mevcuttur. Bazı adlar değiştirildi, bazıları ise kullanımdan kaldırıldı. Ayrıntılar için lütfen aşağıdaki tablolara bakın.
Metrikler / Sütunlar
Bu tablo, AdX Metriklerini Ad Manager Sütunları ile eşleştirir.
| AdX Metriği | Ad Manager Sütunu | Ad Manager Sorgu Aracı Adı |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Aktif görüntüleme etkin gösterim sayısı |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Aktif görüntüleme ölçülen gösterimler |
| ACTIVE_VIEW_MEASURABLE_RATIO | (desteği sonlandırıldı) | (desteği sonlandırıldı) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Aktif görüntüleme görüntülenen gösterimler |
| ACTIVE_VIEW_VIEWABLE_RATIO | (desteği sonlandırıldı) | (desteği sonlandırıldı) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Ortalama görüntülenebilirlik süresi (sn.) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Reklam gösterimleri |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | Reklam eBGBM'si |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Reklam istekleri |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Kapsam |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | Reklam isteği TO'su |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | Reklam isteği eBGBM'si |
| TIKLAMA SAYISI | AD_EXCHANGE_CLICKS | Tıklamalar |
| COST_PER_CLICK | AD_EXCHANGE_CPC | TBM |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Anlaşma reklam istekleri |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Anlaşma teklif yanıtları |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Anlaşma eşleşme oranı |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Anlaşma eşleşen istek sayısı |
| KAZANÇLAR | AD_EXCHANGE_ESTIMATED_REVENUE | Tahmini gelir |
| INDIVIDUAL_AD_IMPRESSIONS | (desteği sonlandırıldı) | (desteği sonlandırıldı) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | Reklam Tıklama oranı |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (yeni öneri) AD_EXCHANGE_AD_ECPM | (yeni öneri) Reklam eBGBM'si |
| LIFT_RATE | AD_EXCHANGE_LIFT | Artış |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Eşleşen istekler |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | TO |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | Eşleşen eBGBM |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Video vazgeçme oranı |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Video ayrılma oranı |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Video 1. çeyrek |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Video 3. çeyrek |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | TrueView atlama oranı |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | TrueView görüntüleme sayısı |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView GO |
Boyutlar
Bu tablo, AdX Boyutlarını Ad Manager Boyutları ile eşleştirir.
| AdX Boyutu | Ad Manager Boyutu | Ad Manager Sorgu Aracı Adı |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Web mülkü |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Reklam konumları |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Etiketler |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Yok) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Envanter boyutları |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Reklamveren alanları |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Reklamverenler |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Reklamveren sektörleri |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Ajanslar |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Yok) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Markalar |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Yok) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Markalama Türleri |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Yok) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Alıcı ağları |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Yok) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Ülkeler |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Reklam boyutları |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Yok) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Yok) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Kanallar |
| TARİH | AD_EXCHANGE_DATE | Günler |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Anlaşma kimlikleri |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Fırsat adları |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Yok) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | DFP Reklam Birimleri |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | İstek kaynakları |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Siteler |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP'ler |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Genişletilebilir türler |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Envanter sahipliği |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Ağ iş ortağı adları |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Uygulama adları |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Operatör adları |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Cihazlar |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Envanter türleri |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | İşletim sistemleri |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Bant genişliği |
| AY | AD_EXCHANGE_MONTH | Ay |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Cihaz kategorileri |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Yok) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Ürünler |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Yok) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Hedefleme türleri |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Yok) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | İşlem türleri |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Yok) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL'ler |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Yok) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Video reklam süreleri |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Video reklam türleri |
| HAFTA | AD_EXCHANGE_WEEK | Hafta |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Yok) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Fiyatlandırma kuralları |