Google Ad Manager, hem raporlama hem de trafik işlemlerini etkileyen öğeleri (ör. LineItems) değiştirmek için bir SOAP API sunar.
İstemci kitaplıkları çeşitli dillerde kullanılabilir. AdX Seller API gibi Ad Manager API de kimlik doğrulama için OAuth2'yi kullanır.
İlk API isteğinizi göndermeye başlamak için Başlangıç bölümüne bakın.
Ad Manager API'de raporlama
Ad Manager API ReportService, raporları çalıştırmak ve indirmek için iki yöntem sunar:
- Kullanıcı arayüzünde bir sorgu oluşturma ve kimliğine göre çalıştırma.
- Geçici bir ReportQuery oluşturma.
Her iki seçenekte de API iş akışı dört adımdan oluşur:
- runReportJob işlevini çağırın.
- getReportJobStatus kullanarak rapor durumunu yoklayın.
- getReportDownloadUrlWithOptions kullanarak tamamlanan raporun URL'sini alın.
- Döndürülen URL'den raporu indirin.
Daha fazla ayrıntı için raporlama kılavuzuna bakın.
Raporlama Saat Dilimleri
Ad Exchange Seller REST API'nin aksine, Ad Manager API raporları varsayılan olarak ağınızın saat diliminde oluşturulur. 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 Seller REST API metrikleri ve boyutları artık Ad Manager Reporting API'de yer alıyor. Bazı adlar değişti ve bazıları kullanımdan kaldırıldı. Ayrıntılar için lütfen aşağıdaki tablolara bakın.
Metrikler / Sütunlar
Bu tabloda, AdX metrikleri Ad Manager sütunlarıyla eşlenir.
| 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'nin etkin olduğu gösterimler |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Aktif görüntüleme ölçülen gösterimler |
| ACTIVE_VIEW_MEASURABLE_RATIO | (kullanımdan kaldırıldı) | (kullanımdan kaldı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 | (kullanımdan kaldırıldı) | (kullanımdan kaldı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 istekler |
| KAZANÇLAR | AD_EXCHANGE_ESTIMATED_REVENUE | Tahmini gelir |
| INDIVIDUAL_AD_IMPRESSIONS | (kullanımdan kaldırıldı) | (kullanımdan kaldı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 istek sayısı |
| 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ülemeleri |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView görüntüleme oranı |
Boyutlar
Bu tabloda, AdX boyutları Ad Manager boyutlarıyla eşlenir. .
| 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 | (Kullanılamıyor) |
| 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 | (Kullanılamıyor) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Markalar |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Kullanılamıyor) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Markalama Türleri |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Kullanılamıyor) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Alıcı ağları |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Kullanılamıyor) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Ülkeler |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Reklam boyutları |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Kullanılamıyor) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Kullanılamıyor) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Kanallar |
| TARİH | AD_EXCHANGE_DATE | Gün |
| 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 | (Kullanılamıyor) |
| 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 | Talep Tarafı Platformları |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Genişletme türleri |
| 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 | Kargo şirketi 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 | (Kullanılamıyor) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Ürünler |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Kullanılamıyor) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Hedefleme türleri |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Kullanılamıyor) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | İşlem türleri |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Kullanılamıyor) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL'ler |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Kullanılamıyor) |
| 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 | (Kullanılamıyor) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Fiyatlandırma kuralları |