SearchQueryPerformanceReportRequest Veri Nesnesi - Raporlama

Arama sorgusu performans raporu isteğini tanımlar. Reklamlarınızın gösterildiği sırada hedef kitlenizin ne aradığınızı görmek için bu raporu kullanın. Hem anahtar sözcük hem de negatif anahtar sözcük listelerinizde bilinçli eklemeler, kaldırmalar veya düzenlemeler yapmak için bu bilgileri kullanabilirsiniz.

Reklamlarınızı tetikleyen arama terimleri için gösterimler, tıklamalar, tıklama oranı ve ortalama konum isteyebilirsiniz. Örneğin, şu anahtar kelimelerle kampanya yürüten bir ipotek kredisi alacaklısıysanız: ipotek, ev ipotek ve ev öz sermayesi kredileri; rapor, "ipotek ücretleri" arama sorgusunun reklamınızın birçok gösterimiyle sonuçlandığını gösteriyorsa, büyük olasılıkla anahtar sözcük listenize "fiyatlar" ekleyebilirsiniz. Ancak, ters ipotek sağlamazsanız ve rapor arama sorgusunun "ters ipotek" sonucunun birçok izlenimle sonuçlandığını gösterirse, büyük olasılıkla negatif anahtar sözcükler listenize "ters ipotek" eklersiniz.

Rapor yalnızca son 30 gün içinde önemli sayıda tıklamayla sonuçlanan arama terimlerini içerir.

Bu veriler zaman içinde değişebileceğinden, anahtar sözcüklerinizin performans ölçümlerini almak için keywordPerformanceReportRequest kullanın.

Bu tür bir rapor istemek için bu nesneyi SubmitGenerateReport işlemine geçirin.

Sözdizimi

<xs:complexType name="SearchQueryPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfSearchQueryPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchQueryPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Öğe

SearchQueryPerformanceReportRequest nesnesi şu öğelere sahiptir: Toplama, Sütunlar, Filtre, Kapsam, Saat.

Öğe	Açıklama	Veri Türü
Toplama	Rapor verilerini toplamak için kullanılacak toplama türü. Örneğin, rapor verilerini güne veya haftaya göre toplayabilir veya bir özet raporu isteyebilirsiniz. Varsayılan toplama, Özet'tir. Sütunlar listesine TimePeriod eklemezseniz, seçtiğiniz toplamanın yoksayılacağını ve Özet toplamanın ne olursa olsun kullanılacağını unutmayın.	ReportAggregation
Sütun	Rapora eklenecek özniteliklerin ve performans istatistiklerinin listesi. Rapor, sütunları belirttiğiniz sırayla içerir.	SearchQueryPerformanceReportColumn dizisi
Filtrele	Rapor verilerini filtrelemek için kullanılacak filtre bilgileri.	SearchQueryPerformanceReportFilter
Kapsam	Raporun varlık kapsamı. Rapor verilerini belirli hesaplarla, reklam gruplarıyla veya kampanyalarla sınırlamak için bu öğeyi kullanın.	AccountThroughAdGroupReportScope
Saat	Rapor için kullanılacak zaman aralığı. Özel bir tarih aralığı belirtebilir veya bugün veya ThisWeek gibi önceden tanımlanmış bir tarih aralığı seçebilirsiniz. Her toplama türü için belirtebileceğiniz zaman aralıklarının listesi için bkz. Toplama ve Saat. ReportTime nesnesi içinde saat dilimini ayarlayabilirsiniz ve bu da istenen zaman aralığı için verilerin kapsamını doğru şekilde belirlemenize yardımcı olur. Saat dilimi seçmezseniz Raporlama hizmeti varsayılan olarak PacificTimeUSCanadaTijuana kullanır.	ReportTime

SearchQueryPerformanceReportRequest nesnesinin Devralınan Öğeleri vardır.

Devralınan Öğeler

ReportRequest'ten Devralınan Öğeler

SearchQueryPerformanceReportRequest nesnesi ReportRequest nesnesinden türetilir ve şu öğeleri devralır: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. Aşağıdaki açıklamalar SearchQueryPerformanceReportRequest'e özeldir ve Aynı öğeleri ReportRequest nesnesinden devralan diğer nesneler için geçerli olmayabilir.

Öğe	Açıklama	Veri Türü
ExcludeColumnHeaders	İndirilen raporun her sütun için üst bilgi açıklamaları içerip içermeyeceğini belirler. Rapor sütun başlığı istenen sütun adıyla eşleşir; örneğin gösterimler ve tıklamalar. Rapor sütun başlıklarının indirilen raporun dışında tutulmasını istiyorsanız bu özelliği true olarak ayarlayın. Varsayılan değer false'tur.	Boolean
ExcludeReportFooter	İndirilen raporun Microsoft telif hakkı (@2020 Microsoft Corporation) gibi alt bilgi meta verilerini içerip içermeyeceğini belirler. Tüm hakları saklıdır.). Rapor alt bilgisi meta verilerinin indirilen raporun dışında tutulmasını istiyorsanız bu özelliği true olarak ayarlayın. Varsayılan değer false'tur.	Boolean
ExcludeReportHeader	İndirilen raporun rapor adı, tarih aralığı ve toplama gibi üst bilgi meta verilerini içerip içermeyeceğini belirler. Rapor üst bilgisi meta verilerinin indirilen raporun dışında tutulmasını istiyorsanız bu özelliği true olarak ayarlayın. Varsayılan değer false'tur.	Boolean
Biçim	Rapor verilerinin biçimi. Örneğin, verileri virgülle ayrılmış değerler (Csv) biçiminde veya sekmeyle ayrılmış değerler (Tsv) biçiminde isteyebilirsiniz. Varsayılan değer Csv'dir. İndirilen tüm dosyalar ZIP ile sıkıştırılır.	Rapor Biçimi
Formatversion	İndirilen rapor dosyasındaki belirli alanların biçimini belirler. Belirli alanların veri biçimi, mevcut istemci uygulamalarını bozmadan geçerli API sürümünde güncelleştirilebilir. Bu isteğe bağlı istek alanını 2.0 olarak ayarlayarak en son veri biçimini alabilirsiniz. Bu alanı ayarlamazsanız, hizmet varsayılan olarak 1.0 sürümüne ayarlanır. Biçim sürümleri arasındaki değişiklikler hakkında ayrıntılı bilgi için bkz. Rapor Biçimi Sürümü.	Dize
Raporadı	Raporun adı. Ad rapor üst bilgisine eklenir. Bir rapor adı belirtmezseniz sistem, ReportType-ReportDateTime biçiminde bir ad oluşturur. Rapor adının uzunluğu üst sınırı 200'dür.	Dize
ReturnOnlyCompleteData	Hizmetin tüm verilerin işlendiğinden ve kullanılabilir olduğundan emin olması gerekip gerekmediğini belirler. true olarak ayarlanırsa ve sistem istenen Toplama, Kapsam ve Saat temelinde tüm verileri işlemeyi tamamlamamışsa, hizmet NoCompleteDataAvaliable (2004) hata kodunu döndürür. Aksi takdirde, istek varsayılan olarak başarılı olabilir, verilerin tamamlanıp tamamlanmadığına dair bir gösterge yoktur ve rapor yalnızca sistemin istek sırasında işlemeyi tamamladığı verileri içerir. Bugün hala devam ettiğinden ve veriler tamamlanmadığından, Zaman dönemi (özel veya önceden tanımlanmış tarih) bugünün tarihini içeriyorsa bu öğeyi true olarak ayarlayamazsınız. Daha fazla bilgi için bkz. Raporlamada Saat Dilimleri.	Boolean

Gereksinimler

Hizmet: ReportingService.svc v13
Ad alanı: https://bingads.microsoft.com/Reporting/v13