検索広告 360 の転送（非推奨）

コンソール

1. Google Cloud Console の [BigQuery] ページに移動します。

   [BigQuery] ページに移動

2. [転送] をクリックします。

3. [転送を作成] をクリックします。

4. [転送の作成] ページで、次の操作を行います。

   • [ソースタイプ] セクションの [ソース] で、[検索広告 360（旧称: Doubleclick Search）] を選択します。

     

   • [転送構成名] セクションの [表示名] に、転送名（例: My Transfer）を入力します。転送名には、後で修正が必要になった場合に簡単に識別できる任意の名前を使用できます。

     

   • [スケジュール オプション] セクションで:

     • [繰り返しの頻度] で、転送を実行する頻度のオプションを選択します。[日数] を選択した場合は、有効な時刻を UTC で入力します。

       • 時間
       • 日数
       • オンデマンド

     • 必要に応じて、[すぐに開始可能] を選択、または [設定した時間に開始] を選択して、開始日と実行時間を指定します。

   • [転送先の設定] セクションの [宛先データセット] で、データを保存するために作成したデータセットを選択します。

     

   • [データソースの詳細] セクションで、次の操作を行います。

     • [代理店 ID] に代理店 ID を入力します。
     • [Advertiser ID] に広告主 ID を入力します。
     • 削除されたエンティティと指標を転送対象として含めるには [include removed items] チェックボックスをオンにします。

     • （省略可）すべてのテーブルを読み込む場合は、[表のフィルタ] フィールドを空白のままにします。サポートされる一部のテーブルのデータだけをインポートするには、対象とするテーブル名のプレフィックスを空白文字で区切ってリストします（例: Account AccountDeviceStats AccountFloodlightAndDeviceStats）。サポートされているすべてのテーブル名については、検索広告 360 レポートの変換をご覧ください。

       

     • （省略可）検索広告 360 レポートの変換で事前定義されている列だけをインポートする場合は、[カスタム Floodlight 変数] フィールドを空白のままにします。
       検索広告 360 で作成したカスタム Floodlight 変数をインポートするには、対象とするフィールド名を JSON 形式で指定します。次に例を示します。

       • [{
           "cfv_name": "variable_name",
           "cfv_type": "metric or dimension",
           "campaign_manager_type": "number or string",
           "destination_table_name": "table_name",
           "bigquery_column_name": "custom_column_name"
         },{
           "cfv_name": "variable_name_2",
           "cfv_type": "metric or dimension",
           "campaign_manager_type": "number or string",
           "destination_table_name": ["table_name_2","table_name_3"],
           "bigquery_column_name": "custom_column_name_2"
         }]
         

       • JSON リストのすべての項目に、次の要素を含めます。
         • cfv_name は、キャンペーン マネージャーでカスタム Floodlight 変数を作成する際に指定した「わかりやすい」名前です。カスタムのディメンションと指標を設定するときにも、このわかりやすい名前が検索広告 360 の UI に表示されます。
         • cfv_type には、指標またはディメンションのいずれかを指定する必要があります。検索広告 360 の UI でカスタム Floodlight 変数を設定した方法に合わせてください。
         • campaign_manager_type には、数値または文字列のいずれかを指定する必要があります。検索広告 360 の UI でカスタム Floodlight 変数を設定した方法に合わせてください。
         • destination_table_name は、カスタム Floodlight 変数の追加先とする宛先テーブルの名前の接頭辞または名前の接頭辞のリストです。例: AccountDeviceStats、[AdDeviceStats,CampaignFloodtlightAndDeviceStats]。
         • bigquery_column_name は、BigQuery 宛先テーブルでこのカスタム Floodlight 変数に使用される列名です。列名は、BigQuery の列名形式の要件に従う必要があります。

       

   • （省略可）[通知オプション] セクションで、次の操作を行います。

     • 切り替えボタンをクリックしてメール通知を有効にします。このオプションを有効にすると、転送の実行が失敗した場合、転送管理者にメール通知が送信されます。
     • [Pub/Sub トピックを選択してください] で、トピック名を選択するか、[トピックを作成する] をクリックします。このオプションで、Pub/Sub の転送実行通知を構成します。

5. [保存] をクリックします。

bq

bq mk コマンドを入力して、転送作成フラグ --transfer_config を指定します。次のフラグも必要です。

• --data_source
• --target_dataset
• --display_name
• --params

--project_id フラグを指定して、特定のプロジェクトを指定することもできます。--project_id を指定しない場合は、デフォルトのプロジェクトが使用されます。

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source

ここで

• project_id は、プロジェクト ID です。
• dataset は、転送構成の抽出先データセットです。
• name は、転送構成の表示名です。転送名には、後で修正が必要になった場合に簡単に識別できる任意の名前を使用できます。

• parameters には、作成される転送構成のパラメータを JSON 形式で指定します。例: --params='{"param":"param_value"}'。検索広告 360 では、advertiser_id パラメータと agency_id パラメータを指定する必要があります。必要に応じて、次のパラメータを設定できます。

  • （省略可）サポートされている一部のテーブルのデータだけをインポートするには table_filter を設定し、対象とするテーブル名の接頭辞を空白文字で区切ってリストします（例: Account AccountDeviceStats AccountFloodlightAndDeviceStats）。サポートされているすべてのテーブル名については、検索広告 360 レポートの変換をご覧ください。
  • （省略可）検索広告 360 で作成したカスタム Floodlight 変数をインポートするには custom_floodlight_variables を設定し、対象とするフィールド名を JSON 形式で指定します。次に例を示します。
    • [{
        "cfv_name": "variable_name",
        "cfv_type": "metric or dimension",
        "campaign_manager_type": "number or string",
        "destination_table_name": "table_name",
        "bigquery_column_name": "custom_column_name"
      },{
        "cfv_name": "variable_name_2",
        "cfv_type": "metric or dimension",
        "campaign_manager_type": "number or string",
        "destination_table_name": "table_name_2",
        "bigquery_column_name": "custom_column_name_2"
      }]
      

    • JSON リストのすべての項目に、次の要素を含めます。
      • cfv_name は、キャンペーン マネージャーでカスタム Floodlight 変数を作成する際に指定した「わかりやすい」名前です。カスタムのディメンションと指標を設定するときにも、このわかりやすい名前が検索広告 360 の UI に表示されます。
      • cfv_type には、指標またはディメンションのいずれかを指定する必要があります。検索広告 360 の UI でカスタム Floodlight 変数を設定した方法に合わせてください。
      • campaign_manager_type には、数値または文字列のいずれかを指定する必要があります。検索広告 360 の UI でカスタム Floodlight 変数を設定した方法に合わせてください。
      • destination_table_name は、カスタム Floodlight 変数の追加先とする宛先テーブル名の接頭辞です例: AccountDeviceStats
      • bigquery_column_name は、BigQuery 宛先テーブルでこのカスタム Floodlight 変数に使用される列名です。列名は、BigQuery の列名形式の要件に従う必要があります。
  • （省略可）削除されたエンティティと指標を転送対象として含めるには、include_removed_entities を設定します。

• data_source は、データソース（doubleclick_search）です。

たとえば、次のコマンドは、広告主 ID 123、代理店 ID 123、ターゲット データセット mydataset を使用して、My Transfer という名前の検索広告の転送を作成します。この転送はデフォルトのプロジェクトで作成されます。

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"agency_id":"123", "advertiser_id":"123","include_removed_entities":"true"}' \
--data_source=doubleclick_search

コマンドの初回実行時に、次のようなメッセージが表示されます。

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

メッセージの指示に従って、認証コードをコマンドラインに貼り付けます。

API

projects.locations.transferConfigs.create メソッドを使用して、TransferConfig リソースのインスタンスを指定します。