ProductSearchQueryPerformanceReportColumn 値セット - レポート
ProductSearchQueryPerformanceReportRequest に含めることができる属性とパフォーマンス統計列を定義します。
レポートには、過去 30 日間に大量のクリックが発生した検索語句のデータのみが含まれます。
レポートに含める属性列は、統計の集計方法に影響する可能性があります。 つまり、一意の属性の要素によって行数が増加します。 詳細については、「 データをグループ化する列」を参照してください。
含める必要がある列の一覧については、以下の 「必須列 」セクションを参照してください。
レポートの集計データを取得できる時間単位、日単位、週単位、月単位、年単位、集計データの長さを確認するには、「 レポート データ保持期間」を参照してください。
構文
<xs:simpleType name="ProductSearchQueryPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="TimePeriod" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="AccountName" />
<xs:enumeration value="AdId" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="CampaignId" />
<xs:enumeration value="CampaignName" />
<xs:enumeration value="DestinationUrl" />
<xs:enumeration value="DeviceType" />
<xs:enumeration value="DeviceOS" />
<xs:enumeration value="Language" />
<xs:enumeration value="SearchQuery" />
<xs:enumeration value="Network" />
<xs:enumeration value="MerchantProductId" />
<xs:enumeration value="Title" />
<xs:enumeration value="ClickTypeId" />
<xs:enumeration value="TotalClicksOnAdElements" />
<xs:enumeration value="ClickType" />
<xs:enumeration value="AdGroupCriterionId" />
<xs:enumeration value="ProductGroup" />
<xs:enumeration value="PartitionType" />
<xs:enumeration value="Impressions" />
<xs:enumeration value="Clicks" />
<xs:enumeration value="Ctr" />
<xs:enumeration value="AverageCpc" />
<xs:enumeration value="Spend" />
<xs:enumeration value="Conversions" />
<xs:enumeration value="ConversionRate" />
<xs:enumeration value="Assists" />
<xs:enumeration value="CostPerAssist" />
<xs:enumeration value="Revenue" />
<xs:enumeration value="CostPerConversion" />
<xs:enumeration value="RevenuePerConversion" />
<xs:enumeration value="RevenuePerAssist" />
<xs:enumeration value="CustomerId" />
<xs:enumeration value="CustomerName" />
<xs:enumeration value="AssistedImpressions" />
<xs:enumeration value="AssistedClicks" />
<xs:enumeration value="AssistedConversions" />
<xs:enumeration value="AllConversions" />
<xs:enumeration value="AllRevenue" />
<xs:enumeration value="AllConversionRate" />
<xs:enumeration value="AllCostPerConversion" />
<xs:enumeration value="AllRevenuePerConversion" />
<xs:enumeration value="Goal" />
<xs:enumeration value="GoalType" />
<xs:enumeration value="AbsoluteTopImpressionRatePercent" />
<xs:enumeration value="AverageCpm" />
<xs:enumeration value="ConversionsQualified" />
<xs:enumeration value="AssistedConversionsQualified" />
<xs:enumeration value="AllConversionsQualified" />
<xs:enumeration value="CampaignType" />
<xs:enumeration value="AssetGroupId" />
<xs:enumeration value="AssetGroupName" />
</xs:restriction>
</xs:simpleType>
値
ProductSearchQueryPerformanceReportColumn の値セットには、AbsoluteTopImpressionRatePercent、AccountId、AccountName、AccountNumber、AdGroupCriterionId、AdGroupId、AdGroupName、AdId、AllConversionRate、AllConversions、AllConversionsQualified、AllCostPerConversion、AllRevenue、AllRevenuePerConversion、AllRevenuePerConversion、 AssetGroupId、AssetGroupName、AssistedClicks、AssistedConversions、AssistedConversionsQualified、AssistedImpressions、Assists、AverageCpc、AverageCpm、CampaignId、CampaignId、CampaignName、CampaignType、Clicks、ClickType、ClickTypeId、ConversionRate、Conversions、ConversionsQualified、CostPerAssist、CostPerConversion、Ctr、CustomerId、CustomerName、DestinationUrl、DeviceOS、DeviceType、Goal、GoalType、インプレッション、言語、MerchantProductId、ネットワーク、PartitionType、ProductGroup、Revenue、RevenuePerAssist、RevenuePerAssist、RevenuePerConversion、 SearchQuery、Spend、TimePeriod、Title、TotalClicksOnAdElements。
値 | 説明 |
---|---|
AbsoluteTopImpressionRatePercent | 広告がすべての結果の最初の位置にあった頻度 (インプレッション総数に対する割合)。 数値が大きいほど、広告が最適な広告の位置に頻繁に表示されていることを示します。 データが使用できない場合、この列の値は空です。 Hourly 集計も HourOfDay 集計もサポートされていません。 Hourly 集計または HourOfDay 集計にこの列を含める場合、サービスはエラーを返しません。この列に対して返されるパフォーマンス データは無視する必要があります。 |
AccountId | アカウントの Microsoft Advertising 割り当て識別子。 |
AccountName | アカウント名。 |
AccountNumber | アカウントの Microsoft Advertising 割り当て番号。 |
AdGroupCriterionId | 広告グループの条件の Microsoft Advertising 割り当て識別子。 注: パフォーマンスの上限キャンペーンでは、これは ListingGroupId です。 |
AdGroupId | 広告グループの Microsoft Advertising 割り当て識別子。 |
AdGroupName | 広告グループ名。 |
AdId | 広告の Microsoft Advertising 割り当て識別子。 |
AllConversionRate | 換算率をパーセンテージで示します。 クリックの合計数で割ったコンバージョンの数。 たとえば、キャンペーンの広告が 300 回クリックし、4 回のコンバージョンを獲得した場合、コンバージョン率は 1.33 (%) です。 変換率を計算するための数式は、(コンバージョン数/クリック数) x 100 です。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の ConversionRate レポート列からデータが除外されます。 AllConversionRate 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
AllConversions | 変換の数。 コンバージョンとは、広告を表示した後の顧客によるアクションの完了です。 このアクションは、製品の購入、ウェビナーへの登録、組織への参加、または広告の成功の目標と最善の尺度を考慮した場合などです。 コンバージョンは、サイト内の訪問者の進行状況を追跡できるように、Web サイト ページにコードを少し追加することで測定されます。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の [コンバージョン] レポート列からデータが除外されます。 AllConversions 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 この列は 2022 年の時点で非推奨であるため、代わりに AllConversionsQualified 列を使用する必要があります。 今後、パフォーマンス レポートでは、この列に "0" (ゼロ) が返されます。 廃止日より前の期間の履歴データは、公開された データ保持期間に従って引き続き使用できます。 |
AllConversionsQualified | 変換の数。 コンバージョンとは、広告を表示した後の顧客によるアクションの完了です。 このアクションは、製品の購入、ウェビナーへの登録、組織への参加、または広告の成功の目標と最善の尺度を考慮した場合などです。 コンバージョンは、サイト内の訪問者の進行状況を追跡できるように、Web サイト ページにコードを少し追加することで測定されます。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の [コンバージョン] レポート列からデータが除外されます。 AllConversions 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 データ型は、部分的に外部に属性付けされたオフライン変換があるかどうかに関係なく 、倍の 値として使用する必要があります。 誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください - それはすぐに来ています! |
AllCostPerConversion | コンバージョンあたりのコスト。 コンバージョンあたりのコストを計算するための数式は (Spend / Conversions) です。 コンバージョントラッキングを有効にするキャンペーンの広告のみがコンバージョン番号に貢献するため、アカウント内のすべてのキャンペーンでコンバージョントラッキングが有効になっていない限り、その数値は正確ではありません。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標のデータは、CostPerConversion レポート列から除外されます。 AllCostPerConversion 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
AllRevenue | 必要に応じて、コンバージョンの結果として広告主によって報告される収益。 ExcludeFromBidding プロパティを true に設定すると、コンバージョン目標の [収益レポート] 列からデータが除外されます。 AllRevenue 列には、ExcludeFromBidding 設定に関係なく、すべてのコンバージョン目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
AllRevenuePerConversion | コンバージョンあたりの収益。 換算ごとの収益を計算するための数式は 、(収益/換算) です。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の RevenuePerConversion レポート列からデータが除外されます。 AllRevenuePerConversion 列には、ExcludeFromBidding 設定に関係なく、すべてのコンバージョン目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
AssetGroupId | 資産グループの Microsoft Advertising 割り当て識別子。 |
AssetGroupName | 資産グループ名。 |
AssistedClicks | 製造元パートナーから共同入札を受けた広告をクリックします。 クリックは支払い額です。 通常、クリックには、検索結果ページまたは検索ネットワーク上の Web サイトで広告をクリックしたユーザーが含まれます。 クリックは、他のソース (スパイダー、ロボット、テスト サーバーなど) から取得することもできます。 このパフォーマンス統計は、Microsoft ショッピング キャンペーンのスポンサー製品でのみ使用できます。 |
AssistedConversions | 変換の数。 コンバージョンとは、広告を表示した後の顧客によるアクションの完了です。 このアクションは、製品の購入、ウェビナーへの登録、組織への参加、または広告の成功の目標と最善の尺度を考慮した場合などです。 コンバージョンは、サイト内の訪問者の進行状況を追跡できるように、Web サイト ページにコードを少し追加することで測定されます。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の [コンバージョン] レポート列からデータが除外されます。 AllConversions 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
AssistedConversionsQualified | 将来使用するために予約されています。 |
AssistedImpressions | 製造元パートナーが共同入札している広告が、Microsoft Advertising Network の検索結果ページまたはその他のサイトに表示された回数。 このパフォーマンス統計は、Microsoft ショッピング キャンペーンのスポンサー製品でのみ使用できます。 |
アシスト | この広告から 1 回以上クリックしたのと同じアカウント内の他の広告からのコンバージョンの数。 広告は、コンバージョンがクレジットされた最後にクリックされた広告の前にクリックされた場合、コンバージョンを支援したと見なされます。 さらに、アシストに対応するクリックは、目標の変換期間内に行う必要があります。 |
AverageCpc | クリックあたりの平均コスト (CPC)。 広告のすべてのクリックの合計コストをクリック数で割った値です。 これは、広告がクリックされるたびに実際に請求される平均金額です。 たとえば、300 回のクリックに対して合計 48.35 を支払った場合、平均クリック単価は 0.16 です。 平均クリック単価を計算するための数式は 、(費用/クリック数) です。 |
AverageCpm | 総広告コストをインプレッション数 (千単位)で割った値です<br/ ラテン語では、mille は 1000 を意味します。 また、1000 あたりの平均コスト (CPT) とも呼ばれることもあります。 これは、お客様の支出とインプレッション数に基づいて計算される標準的な広告業界のパフォーマンス メトリックです。 CPM ベースの広告予算作成の目標は、大規模なユーザーにブランドの認識を高めることです。 CPM は、ターゲットとするユーザーの種類に対して広告を取得するコストを示します。 |
CampaignId | キャンペーンの Microsoft Advertising 割り当て識別子。 |
CampaignName | キャンペーン名。 |
CampaignType | キャンペーンの種類。 対象 ユーザー、 動的検索、 パフォーマンスの最大値、 検索 & コンテンツ、 ショッピングなどの値を指定できます。 |
クリック | クリックは支払い額です。 通常、クリックには、検索結果ページまたは検索ネットワーク上の Web サイトで広告をクリックしたユーザーが含まれます。 クリックは、他のソース (スパイダー、ロボット、テスト サーバーなど) から取得することもできます。 詳細については、「 Microsoft Advertising のクリック測定: 手法の説明」を参照してください。 |
ClickType | クリックの種類は、ユーザーがクリックできる広告の各コンポーネントを指します。 可能なクリックの種類は、広告タイトル、画像、電話番号、ルート案内、サイトリンク、レビューです。 |
ClickTypeId | クリックの種類 ID。 |
ConversionRate | 換算率をパーセンテージで示します。 クリックの合計数で割ったコンバージョンの数。 たとえば、キャンペーンの広告が 300 回クリックし、4 回のコンバージョンを獲得した場合、コンバージョン率は 1.33 (%) です。 変換率を計算するための数式は、(コンバージョン数/クリック数) x 100 です。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の ConversionRate レポート列からデータが除外されます。 AllConversionRate 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
変換 | 変換の数。 コンバージョンとは、広告を表示した後の顧客によるアクションの完了です。 このアクションは、製品の購入、ウェビナーへの登録、組織への参加、または広告の成功の目標と最善の尺度を考慮した場合などです。 コンバージョンは、サイト内の訪問者の進行状況を追跡できるように、Web サイト ページにコードを少し追加することで測定されます。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の [コンバージョン] レポート列からデータが除外されます。 AllConversions 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 この列は 2022 年の時点で非推奨であるため、代わりに ConversionsQualified 列を使用する必要があります。 今後、パフォーマンス レポートでは、この列に "0" (ゼロ) が返されます。 廃止日より前の期間の履歴データは、公開された データ保持期間に従って引き続き使用できます。 |
ConversionsQualified | 変換の数。 コンバージョンとは、広告を表示した後の顧客によるアクションの完了です。 このアクションは、製品の購入、ウェビナーへの登録、組織への参加、または広告の成功の目標と最善の尺度を考慮した場合などです。 コンバージョンは、サイト内の訪問者の進行状況を追跡できるように、Web サイト ページにコードを少し追加することで測定されます。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の [コンバージョン] レポート列からデータが除外されます。 AllConversions 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 データ型は、部分的に外部に属性付けされたオフライン変換があるかどうかに関係なく 、倍の 値として使用する必要があります。 誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください - それはすぐに来ています! |
CostPerAssist | アシストあたりのコスト。 アシストあたりのコストを計算するための数式は 、(Spend/Assists) です。 |
CostPerConversion | コンバージョンあたりのコスト。 コンバージョンあたりのコストを計算するための数式は (Spend / Conversions) です。 コンバージョントラッキングを有効にするキャンペーンの広告のみがコンバージョン番号に貢献するため、アカウント内のすべてのキャンペーンでコンバージョントラッキングが有効になっていない限り、その数値は正確ではありません。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標のデータは、CostPerConversion レポート列から除外されます。 AllCostPerConversion 列には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
Ctr | クリック率 (CTR) は、広告がクリックされた回数を、広告が表示された回数 (インプレッション数) で割った値です。 たとえば、2,348 インプレッション数で 50 クリックした広告の場合、CTR は 2.13 (%) です。 CTR を計算するための数式は 、(クリック数/インプレッション数) x 100 です。 |
CustomerId | 顧客の Microsoft Advertising 割り当て識別子。 |
CustomerName | 顧客名。 |
DestinationUrl | 広告、キーワード、または広告グループの条件の宛先 URL 属性。 宛先 URL に動的テキスト置換パラメーター ({param1}など) が含まれている場合、置換が行われると、レポートには URL が含まれます。 |
DeviceOS | DeviceType 列で報告されたデバイスのオペレーティング システム。 使用できる値には、 Android、 Blackberry、 iOS、 Other、 Unknown、 Windows などがあります。 デバイスのオペレーティング システムを特定できない場合、またはターゲットにできるオペレーティング システムの 1 つでない場合、この列の値は [不明] になります。 |
DeviceType | デバイス OS ターゲット入札のデバイス名属性。 広告を表示したデバイスの種類。 使用可能な値には、 コンピューター、 スマートフォン、 タブレット、 不明などがあります。 |
目標 | 目的のコンバージョンに設定する目標の名前。つまり、広告をクリックした後にユーザーが実行するアクションを意味します。 |
GoalType | コンバージョン目標の種類。 使用可能な値には、 AppInstall、 Duration、 Event、 InStoreTransaction、 OfflineConversion、 PagesViewedPerVisit、 URL などがあります。 |
インプレッション | 検索結果ページに広告が表示された回数。 インプレッションがない場合、クリックやコンバージョンはありません。 |
言語 | 広告が表示された発行元の言語。 使用可能な値については、 広告言語の [言語] 列を参照してください。 言語の表示名は、レポートで提供されます ( 英語など)。 |
MerchantProductId | 各製品オファーのマーチャントによって提供される一意の識別子。 |
Network | Microsoft Advertising Network 全体が Microsoft サイトで構成され、トラフィック、クロスネットワーク トラフィック、パートナー トラフィックのみを選択します (このネットワークの種類は 2024 年 7 月の時点で非推奨です)。 このデータを使用して、広告グループのネットワーク選択を最適に判断します。 使用可能な値には、AOL 検索、対象ユーザー、Microsoft サイト、トラフィック、コンテンツ、シンジケート検索パートナーの選択が含まれます。 注: すべてのユーザーが 値 Microsoft サイトを使用してトラフィックを選択 できるわけではありません。 あなたができない場合は、心配しないでください - それはすぐに来ています! |
PartitionType | 製品パーティションの種類。 |
ProductGroup | オペランド = 属性として報告される、製品条件の下位スラッシュ区切りリスト。 属性値は"" (二重引用符) で囲まれています。 例を次に示します。 * / Category="動物 & ペット用品" / Category="Pet supplies" / Category="Bird supplies"。 "*" (1 つのアスタリスク) は、製品グループの他のフィルター以外のすべてに一致する製品グループを指します。 注: パフォーマンスの上限キャンペーンでは、これは ListingGroup です。 |
収入 | 必要に応じて、コンバージョンの結果として広告主によって報告される収益。 ExcludeFromBidding プロパティを true に設定すると、コンバージョン目標の [収益レポート] 列からデータが除外されます。 AllRevenue 列には、ExcludeFromBidding 設定に関係なく、すべてのコンバージョン目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
RevenuePerAssist | アシストあたりの収益。 アシストあたりの収益を計算するための数式は (収益/アシスト)です。 |
RevenuePerConversion | コンバージョンあたりの収益。 換算ごとの収益を計算するための数式は 、(収益/換算) です。 ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の RevenuePerConversion レポート列からデータが除外されます。 AllRevenuePerConversion 列には、ExcludeFromBidding 設定に関係なく、すべてのコンバージョン目標のデータが含まれます。 Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。 |
SearchQuery | 潜在的な対象ユーザーが使用する検索用語。 |
費やす | クリックあたりのコスト (CPC) は、クリックごとに合計されます。 |
TimePeriod | 各レポート行の期間。 要求オブジェクトの Aggregation 要素が Summary に設定されている場合、この列を含めないようにすることができます。 詳細については、「 期間列」を参照してください。 |
Title | 製品アイテム名。 たとえば、書籍、DVD、ゲームのタイトルなどです。 |
TotalClicksOnAdElements | この広告要素がクリックされたかどうかに関係なく、広告のコピーにこの広告要素が存在した場合のクリック数。 |
注釈
必須列
レポートには、少なくとも次の列が含まれている必要があります。 一般的なルールとして、各レポートには少なくとも 1 つの属性列と少なくとも 1 つの非インプレッション共有パフォーマンス統計列が含まれている必要があります。 詳細については、「 レポート属性とパフォーマンス統計」を参照してください。
注:
TimePeriod 列は、Summary を除くすべての集計の種類に対して想定されます。 TimePeriod を含まない場合、選択した集計は無視され、Summary 集計は関係なく使用されることに注意してください。
Column |
---|
AccountName |
CampaignName |
SearchQuery |
TimePeriod |
要件
サービス: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13