カスタム Floodlight 変数のデータをアップロードする

デフォルトでは、コンバージョンには限られた量の説明データが含まれます。 コンバージョンの発生元、および必要に応じて金銭的価値。もし コンバージョンに関する追加データ(商品の購入先の国など)を収集する 配送状況や商品 ID だけでなく、電話のかけ時間なども考慮して、カスタム Floodlight 変数を使用して 検索広告 360 にアップロードします

データをアップロードした後、次のことができます。

  • 検索広告 360 でレポート列を作成してデータを表示するか、この列を使用して Floodlight 列をフィルタリングする。

  • そのデータを数式列で使用する。

  • そのデータを使用して、レポートを分割およびグループ化します。

  • Search Ads 360 API を使用して データを含むレポートをダウンロードする

使用方法については、こちらをご覧ください。 アップロードします。

カスタム Floodlight 変数を設定する

最初にカスタム Floodlight 変数を Floodlight を キャンペーン マネージャー。検索広告 360 のカスタマー サービス担当者が カスタム 変数を使用するをご覧ください。これらのステップを完了したら、 コンバージョンの追加や変更を行う際に、変数の適切な値を設定する必要があります。

変数名と型

各変数には、特定の値に対して一意のわかりやすい名前が割り当てられます。 次のデータタイプのいずれかが必要です:

  • 指標: 検索広告 360 がコンバージョン レポートで集計する数値データ。対象 たとえば、指標変数を使用して全体的な送料を追跡したり、 購入されたアイテムの数。

  • ディメンション: テーブル内のデータのフィルタリングに使用できる数値またはテキストデータ。 レポートたとえば、ディメンション変数で店舗名や数値の商品 ID をトラッキングできます。 Floodlight レポートで使用 特定の店舗または特定の店舗のデータのみを含む列 説明します。

カスタムデータのアップロード

指標のカスタム Floodlight 変数のデータをアップロードするには、 次のフィールドを Conversion.insert() または Conversion.update() request:

   'customMetric': [
      {
        'name': 'friendly-name',
        'value': Number
      },
     ]

ディメンションのカスタム Floodlight 変数のデータをアップロードするには、 次のフィールドを Conversion.insert() または Conversion.update() request:

   'customDimension': [
      {
        'name': 'friendly-name',
        'value': String
      },
     ]
をご覧ください。 <ph type="x-smartling-placeholder">
</ph>

たとえば、広告主が次のカスタム Floodlight 変数を設定したとします。 検索広告 360:

  • 売上(指標)
  • 送料(指標)
  • product_type(ディメンション)
  • product_id(ディメンション)

お客様が電話で購入を完了した場合、次のように対応できます。 Conversion.insert() コンバージョンをアップロードし、カスタム指標のデータを含めるようリクエストします。

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json

{
 'kind': 'doubleclicksearch#conversionList',
 'conversion' : [{
   'agencyId': '12300000000000456', // Replace with your ID
   'advertiserId': '78900000000000123', // Replace with your ID
   'engineAccountId': '101100000000000123', // Replace with your ID
   'campaignId': '13400000003156701', // Replace with your ID
   'adGroupId': '58700000128508001', // Replace with your ID
   'criterionId': '43700001095692142', // Replace with your ID
   'adId': '0',
   'conversionId': 'test_20140121_01',
   'state': 'ACTIVE',
   'type': 'TRANSACTION',
   'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros
   'currencyCode': 'USD',
   'segmentationType': 'FLOODLIGHT',
   'segmentationId': '25700000001472562', // Replace with your ID
   'conversionTimestamp': '1390073000011',
   'floodlightOrderId': 'test',
   'customMetric': [
    {
      'name': 'sales',
      'value': 2.0
    },
    {
      'name': 'shipping',
      'value': 3.0
    }
   ],
   'customDimension': [
    {
      'name': 'product_type',
      'value': 'shoes'
    },
    {
      'name': 'product_id',
      'value': 'shoe 2'
    }
   ]
 }]
}

検索広告 360 のレスポンスを処理する

他の Conversion.insert() と同様 Conversion.update() リクエストの場合、 リクエストが成功すると、レスポンスには検索広告 360 の内部表現全体が含まれます。 手動で追加することもできます

リクエストの検証またはアップロードに失敗した場合、レスポンスにはエラー メッセージが含まれます。 これらのエラー メッセージの詳細については、Chronicle の 挿入リクエストに対する検索広告 360 のレスポンス