次の方法で共有


DSASearchQueryPerformanceReportColumn 値セット - レポート

DSASearchQueryPerformanceReportRequest に含めることができる属性とパフォーマンス統計列を定義します。

レポートには、過去 30 日間に大量のクリックが発生した検索語句のデータのみが含まれます。

レポートに含める属性列は、統計の集計方法に影響する可能性があります。 つまり、一意の属性の要素によって行数が増加します。 詳細については、「 データをグループ化する列」を参照してください。

含める必要がある列の一覧については、以下の 「必須列 」セクションを参照してください。

レポートの集計データを取得できる時間単位、日単位、週単位、月単位、年単位、集計データの長さを確認するには、「 レポート データ保持期間」を参照してください。

構文

<xs:simpleType name="DSASearchQueryPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountStatus" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignStatus" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupStatus" />
    <xs:enumeration value="AdId" />
    <xs:enumeration value="AdStatus" />
    <xs:enumeration value="SearchQuery" />
    <xs:enumeration value="Headline" />
    <xs:enumeration value="CategoryList" />
    <xs:enumeration value="LandingPageTitle" />
    <xs:enumeration value="FinalUrl" />
    <xs:enumeration value="DynamicAdTarget" />
    <xs:enumeration value="DynamicAdTargetId" />
    <xs:enumeration value="AdDistribution" />
    <xs:enumeration value="Language" />
    <xs:enumeration value="Network" />
    <xs:enumeration value="TopVsOther" />
    <xs:enumeration value="DeviceType" />
    <xs:enumeration value="DeviceOS" />
    <xs:enumeration value="Impressions" />
    <xs:enumeration value="Clicks" />
    <xs:enumeration value="Ctr" />
    <xs:enumeration value="AverageCpc" />
    <xs:enumeration value="Spend" />
    <xs:enumeration value="AveragePosition" />
    <xs:enumeration value="Conversions" />
    <xs:enumeration value="ConversionRate" />
    <xs:enumeration value="CostPerConversion" />
    <xs:enumeration value="Assists" />
    <xs:enumeration value="Revenue" />
    <xs:enumeration value="ReturnOnAdSpend" />
    <xs:enumeration value="CostPerAssist" />
    <xs:enumeration value="RevenuePerConversion" />
    <xs:enumeration value="RevenuePerAssist" />
    <xs:enumeration value="CustomerId" />
    <xs:enumeration value="CustomerName" />
    <xs:enumeration value="FeedUrl" />
    <xs:enumeration value="AllConversions" />
    <xs:enumeration value="AllRevenue" />
    <xs:enumeration value="AllConversionRate" />
    <xs:enumeration value="AllCostPerConversion" />
    <xs:enumeration value="AllReturnOnAdSpend" />
    <xs:enumeration value="AllRevenuePerConversion" />
    <xs:enumeration value="Goal" />
    <xs:enumeration value="GoalType" />
    <xs:enumeration value="AbsoluteTopImpressionRatePercent" />
    <xs:enumeration value="TopImpressionRatePercent" />
    <xs:enumeration value="AverageCpm" />
    <xs:enumeration value="ConversionsQualified" />
    <xs:enumeration value="AllConversionsQualified" />
    <xs:enumeration value="Description" />
  </xs:restriction>
</xs:simpleType>

DSASearchQueryPerformanceReportColumn 値セットには、AbsoluteTopImpressionRatePercentAccountIdAccountNameAccountNumberAccountStatusAdDistributionAdGroupIdAdGroupName、AdGroupStatusAdIdAdStatusAllConversionRate、AllConversionsQualifiedAllConversionsQualifiedAllCostPerConversions の値があります。AllReturnOnAdSpendAllRevenueAllRevenuePerConversionAssistsAverageCpcAverageCpmAveragePositionCampaignIdCampaignNameCampaignStatusCategoryListClicksConversionRateConversions、ConversionsQualifiedCostPerAssist、CostPerConversionCtrCustomerIdCustomerNameDescriptionDeviceOSDeviceTypeDynamicAdTargetDynamicAdTargetIdFeedUrlFinalUrlGoalGoalTypeHeadlineImpressionsLandingPageTitleLanguageNetworkReturnOnAdSpendRevenueRevenuePerAssistRevenuePerConversionSearchQuerySpendTimePeriodTopImpressionRatePercentTopVsOther

説明
AbsoluteTopImpressionRatePercent 広告がすべての結果の最初の位置にあった頻度 (インプレッション総数に対する割合)。

数値が大きいほど、広告が最適な広告の位置に頻繁に表示されていることを示します。

データが使用できない場合、この列の値は空です。 Hourly 集計も HourOfDay 集計もサポートされていません。 Hourly 集計または HourOfDay 集計にこの列を含める場合、サービスはエラーを返しません。この列に対して返されるパフォーマンス データは無視する必要があります。
AccountId アカウントの Microsoft Advertising 割り当て識別子。
AccountName アカウント名。
AccountNumber アカウントの Microsoft Advertising 割り当て番号。
AccountStatus アカウントの状態。
AdDistribution 広告を表示するネットワーク。 これは、Microsoft Advertising Network 全体、Microsoft サイト、選択トラフィック、またはパートナー トラフィックのみです (このネットワークの種類は 2024 年 7 月の時点で非推奨になっています)。
AdGroupId 広告グループの Microsoft Advertising 割り当て識別子。
AdGroupName 広告グループ名。
AdGroupStatus 広告グループの状態。
AdId 広告の Microsoft Advertising 割り当て識別子。
AdStatus 広告の状態。
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 で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。
AllReturnOnAdSpend 広告費用対効果 (ROAS)。

ROAS を計算するための数式は (収益/支出) です。

ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の ReturnOnAdSpend レポート列からデータが除外されます。 AllReturnOnAdSpend 列には、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 で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。
アシスト この広告から 1 回以上クリックしたのと同じアカウント内の他の広告からのコンバージョンの数。 広告は、コンバージョンがクレジットされた最後にクリックされた広告の前にクリックされた場合、コンバージョンを支援したと見なされます。 さらに、アシストに対応するクリックは、目標の変換期間内に行う必要があります。
AverageCpc クリックあたりの平均コスト (CPC)。 広告のすべてのクリックの合計コストをクリック数で割った値です。 これは、広告がクリックされるたびに実際に請求される平均金額です。 たとえば、300 回のクリックに対して合計 48.35 を支払った場合、平均クリック単価は 0.16 です。 平均クリック単価を計算するための数式は 、(費用/クリック数) です
AverageCpm 総広告コストをインプレッション数 (千単位)で割った値です<br/
ラテン語では、mille は 1000 を意味します。 また、1000 あたりの平均コスト (CPT) とも呼ばれることもあります。

これは、お客様の支出とインプレッション数に基づいて計算される標準的な広告業界のパフォーマンス メトリックです。

CPM ベースの広告予算作成の目標は、大規模なユーザーにブランドの認識を高めることです。 CPM は、ターゲットとするユーザーの種類に対して広告を取得するコストを示します。
AveragePosition Web ページ上の広告の平均位置。

この列は、2021 年 3 月 31 日の時点で非推奨です。 今後、パフォーマンス レポートは平均位置 "0" (ゼロ) を返します。 廃止日より前の期間の履歴平均位置データは、レポートの種類ごとに発行された データ保持期間 に従って引き続き使用できます。
CampaignId キャンペーンの Microsoft Advertising 割り当て識別子。
CampaignName キャンペーン名。
CampaignStatus キャンペーンの状態。
CategoryList Web サイトと一致Bingカテゴリの一覧。 カテゴリ リスト アイテムごとに最大 3 つのカテゴリ レベルを返すことができます。 リスト項目は JSON でエンコードされています。つまり、 categoryList という名前の配列で、1 つ以上の カテゴリ リスト アイテムが含まれます。 たとえば、ダウンロードしたレポート データのカテゴリは {"categoryList":[{"category":"US/CA/SFO"},{"category":"US/WA/SEA"},{"category":"US/TX"}} です
クリック クリックは支払い額です。 通常、クリックには、検索結果ページまたは検索ネットワーク上の Web サイトで広告をクリックしたユーザーが含まれます。 クリックは、他のソース (スパイダー、ロボット、テスト サーバーなど) から取得することもできます。 詳細については、「 Microsoft Advertising のクリック測定: 手法の説明」を参照してください。
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 顧客名。
説明 DynamicDescriptionEnabled が true に設定されている場合に Microsoft Advertising によって自動的に生成される動的検索広告テキスト。
DeviceOS DeviceType 列で報告されたデバイスのオペレーティング システム。 使用できる値には、 AndroidBlackberryiOSOtherUnknownWindows などがあります。 デバイスのオペレーティング システムを特定できない場合、またはターゲットにできるオペレーティング システムの 1 つでない場合、この列の値は [不明] になります。
DeviceType デバイス OS ターゲット入札のデバイス名属性。 広告を表示したデバイスの種類。 使用可能な値には、 コンピュータースマートフォンタブレット不明などがあります
DynamicAdTarget Web サイトと一致Bing動的な広告ターゲットまたは Web ページの条件。 たとえば、 URL に xyz が含まれているので、レポートで条件を返すことができます。
DynamicAdTargetId 動的広告ターゲットの Microsoft Advertising 割り当て識別子。広告グループの基準 ID としてキャンペーン管理および一括 API とも呼ばれます。
FeedUrl フィード URL は、"True" または "False" として表示されます。 "True" の場合、最終的な URL はキャンペーンに関連付けられているページ フィードから取得されます。 "False" の場合、最終的な URL はページ フィードから取得されませんでした。
FinalUrl デスクトップまたはノート PC から広告をクリックしたときにユーザーがアクセスする Web サイトのページの URL アドレス。 URL に動的テキスト置換パラメーター ({param1}など) が含まれている場合、レポートには置換前の URL が含まれます。
目標 目的のコンバージョンに設定する目標の名前。つまり、広告をクリックした後にユーザーが実行するアクションを意味します。
GoalType コンバージョン目標の種類。
使用可能な値には、 AppInstallDurationEventInStoreTransactionOfflineConversionPagesViewedPerVisitURL などがあります
見出し Microsoft Advertising によって動的に生成された動的検索広告の見出し。
インプレッション 検索結果ページに広告が表示された回数。 インプレッションがない場合、クリックやコンバージョンはありません。
LandingPageTitle 検索ユーザーが移動した Web ページのタイトル。
言語 広告が表示された発行元の言語。

使用可能な値については、 広告言語の [言語] 列を参照してください。 言語の表示名は、レポートで提供されます ( 英語など)。
Network Microsoft Advertising Network 全体が Microsoft サイトで構成され、トラフィックが選択され、パートナー トラフィックのみが選択されます (このネットワークの種類は 2024 年 7 月の時点で非推奨になりました)。 このデータを使用して、広告グループのネットワーク選択を最適に判断します。 使用可能な値には、AOL 検索、対象ユーザー、Microsoft サイト、トラフィック、コンテンツ、シンジケート検索パートナーの選択が含まれます。

: すべてのユーザーが 値 Microsoft サイトを使用してトラフィックを選択 できるわけではありません。 あなたができない場合は、心配しないでください - それはすぐに来ています!
ReturnOnAdSpend 広告費用対効果 (ROAS)。

ROAS を計算するための数式は (収益/支出) です。

ExcludeFromBidding プロパティが true に設定されているコンバージョン目標の ReturnOnAdSpend レポート列からデータが除外されます。 AllReturnOnAdSpend 列には、ExcludeFromBidding 設定に関係なく、すべてのコンバージョン目標のデータが含まれます。

Microsoft Advertising Universal Event Tracking で分析を使用するように設定されているアカウントで使用できます。 詳細については、 販売やその他のコンバージョンの追跡に関する ヘルプ トピックを参照してください。
収入 必要に応じて、コンバージョンの結果として広告主によって報告される収益。

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 に設定されている場合、この列を含めないようにすることができます。 詳細については、「 期間列」を参照してください。
TopImpressionRatePercent メインラインに広告が表示された回数の割合(検索結果の上に広告が表示される上位の配置)は、総インプレッション数を上回ります。

これは、広告の位置の変更がパフォーマンスに与える影響を示します。

データが使用できない場合、この列の値は空です。 Hourly 集計も HourOfDay 集計もサポートされていません。 Hourly 集計または HourOfDay 集計にこの列を含める場合、サービスはエラーを返しません。この列に対して返されるパフォーマンス データは無視する必要があります。
TopVsOther 広告インプレッションが上位の位置に表示されたか、他の場所に表示されたかを示します。 指定できる値には、AOL 検索 - Top、AOL search - Other、Audience network、Bing、Yahoo! search - Top、Bing、Yahoo! search - その他、シンジケート検索パートナー - トップ、シンジケート検索パートナー - その他、コンテンツ ネットワーク、不明。

注釈

必須列

レポートには、少なくとも次の列が含まれている必要があります。 一般的なルールとして、各レポートには少なくとも 1 つの属性列と少なくとも 1 つの非インプレッション共有パフォーマンス統計列が含まれている必要があります。 詳細については、「 レポート属性とパフォーマンス統計」を参照してください。

注:

TimePeriod 列は、Summary を除くすべての集計の種類に対して想定されます。 TimePeriod を含まない場合、選択した集計は無視され、Summary 集計は関係なく使用されることに注意してください。

Column
SearchQuery
TimePeriod

要件

サービス: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

使用ページ

DSASearchQueryPerformanceReportRequest