Google Ads API, reklamlarınızın nerede gösterildiğini ve nasıl performans gösterdiğini analiz etmek için çeşitli görünümler sunar:
managed_placement_view,
group_placement_view,
detail_placement_view ve
performance_max_placement_view. Her görünüm, yerleşim verilerinize farklı bir açıdan bakmanızı sağlar.
Yönetilen yerleşim görünümü
- Gösterdiği bilgiler:
managed_placement_viewkaynağı, açıkça hedeflediğiniz yerleşimlere (yönetilen yerleşimler) göre toplanan performans verilerini sağlar.Placementölçütünüzün performansını yansıtır. - Kullanıcı arayüzündeki karşılığı: İçerik > Yerleşimler
- Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
Örnek sorgu
Yönetilen yerleşimlerin son 30 güne ait performans metriklerini almak için:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Grup yerleşimi görünümü
- Gösterdiği bilgiler:
group_placement_viewkaynağı, yerleşimlerin açıkça hedeflenip hedeflenmediğine veya Google'ın sistemi tarafından otomatik olarak keşfedilip keşfedilmediğine bakılmaksızın reklamlarınızın Görüntülü Reklam Ağı ve YouTube'da gerçekte nerede yayınlandığını gösterir. Bu yerleşimler web siteleri, YouTube kanalları veya videoları ve uygulamalar olabilir. - Kullanıcı arayüzündeki karşılığı: İçerik > Reklamların gösterildiği yerler
- Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
"Toplam: Diğer" satırı
Rapor oluşturma sürecini hızlandırmak için group_placement_view ve detail_placement_view kaynakları, minimum gösterim veya etkileşim etkinliği eşiğini karşılamayan tekil yerleşimleri hariç tutar.
- Google Ads kullanıcı arayüzünde: Kullanıcı arayüzü, bu etkinlik eşiğini karşılamayan yerleşimleri Toplam: Diğer etiketli bir özet satırında birleştirir.
- Google Ads API'de: API, etkinlik eşiğini karşılamayan yerleşimleri rapor sonuçlarından çıkarır ve
group_placement_view.placementveyadetail_placement_view.placementalanının"Other"değerine sahip olduğu bir özet satırı döndürmez.
Bu nedenle, group_placement_view ve detail_placement_view kaynaklarındaki bağımsız yerleşim satırlarının toplamı, reklam grubu veya kampanyanın toplam metriklerinden daha düşük olabilir. Daha fazla bilgi için "Reklamların gösterildiği yerler" raporu hakkında başlıklı makaleyi inceleyin. Eşiklerin ve eksik meta verilerin görünümler arası karşılaştırmaları nasıl etkilediği hakkında ayrıntılı bilgi için Yerleşim görünümleri arasındaki metrik farklılıkları ve Kullanılamayan yerleşim ayrıntılarını içeren satırlar başlıklı makaleleri inceleyin.
TargetingSetting seçenekleri
group_placement_view öğesinin davranışı ve yardımcı programı, reklam grubu düzeyinde PLACEMENT boyutu için TargetingSetting öğesinden etkilenir. Bu ayar, her biri reklamlarınızın yalnızca hedeflenen yerleşimlerde mi yoksa diğer yerleşimlerde de mi gösterileceğini belirleyen bir bid_only boole alanı içeren target_restrictions listesini içerir. "Hedefleme" ve "Gözlem" ayarları hakkında başlıklı makaleyi inceleyin.
bid_only = false: Bu değer, yerleşimler için Google Ads kullanıcı arayüzündeki Hedefleme'ye karşılık gelir. Reklam grubunuz "Hedefleme" olarak ayarlanmışsa reklamlarınız yalnızca ölçüt olarak açıkça eklediğiniz yerleşimlerde gösterilir. Bu yerleşimlere teklif ayarlamaları uygulamayı seçebilirsiniz. Bu senaryoda,group_placement_viewbüyük ölçüdemanaged_placement_view'ı yansıtır ancak yine de minimum etkinlik eşiklerine tabidir.bid_only = true: Bu değer, yerleşimler için Google Ads kullanıcı arayüzündeki Gözlem değerine karşılık gelir. Reklam grubunuz "Gözlem" olarak ayarlanmışsa reklamlarınız Görüntülü Reklam Ağı ve YouTube'daki tüm uygun yerleşimlerde gösterilebilir. Hedeflediğiniz yerleşimlere de teklif ayarlamaları uygulayabilirsiniz. Bu durumda, reklamlarınızın gösterildiği yeni yerleşimleri keşfetmek içingroup_placement_viewçok önemlidir. Bu yerleşimleri daha sonra yönetilen yerleşimler veya hariç tutulanlar olarak eklemeyi seçebilirsiniz.
Ayrıntılı yerleşim görünümü
- Gösterdikleri:
detail_placement_viewkaynağı, yerleşimlerin daha ayrıntılı bir dökümünü sunarak alan veya kanal düzeyinin ötesinde ayrıntılar sağlar. Örneğin, reklamlarınızın gösterildiği belirli URL'leri veya YouTube video kimliklerini gösterebilir. - Kullanıcı arayüzündeki karşılığı: İçerik > Reklamların gösterildiği yerler bölümünde satırları seçip Ayrıntıları göster'i tıklamaya eşdeğerdir.
- Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
- Önemli Noktalar:
group_placement_viewkaynağına benzer şekilde, bu görünümde minimum etkinlik eşiklerini karşılamayan düşük etkinlikli yerleşimler atlanır ("Toplam: Diğer" satırı bölümüne bakın).
Yerleşim görünümleri arasındaki metrik farklılıkları
Minimum etkinlik eşiği, her ayrıntı düzeyinde bağımsız olarak değerlendirilir:
group_placement_viewkaynağı, birleştirilmiş alan, mobil uygulama veya YouTube kanalı genelinde eşiği değerlendirir.detail_placement_viewkaynağı, eşiği her bir sayfa URL'si veya YouTube videosu için ayrı ayrı değerlendirir.
detail_placement_view kaynağı, eşiği karşılamayan sayfa URL'lerini veya YouTube videolarını hariç tutar. Sonuç olarak, bir alan adı veya YouTube kanalı için detail_placement_view satırlarının toplanması (detail_placement_view.group_placement_target_url alanına göre filtrelenmiş), ilgili group_placement_view satırından daha az gösterim döndürebilir.
Yerleşim ayrıntıları kullanılamayan satırlar
group_placement_view veya detail_placement_view kaynağına yönelik bir sorgu, aynı reklam grubunda placement, display_name ve target_url alanları ayarlanmamış ve aynı resource_name değerine (ör. ~MTRf ile biten) sahip birden fazla satır döndürebilir.
Bu durum aşağıdaki nedenlerden kaynaklanır:
- Dahili yerleşim gruplandırması: Her iki görünüm de performans metriklerini
resource_nameveyaplacementdize alanlarına göre değil, benzersiz bir dahili yerleşim tanımlayıcısına göre gruplandırır. - Kullanılamayan yerleşim meta verileri: Google Ads kullanıcı arayüzünde, arka uç arama tablolarında meta verileri olmayan yerleşimler Bilinmiyor, Kanal artık kullanılamıyor veya Video artık kullanılamıyor olarak görünür. API'de her farklı yerleşim tanımlayıcısı,
placement,display_namevetarget_urlalanları ayarlanmamış bir metrik satırı döndürmeye devam eder. - Sentezlenmiş kaynak adları:
resource_namealanındaki{base64_placement}son eki,{type_id}_{placement}değerinden Base64 ile kodlanmıştır. Burada{type_id},PlacementTypeenum numarası yerine dahili bir yerleşim türü tanımlayıcısıdır.placement_typealanıWEBSITE(dahili kimlik14) olduğunda veplacementalanı ayarlanmadığında"14_"dizesiMTRfolarak kodlanır (benzer şekilde,MOBILE_APPLICATION"55_"dizesiniNTVfolarak,YOUTUBE_VIDEO"89_"dizesiniODlfolarak veYOUTUBE_CHANNEL"90_"dizesiniOTBfolarak kodlar). Bu nedenle, aynı reklam grubunda kullanılamayan meta verilere sahip aynı türden birden fazla yerleşim, ayrı metrik satırları raporlarken aynıresource_namedeğerini paylaşır.
İstemci kodunda group_placement_view veya detail_placement_view sonuçları işlenirken satırların kopyalarını yalnızca resource_name alanına göre tekilleştirmeyin. Aksi takdirde, kullanılamayan meta verilerle farklı yerleşimlerdeki metriklerin üzerine yazılabilir.
Google Ads Sorgu Dili'nde kullanılamayan meta verilere sahip satırları hariç tutmak için target_url veya display_name alanını (ör. WHERE
detail_placement_view.target_url IS NOT NULL) filtreleyin. placement ve resource_name alanları filtrelenemez.
Maksimum Performans yerleşim görünümü
- Gösterdikleri:
performance_max_placement_viewkaynağı, Maksimum Performans reklamlarının yayınlandığı yerleşimler için gösterim verileri (metrics.impressions) sağlar. Sürüm 24 ve sonraki sürümlerde,performance_max_placement_viewmetriğinisegments.ad_network_type'a göre segmentlere ayırabilirsiniz (Sürüm 23'te desteklenmez). - Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
Hangi görünüm kullanılmalı?
- Etkin bir şekilde hedeflediğiniz ve teklif verdiğiniz yerleşimlerin performansını değerlendirmek için
managed_placement_viewkullanın. - Reklamlarınızın nerede göründüğünü tam olarak anlamak için
group_placement_viewkullanın. Bu, özellikle "Gözlem" ayarını kullanırken yeni hedefleme fırsatları veya hariç tutmalar keşfetmek için yararlıdır. - Reklamlarınızın gösterildiği belirli URL'ler veya videolar hakkında en ayrıntılı bilgileri almak için
detail_placement_viewraporunu kullanın. Bu rapor genelliklegroup_placement_viewraporunda ilgilenilen bir alan adı veya kanal belirlendikten sonra kullanılır. - Maksimum Performans kampanyalarının yerleşim gösterimlerini incelemek için
performance_max_placement_viewkullanın.