商品ターゲットのパフォーマンス指標と構成属性Google 広告の PLA キャンペーンでは、商品ターゲットを使用して、Google Merchant Center アカウントのどの商品を、Google の関連する検索で商品リスティング（ショッピング広告）をトリガーするかを指定します。商品ターゲットと PLA キャンペーンが Google 広告ショッピング キャンペーンに置き換えられました。DS から、ショッピング キャンペーンにアップグレードする前に、PLA キャンペーンに起因する過去の指標のレポートをリクエストできます。
このレポートは、非同期リクエスト（Reports.request() メソッド経由）でのみ返すことができます。
抜粋をリクエスト
通常の Reports.request() リクエストの本文を送信しますが、"reportType": "productTarget" を指定します。
{
...
"reportType": "productTarget",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName を指定します。headerText、startDate、endDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
|---|---|---|---|---|
status |
商品ターゲットのステータス: Active、Paused、または Removed。キャンペーン、広告グループ、商品ターゲット、広告には、それぞれ固有のステータスがあります。ステータスをご覧ください。 |
属性 | Status |
対応 |
engineStatus |
外部エンジン アカウントにおける商品ターゲットの追加ステータス。外部アカウントの種類に応じて、review、campaign paused などのステータスが表示されます。 |
属性 | String |
対応 |
creationTimestamp |
商品ターゲットの作成時点のタイムスタンプ（ISO 8601 形式）。 | 属性 | Timestamp |
対応 |
lastModifiedTimestamp |
商品の最新の変更のタイムスタンプ（ISO 8601 形式）。 | 属性 | Timestamp |
対応 |
agency |
代理店名。 | 属性 | String |
対応 |
agencyId |
DS 代理店 ID | 属性 | ID |
対応 |
advertiser |
広告主名。 | 属性 | String |
対応 |
advertiserId |
DS 広告主 ID | 属性 | ID |
対応 |
account |
エンジン アカウント名。 | 属性 | String |
対応 |
accountId |
DS エンジン アカウント ID。 | 属性 | ID |
対応 |
accountEngineId |
外部エンジン アカウントの ID。 | 属性 | String |
対応 |
accountType |
エンジン アカウントの種類: Google AdWords、Bing Ads、Yahoo Japan Listing Ads、Yahoo Search Marketing、Yahoo Gemini、Baidu、または Comparison Shopping。 |
属性 | Engine type |
対応 |
campaign |
キャンペーン名。 | 属性 | String |
対応 |
campaignId |
DS キャンペーン ID。 | 属性 | ID |
対応 |
campaignStatus |
このアイテムを含むキャンペーンのステータス。 | 属性 | Status |
対応 |
adGroup |
広告グループ名: | 属性 | String |
対応 |
adGroupId |
DS 広告グループ ID。 | 属性 | ID |
対応 |
adGroupStatus |
このアイテムが含まれる広告グループのステータス。 | 属性 | Status |
対応 |
productTargetId |
DS 商品ターゲットの ID。 | 属性 | ID |
対応 |
productTargetFilter |
この商品ターゲットが設定されている Google Merchant Center アカウントの商品をフィルタします。商品 ID やブランドなどの属性を使用して一致条件を指定できます。 | 属性 | String |
× |
productTargetEngineId |
外部エンジン アカウントの商品ターゲットの ID。 | 属性 | ID |
対応 |
productTargetLandingPage |
ユーザーがショッピング広告をクリックした後にアクセスする最終ページ URL を示す値。詳しくは、ショッピング広告のランディング ページをご覧ください。 | 属性 | String |
対応 |
productTargetClickserverUrl |
DS がアクティビティのトラッキングに使用する URL。ショッピング広告をクリックしたユーザーは、まずクリックサーブ URL にアクセスし、次に最終的なランディング ページにリダイレクトされます。詳しくは、ショッピング広告のランディング ページをご覧ください。 | 属性 | String |
対応 |
productTargetLabels |
この商品ターゲットに直接割り当てられたラベルの名前。継承されたラベルは含まれません。 | 属性 | String list |
対応 |
productTargetMaxCpc |
広告グループの上限 CPC をオーバーライドし、この特定の商品の商品広告をクリックした場合に支払う上限額を設定します。この項目が空の場合、商品ターゲットには広告グループの上限 CPC が使用されます。 | 属性 | Money |
対応 |
effectiveProductTargetMaxCpc |
この商品ターゲットで有効な上限クリック単価です。この値は、広告グループの上限 CPC と同じ値になります。また、商品ターゲットが広告グループの設定を上書きしている場合は、商品ターゲット自体の上限 CPC と同じ値になります。 | 属性 | Money |
対応 |
productTargetMaxBid |
この商品グループが DS 入札戦略で管理されている場合、入札戦略がこの上限を超えることはありません。詳しくは、商品ターゲットに入札戦略を適用するをご覧ください。 | 属性 | Money |
対応 |
productTargetMinBid |
この商品ターゲットが DS 入札戦略で管理されている場合、この入札単価が入札戦略でこの制限を下回ることはありません。詳しくは、商品ターゲットに入札戦略を適用するをご覧ください。 | 属性 | Money |
対応 |
effectiveBidStrategyId |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の DS ID。 | 属性 | ID |
対応 |
effectiveBidStrategy |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の名前。 | 属性 | String |
対応 |
bidStrategyInherited |
このエンティティの入札戦略が継承されているかどうかを示します。 | 属性 | Boolean |
対応 |
effectiveLabels |
この商品ターゲットに継承された、または直接割り当てられたすべてのラベルの名前。 | 属性 | String list |
対応 |
dfaActions |
キャンペーン マネージャー アクションの合計数。 | 指標 | Integer |
対応 |
dfaRevenue |
キャンペーン マネージャーのトランザクションで発生した収益の集計。 | 指標 | Money |
対応 |
dfaTransactions |
キャンペーン マネージャー トランザクションの合計数。 | 指標 | Integer |
対応 |
dfaWeightedActions |
キャンペーン マネージャー アクションの加重合計。 | 指標 | Number |
対応 |
dfaActionsCrossEnv |
環境間のキャンペーン マネージャー アクションの合計数。 | 指標 | Number |
対応 |
dfaRevenueCrossEnv |
環境間のキャンペーン マネージャー トランザクションによって発生した収益の集計。 | 指標 | Money |
対応 |
dfaTransactionsCrossEnv |
環境間のキャンペーン マネージャー トランザクションの合計数。 | 指標 | Number |
対応 |
dfaWeightedActionsCrossEnv |
環境間のキャンペーン マネージャー アクションの加重合計。 | 指標 | Number |
対応 |
avgCpc |
平均クリック単価。 | 指標 | Money |
対応 |
avgCpm |
平均インプレッション単価。 | 指標 | Money |
対応 |
avgPos |
平均掲載順位。 | 指標 | Number |
対応 |
clicks |
総クリック数。 | 指標 | Integer |
対応 |
cost |
エンジン アカウントに対する合計費用 | 指標 | Money |
対応 |
ctr |
平均クリック率。 | 指標 | Number |
対応 |
impr |
インプレッションの合計数。 | 指標 | Integer |
対応 |
adWordsConversions |
広告主様が Google 広告コンバージョン列に表示するよう設定したデータGoogle 広告のコンバージョン アクションを作成する際、広告主は [コンバージョン] 列でコンバージョンをカウントするかどうかを選択できます。 | 指標 | Number |
対応 |
adWordsConversionValue |
Google 広告コンバージョンの合計値。 | 指標 | Number |
対応 |
adWordsViewThroughConversions |
Google 広告のビュースルー コンバージョンの合計数。 | 指標 | Integer |
対応 |
visits |
DS の訪問の総数。 | 指標 | Integer |
対応 |
date |
レポートを日別に分割します。各行とその集計指標は、1 行に 1 つずつ複数の行に分割されます。この列では各行の日付が返されます。 | 分割 | Date |
対応 |
monthStart |
レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列では、各行の最初の月の日が返されます。 | 分割 | Date |
対応 |
monthEnd |
レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列では、各行の月の最終日を返します。 | 分割 | Date |
対応 |
quarterStart |
レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに 1 行ずつ、複数ある行に分割されます。この列では各行の四半期の最初の日が返されます。 | 分割 | Date |
対応 |
quarterEnd |
レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに 1 行ずつ、複数ある行に分割されます。この列では、各行の四半期の最終日が返されます。 | 分割 | Date |
対応 |
weekStart |
レポートを週（日曜日～土曜日）で分割します。各行とその集計指標は、週ごとに 1 行ずつ、複数行に分割されます。この列では、各行の最初の日（日曜日）が返されます。 | 分割 | Date |
対応 |
weekEnd |
レポートを週（日曜日～土曜日）で分割します。各行とその集計指標は、週ごとに 1 行ずつ、複数行に分割されます。この列では、各行の最終日（土曜日）が返されます。 | 分割 | Date |
対応 |
yearStart |
レポートを年別に分割（各行とその集計指標は複数年に分割）この列では各年の初日が返されます。 | 分割 | Date |
対応 |
yearEnd |
レポートを年別に分割（各行とその集計指標は複数年に分割）この列では、各年の年の最終日を返します。 | 分割 | Date |
対応 |
deviceSegment |
レポートをデバイス別に分割できます。各行とその集計指標は、デバイス セグメントごとに 1 行ずつ、複数の行に分割されます。この列では、各行のデバイス セグメントが返されます。 | 分割 | Device segment |
対応 |
floodlightGroup |
Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の Floodlight グループ名が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | String |
対応 |
floodlightGroupId |
Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の DS Floodlight グループ ID が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | ID |
対応 |
floodlightGroupTag |
Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の Floodlight グループタグが返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | String |
対応 |
floodlightActivity |
Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では各行の Floodlight アクティビティ名が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | String |
対応 |
floodlightActivityId |
Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では、各行の DS Floodlight アクティビティ ID が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | ID |
対応 |
floodlightActivityTag |
Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では各行の Floodlight アクティビティ タグが返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 | 分割 | String |
対応 |