商品ターゲットのパフォーマンス指標と構成属性。商品ターゲットは、Google 広告の PLA キャンペーンで使用され、Google Merchant Center アカウントのどの商品が Google の関連検索に対して商品リスティング広告(ショッピング広告)を表示するかを指定していました。商品ターゲットと PLA キャンペーンは、Google 広告のショッピング キャンペーンに置き換えられました。ショッピング キャンペーンにアップグレードする前の PLA キャンペーンに関連付けられていた過去の指標については、引き続き DS からレポートをリクエストできます。
このレポートを返すことができるのは、非同期リクエスト( 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 |
広告グループの上限クリック単価を上書きし、この特定の商品ターゲットの商品広告がクリックされた場合に支払う上限額を設定します。このフィールドを空欄にすると、広告グループの上限クリック単価が使用されます。 | 属性 | Money |
○ |
effectiveProductTargetMaxCpc |
この商品ターゲットで有効な上限クリック単価(上限クリック単価)です。この値は、広告グループの上限クリック単価と同じ値になります。また、商品グループの設定をオーバーライドする商品グループの場合は、商品グループの上限クリック単価と同じ値になります。 | 属性 | 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 |
レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の初日を返します。 | 分割 | Date |
○ |
monthEnd |
レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の最終日を返します。 | 分割 | Date |
○ |
quarterStart |
四半期ごとにレポートを分割します。各行とその集計指標は複数の行(四半期ごとに 1 行)に分割されます。この列では、各行の四半期の初日を返します。 | 分割 | Date |
○ |
quarterEnd |
四半期ごとにレポートを分割します。各行とその集計指標は複数の行(四半期ごとに 1 行)に分割されます。この列では、各行の四半期の最終日を返します。 | 分割 | Date |
○ |
weekStart |
レポートを週単位(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の初日(日曜日)が返されます。 | 分割 | Date |
○ |
weekEnd |
レポートを週単位(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の最終日(土曜日)が返されます。 | 分割 | Date |
○ |
yearStart |
レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年初日を返します。 | 分割 | Date |
○ |
yearEnd |
レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年の最終日を返します。 | 分割 | 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 |
○ |