共用方式為

DestinationUrlPerformanceReportRequest 數據物件 - 報告

  • 發行項

定義目的地 URL 效能報告要求。 使用此報表來識別符合物件期望的登陸頁面，並可能導致高點擊率或轉換率。

您可以要求登陸頁面的曝光數、點選次數、花費和平均成本。 下載之後，即可依目的地 URL、帳戶、行銷活動和廣告群組來排序此數據。

若要要求此類型的報表，請將此對象傳遞至 SubmitGenerateReport 作業。

注意事項

您不應該使用此報告來取得Microsoft購物活動的效能數據。 它只適用於其他營銷活動類型。

<xs:complexType name="DestinationUrlPerformanceReportRequest" 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:ArrayOfDestinationUrlPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:DestinationUrlPerformanceReportFilter" />
        <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>

元素

DestinationUrlPerformanceReportRequest 物件具有下列元素：匯總、數據行、篩選、範圍、時間。

元素 描述 資料類型
集合體 用來匯總報表數據的匯總類型。 例如，您可以依日或周匯總報表數據，或要求摘要報表。

默認匯總為 Summary。 請務必注意，如果您未在數據行清單中包含 TimePeriod ，則會忽略您選擇的匯總，不論為何都會使用摘要匯總。		 ReportAggregation
Columns 要包含在報表中的屬性和效能統計數據清單。 報表會以您指定資料行的順序來包含這些數據行。 DestinationUrlPerformanceReportColumn 陣 列
篩選器 用來篩選報表數據的篩選資訊。 DestinationUrlPerformanceReportFilter
範圍 報表的實體範圍。

使用此元素可將報表數據限制為特定帳戶、廣告群組或營銷活動。		 AccountThroughAdGroupReportScope
時間 要用於報表的時間週期。 您可以指定自定義日期範圍，或選取預先定義的日期範圍，例如 Today 或 ThisWeek。

如需您可以為每個匯總類型指定的時間週期清單，請參閱 匯總和時間。

您可以在 ReportTime 物件內設定時區，以協助您精確地設定所要求時段的數據範圍。

如果您未選擇時區，報表服務預設會使用 PacificTimeUSCanadaTi要a。		 ReportTime

DestinationUrlPerformanceReportRequest 物件具有 Inherited Elements。

繼承的專案

從 ReportRequest 繼承的專案

DestinationUrlPerformanceReportRequest 物件衍生自 ReportRequest 物件，並繼承下列元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下列描述專屬於 DestinationUrlPerformanceReportRequest，而且可能不適用於從 ReportRequest 物件繼承相同元素的其他物件。

元素 描述 資料類型
ExcludeColumnHeaders 判斷下載的報表是否應該包含每個數據行的標頭描述。 報表數據行標頭符合要求的數據行名稱，例如 [曝光數 ] 和 [ 按兩下]。

如果您想要將報表數據行標頭從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。		 布爾
ExcludeReportFooter 判斷下載的報表是否應該包含頁尾元數據，例如Microsoft著作權 (@2020 Microsoft Corporation。保留的所有許可權。) 。

如果您想要將報表頁尾元數據從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。		 布爾
ExcludeReportHeader 判斷下載的報表是否應該包含標頭元數據，例如報表名稱、日期範圍和匯總。

如果您想要從下載的報表中排除報表標頭元數據，請將此屬性設為 true 。 預設值為 false。		 布爾
格式 報表數據的格式。 例如，您可以要求以逗號分隔值 (Csv) 格式或索引標籤分隔值 (Tsv) 格式的數據。

預設值為 Csv。

所有下載的檔案都會壓縮。		 ReportFormat
FormatVersion 決定所下載報表檔案中特定欄位的格式。

某些欄位的數據格式可以在目前的 API 版本內更新，而不會中斷現有的用戶端應用程式。 您可以將此選擇性要求字段設定為 2.0，以取得最新的資料格式。 如果您未設定此欄位，服務預設為 1.0 版。

如需格式版本之間變更的詳細資訊，請 參閱報表格式版本。		 string
ReportName 報表的名稱。 名稱包含在報表標頭中。 如果您未指定報表名稱，系統會以 ReportType-ReportDateTime 格式產生名稱。

報表名稱的最大長度為 200。		 string
ReturnOnlyCompleteData 判斷服務是否必須確定所有數據都已處理且可供使用。

如果設為 true ，而且系統尚未根據要求的 匯總、 範圍和 時間完成處理所有數據，服務會傳回錯誤碼 NoCompleteDataAvaliable (2004) 。 否則，根據預設，要求可能會成功，並不會指出數據是否已完成，而且報表只會包含系統在要求時已完成處理的數據。

請注意，因為今天仍在進行中，而且數據尚未完成，所以如果 [時間] 期間 (自定義或預先定義的日期) 包含今天的日期，您就無法將此元素設定為 true。 如需詳細資訊，請參閱 報表中的時區。		 布爾

需求

服務： ReportingService.svc v13
命名空間： https://bingads.microsoft.com/Reporting/v13