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. Google Ads kullanıcı arayüzündeki yerleşim ekranlarını kopyalayan, çalıştırılmaya hazır Google Ads Sorgu Dili (GAQL) ve curl sorguları için Sorgu kılavuzuna bakın.
Yönetilen yerleşim görünümü
- Gösterdikleri:
managed_placement_viewkaynağı, reklam gruplarınızda hedeflediğiniz pozitif yerleşim ölçütlerine göre toplanan performans verilerini sağlar. Bu görünüm, Google Ads kullanıcı arayüzünde İçerik > Yerleşimler altında yönetilen beş ölçüt türünün tümünü içerir: web siteleri, YouTube kanalları, YouTube videoları, mobil uygulamalar ve mobil uygulama kategorileri. - Kullanıcı arayüzündeki karşılığı: İçerik > Yerleşimler
- Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
Hedeflenen yerleşim ölçütü türleri
managed_placement_view kaynağındaki her satır, ad_group_criterion.type değeriyle eşleşen AdGroupCriterion alanını doldurur ve diğer yerleşim alanlarını ayarlanmamış olarak bırakır:
| Kullanıcı arayüzü yerleşim türü | ad_group_criterion.type değer |
Ölçüt ayrıntıları alanları | Notlar |
|---|---|---|---|
| Web siteleri | PLACEMENT |
ad_group_criterion.placement.url |
Hedef web sitesi veya alan URL'si. |
| YouTube kanalları | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
YouTube kanal kimliği. ad_group_criterion.display_name alanı, kanal adını döndürür. |
| YouTube videoları | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
YouTube video kimliği. ad_group_criterion.display_name alanı, video başlığını döndürür. |
| Uygulamalar | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
{platform}-{platform_native_id} biçiminde uygulama kimliği (iOS için 1-, Android için 2-) ve uygulama adı. |
| Uygulama kategorileri | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
mobileAppCategoryConstants/{mobile_app_category_id} biçiminde kaynak adı. Mobil uygulama kategorisi adları ve hiyerarşisi başlıklı makaleyi inceleyin. |
Örnek sorgu
Son 30 gün içinde hedeflenen tüm yerleşim türlerindeki performans metriklerini getirmek için türe özgü alanların yanı sıra ad_group_criterion.type alanını seçin:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Mobil uygulama kategorisi adları ve hiyerarşisi
Google Ads kullanıcı arayüzünde, hedeflenen mobil uygulama kategorileri tam mağaza yollarını gösterir (ör. Uygulama kategorileri > Apple App Store > Eğitim). Google Ads API'yi sorgularken aşağıdaki davranışları göz önünde bulundurun:
- Mobil uygulama kategorisi sabitlerini ilişkilendirme:
mobile_app_category_constantkaynağı,managed_placement_viewkaynağının ilişkilendirilmiş bir kaynağı değildir. Bunun yerinead_group_criterion.mobile_app_category.mobile_app_category_constantalanını seçin (örneğin,mobileAppCategoryConstants/60503) veya metriklere ihtiyacınız olmadığındaad_group_criterionkaynağını sorgulayın. - Yalnızca yaprak görünen adları: Hem
ad_group_criterion.display_namehem demobile_app_category_constant.namealanları yalnızca yaprak kategori adını (ör."Education"veya"Games") döndürür. Hiçbir alan, üst uygulama mağazası yolunu içermez. - Uygulama mağazası yolunu çözme: Google Play ve Apple App Store, farklı ölçüt kimliklerinde yaprak kategori adlarını paylaşır. Örneğin,
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education) ve60503(/All Apps/Apple App Store/Education) ölçüt kimliklerinin tümünamevedisplay_namealanlarında"Education"değerini döndürür. Kaynak adından{mobile_app_category_id}son ekini çıkarın ve Mobil uygulama kategorileri tablosunda veya CSV dosyasında tam hiyerarşi yolunu Hızlı Ara.
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
Örnek sorgu
Aşağıdaki sorgu, son 30 gün içinde reklamların gösterildiği alan adları, mobil uygulamalar ve YouTube kanalları için performans metriklerini getirir:
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
"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.
Yerleşim hedefleme ayarları
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).
Örnek sorgu
Sonuç hacmini sınırlamak için aşağıdaki sorgu, 7 günlük bir zaman aralığında URL düzeyinde ve video düzeyinde yerleşim metriklerini getirir. Büyük hesaplarda, campaign.id veya ad_group.id alanına göre daha fazla filtreleme yapın:
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
Yerleşim meta verilerinin kullanılamadığı satırları hariç tutmak için AND
detail_placement_view.target_url IS NOT NULL ekleyin (Yerleşim ayrıntılarının kullanılamadığı satırlar bölümüne bakın). Döndürülen resource_name alanlarına ihtiyacınız yoksa PARAMETERS
omit_unselected_resource_names = true ifadesini ekleyin.
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.
GAQL'de kullanılamayan meta verilere sahip satırları hariç tutmak için target_url veya display_name alanını filtreleyin. placement ve resource_name alanları filtrelenemez. Örneğin, WHERE group_placement_view.target_url IS
NOT NULL veya WHERE detail_placement_view.target_url IS NOT NULL kullanın.
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). - Kullanıcı arayüzündeki karşılığı: Analizler ve raporlar > Rapor düzenleyici > Maksimum Performans kampanyaları yerleşimi
- Sorgu Oluşturucu: Sorgu Oluşturucu'da keşfedin
Örnek sorgu
Aşağıdaki sorgu, son 30 gün içindeki Maksimum Performans kampanyaları için reklam ağı türüne göre segmentlere ayrılmış yerleşim gösterimlerini getirir:
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
Yerleşim görünümü seçme
- 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.