カスタム Floodlight 変数に関するレポートを作成する

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では、柔軟性の向上により、カスタム レポートを作成し、レポート作成のアプリケーションやプロセスにデータを統合することができます。詳しくは、新しい Search Ads 360 Reporting API への移行と使用についての記事をご覧ください。

広告主は、カスタム Floodlight 変数を使用して、ユーザーが購入した映画のジャンル、商品を購入したショップの名前、送料など、ビジネスニーズに固有のコンバージョン データをレポートします。データは、広告主のサイトの Floodlight タグまたは Search Ads 360 API によってアップロードできます。また、API を使用して、データを含むレポートをダウンロードできます。

詳しくは、検索広告 360 のカスタム Floodlight 変数に関する記事をご覧ください。

指標またはディメンション

カスタム Floodlight 変数の設定の一環として、広告主は検索広告 360 の管理画面で、各変数をレポートで使用する方法を指定します。

  • 指標: ほとんどのレポートでは、検索広告 360 では指標として定義されている変数の値が集計されます。
    たとえば、広告主がカスタム Floodlight 変数を使用して送料をトラッキングしているとします。 検索広告 360 ユーザーがこの変数を指標として定義していて、その変数を adGroup レポートに含めると、レポートの範囲内で各広告グループに関連付けられた送料の合計が表示されます。

    conversion レポートでは、検索広告 360 の集計データではなく、個々のコンバージョンに関する元データが表示されます。

    注: カスタム指標は Floodlight レポートの列にも表示されます。検索広告 360 管理画面で、Floodlight レポートの列にカスタム指標を追加してから、Floodlight レポートの列をレポートに追加できます。また、他のタイプの保存済みの列を含める場合と同様に、これらの Floodlight 列をレポート リクエストに含めることもできます。

  • ディメンション: ディメンションとして定義された変数は、ほとんどのレポートの分割に使用できます。
    たとえば、広告主がカスタム Floodlight 変数を使用して店舗名をトラッキングしているとします。検索広告 360 ユーザーがこの変数をディメンションとして定義すると、この変数を使用して adGroup レポートを分割し、広告グループ内の広告に起因する購入数を店舗ごとに確認できます。

    conversion レポートでは、検索広告 360 の集計データではなく、個々のコンバージョンに関する元データが表示されます。そのため、conversion レポートにカスタム ディメンションを追加すると、ディメンションの値が表示されます。前の段落の例の続きとして、conversion レポートを storeName カスタム ディメンションで分割すると、特定の購入が行われた店舗の名前が表示されます。

    注: 検索広告 360 ユーザーが Floodlight レポート列を定義する際、カスタム ディメンションをフィルタとして使用して、特定のディメンション値を記録したコンバージョンのみをレポートに記録することができます。

レポート リクエストにカスタム指標を含める

レポート リクエストにカスタム指標を含めるには:

次に、レポート リクエストに以下を含めます。

  • customMetricName: カスタム指標のわかりやすい名前を指定します。
    カスタム指標の名前では大文字と小文字が区別されます。

  • platformSource: 常に Floodlight に設定します。

たとえば、広告主が「shippingCost」という名前のカスタム指標を作成した場合は、レポートに shippingCost customMetricName を追加します。

{
   "reportScope": {
     "agencyId": "12300000000000456", // Replace with your ID
     "advertiserId": "21700000000011523", // Replace with your ID
   },
   ...
   "columns": [
     {
        "customMetricName": "shippingCost",
        "platformSource": "floodlight"
     }
   ],
   ...
}
   

カスタム ディメンションでレポートを分割する

カスタム ディメンションでレポートを分割するには:

  • キャンペーン マネージャーでカスタム Floodlight 変数を作成したときに指定したわかりやすい名前が必要です。このわかりやすい名前は、カスタム ディメンションとカスタム指標を設定する際に検索広告 360 の管理画面にも表示されます。

  • レポートの対象は、特定の広告主またはそれより下位である必要があります。

  • 各レポート リクエストで指定できるカスタム ディメンションは 1 つのみです。ただし、 カスタム以外のセグメントがリクエストに含まれる場合があります。
    たとえば、storeName カスタム ディメンションに加えて、四半期とデバイスの非カスタム セグメント別にレポートを分割できます。ただし、セグメントが追加されるたびに行数が指数関数的に増加することに留意してください。

次に、レポート リクエストに以下を含めます。

  • customDimensionName: カスタム ディメンションのわかりやすい名前を指定します。
    カスタム ディメンションの名前では大文字と小文字が区別されます。

  • platformSource: 常に Floodlight に設定します。

たとえば、広告主様が「storeNamestoreName」という名前のカスタム ディメンションを作成した場合は、レポートに storeName customDimensionName を追加すると、店舗名で指標を分割できます。

{
   "reportScope": {
     "agencyId": "20700000000000123", // Replace with your IDs
     "advertiserId": "2170000012345" // Replace with your IDs
   },
   "reportType": "campaign",

   "columns": [
     { "columnName": "campaignId" },
     { "columnName": "clicks" },
     { "columnName": "cost" },
     { "columnName": "dfaRevenue"},

     {
        "customDimensionName": "storeName",
        "platformSource": "floodlight"
     }
   ],
   ...
}