Reklam yerleşimini ve performansını izleme

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_view kaynağı, 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_constant kaynağı, managed_placement_view kaynağının ilişkilendirilmiş bir kaynağı değildir. Bunun yerine ad_group_criterion.mobile_app_category.mobile_app_category_constant alanını seçin (örneğin, mobileAppCategoryConstants/60503) veya metriklere ihtiyacınız olmadığında ad_group_criterion kaynağını sorgulayın.
  • Yalnızca yaprak görünen adları: Hem ad_group_criterion.display_name hem de mobile_app_category_constant.name alanları 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) ve 60503 (/All Apps/Apple App Store/Education) ölçüt kimliklerinin tümü name ve display_name alanları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_view kaynağı, 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.placement veya detail_placement_view.placement alanı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_view büyük ölçüde managed_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çin group_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_view kaynağı, 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_view kaynağı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_view kaynağı, birleştirilmiş alan, mobil uygulama veya YouTube kanalı genelinde eşiği değerlendirir.
  • detail_placement_view kaynağı, 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_name veya placement dize 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_name ve target_url alanları ayarlanmamış bir metrik satırı döndürmeye devam eder.
  • Sentezlenmiş kaynak adları: resource_name alanındaki {base64_placement} son eki, {type_id}_{placement} değerinden Base64 ile kodlanmıştır. Burada {type_id}, PlacementType enum numarası yerine dahili bir yerleşim türü tanımlayıcısıdır. placement_type alanı WEBSITE (dahili kimlik 14) olduğunda ve placement alanı ayarlanmadığında "14_" dizesi MTRf olarak kodlanır (benzer şekilde, MOBILE_APPLICATION "55_" dizesini NTVf olarak, YOUTUBE_VIDEO "89_" dizesini ODlf olarak ve YOUTUBE_CHANNEL "90_" dizesini OTBf olarak 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_name değ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_view kaynağı, 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_view metriğini segments.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_view kullanın.
  • Reklamlarınızın nerede göründüğünü tam olarak anlamak için group_placement_view kullanı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_view raporunu kullanın. Bu rapor genellikle group_placement_view raporunda 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_view kullanın.