{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Equativ Batch File Export Integration","description":"Google Cloud Storage Export V2 コネクタと Equativ のバッチファイル同期バケットを使って、Treasure AI からセグメントタクソノミーとユーザープロファイルデータを Equativ に送信します。","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"equativ-batch-file-export-integration","__idx":0},"children":["Equativ Batch File Export Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI から ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.equativ.com/"},"children":["Equativ"]}," へ、Equativ が提供する Google Cloud Storage (GCS) バケットに CSV ファイルをエクスポートすることで、セグメントタクソノミーおよびユーザープロファイルデータを送信できます。この連携では、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/google-cloud-storage-export-v2-integration"},"children":["Google Cloud Storage Export V2"]}," コネクタと Equativ のバッチファイル同期サービスを使用します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ファイルが指定バケットに到着すると Equativ が自動的に取り込むため、Treasure AI の親セグメントや Audience Studio のアクティベーションからセグメント定義とプロファイル所属を制御できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ 側の仕様については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.equativ.com/sync-segments-and-profiles-batch-file"},"children":["Sync Segments and Profiles - Batch File"]}," を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://toolbelt.treasuredata.com/"},"children":["TD Toolbelt"]}," を含む Treasure AI の基本知識。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["バッチファイル同期が有効化された Equativ アカウント。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Equativ 担当者から提供される GCS サービスアカウント認証情報 (JSON キー) と対象バケット名。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Equativ が要求するカラムを出力するクエリ、または Audience Studio セグメント。"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"バケットの選択"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ はタクソノミーとプロファイルそれぞれに別のバケットを用意しており、さらに環境 (sandbox/production) およびリージョン (US, EU, APAC) ごとにも異なります。接続を構成する前に、Equativ から正確なバケット名を確認してください。例:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["タクソノミー: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxonomy_importer_audience_prod"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxonomy_importer_audience_sandbox"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["プロファイル: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_importer_audience_us_prod"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_importer_audience_eu_prod"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_importer_audience_apac_prod"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"treasure-data-integration-の静的-ip-アドレス","__idx":2},"children":["Treasure Data Integration の静的 IP アドレス"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/endpoints/ip-addresses-integrations-result-workers"},"children":["IP Addresses for Integrations"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ファイルフォーマット概要","__idx":3},"children":["ファイルフォーマット概要"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ では、以下の特性を持つ CSV ファイルが必要です:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"プロパティ"},"children":["プロパティ "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"80%","data-label":"値"},"children":["値 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["フォーマット"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CSV"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["区切り文字"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["パイプ文字 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["エンコーディング"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UTF-8"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["大文字小文字の区別"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["カラム値は大文字小文字を区別します"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ヘッダ行"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["任意。含める場合は、Equativ のカラム名と完全一致する必要があります (例: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserID"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToAdd"]},")。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ファイル種別の判定"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["アップロード先のバケットで決まります。タクソノミーファイルはタクソノミー用バケット、プロファイルファイルはリージョンに応じたプロファイル用バケットへアップロードしてください。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"タクソノミーファイルのカラム","__idx":4},"children":["タクソノミーファイルのカラム"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["タクソノミーファイルを使って、Equativ にセグメント定義を登録または更新します。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"カラム"},"children":["カラム "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"12%","data-label":"必須"},"children":["必須 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"13%","data-label":"型"},"children":["型 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"55%","data-label":"説明"},"children":["説明 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (200 文字以内)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["タクソノミー内で一意のセグメント識別子。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (200 文字以内)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ユーザーが識別しやすいセグメント名。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsActive"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["セグメントを有効化する場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"、無効化する場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},"。デフォルトは ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsSelectable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equativ UI で選択可能にする場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"。デフォルトは ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["float"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["セグメントに適用する CPM 価格。デフォルトは ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TTL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer (分単位)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["セグメントの有効期間 (分)。デフォルトは ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["43200"]}," (30 日)。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ParentSegmentId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["任意"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["階層的タクソノミーでの親セグメント。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["任意"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (255 文字以内)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["セグメントの任意の説明。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"プロファイルファイルのカラム","__idx":5},"children":["プロファイルファイルのカラム"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プロファイルファイルを使って、個々のユーザーのセグメント所属を追加・削除・置き換えします。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"カラム"},"children":["カラム "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"12%","data-label":"必須"},"children":["必須 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"68%","data-label":"説明"},"children":["説明 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ユーザー識別子。Equativ では Cookie ID、モバイル広告 ID (MAID)、パブリッシャー提供 ID、代替 ID、IP アドレス、郵便番号がサポートされています。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToAdd"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["条件付き"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["このユーザーに追加する ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentId"]}," のカンマ区切りリスト。例: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123,456"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToRemove"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["条件付き"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["このユーザーから削除する ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentId"]}," のカンマ区切りリスト。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToSet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["条件付き"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ユーザーの現在の所属を置き換える ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentId"]}," のカンマ区切りリスト。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"プロファイルレコードの保持期間"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ はプロファイルレコードを 14 日間保持します。この 14 日間のプロファイルレコード保持期間は、タクソノミーファイルのセグメントごとの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TTL"]}," カラムとは別のものです。所属を最新状態に保つため、この保持期間より短い間隔でプロファイルエクスポートを実行してください。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"treasure-コンソールで接続を作成する","__idx":6},"children":["Treasure コンソールで接続を作成する"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"新しい認証を作成する","__idx":7},"children":["新しい認証を作成する"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure コンソール"]}," を開きます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations Hub"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catalog"]}," に移動します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Google Cloud Storage V2"]}," を検索して選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Authentication"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["認証方式として ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON Keyfile"]}," を選択し、Equativ から提供されたサービスアカウント JSON キーを貼り付けます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["接続名を入力します (例: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equativ-batch-file"]},")。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]}," を選択します。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Workload Identity Federation を含む GCS の認証オプションの詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/google-cloud-storage-export-v2-integration#use-the-td-console-to-create-your-connection"},"children":["Google Cloud Storage Export V2 Integration"]}," のドキュメントを参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ソースクエリを作成する","__idx":8},"children":["ソースクエリを作成する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["クエリは、Equativ が想定するカラムと値のフォーマットを正確に出力する必要があります。区切り文字としてパイプ (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]},") を使用し、必要なカラムではカンマ区切りリストを生成してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"タクソノミーファイル用クエリの例","__idx":9},"children":["タクソノミーファイル用クエリの例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT\n  segment_id      AS \"SegmentId\",\n  segment_name    AS \"Name\",\n  CAST(is_active     AS INTEGER) AS \"IsActive\",\n  CAST(is_selectable AS INTEGER) AS \"IsSelectable\",\n  CAST(price AS DOUBLE)          AS \"Price\",\n  CAST(ttl_minutes   AS INTEGER) AS \"TTL\",\n  parent_segment_id              AS \"ParentSegmentId\",\n  description                    AS \"Description\"\nFROM equativ_taxonomy\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"プロファイルファイル用クエリの例","__idx":10},"children":["プロファイルファイル用クエリの例"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下の例では、セグメント ID の配列を Equativ が要求するカンマ区切り形式に変換しています。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT\n  user_id AS \"UserID\",\n  ARRAY_JOIN(segments_to_add,    ',') AS \"SegmentToAdd\",\n  ARRAY_JOIN(segments_to_remove, ',') AS \"SegmentToRemove\",\n  ARRAY_JOIN(segments_to_set,    ',') AS \"SegmentToSet\"\nFROM equativ_profile_updates\nWHERE TD_INTERVAL(time, '-1d/now')\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"パイプ区切りを使用する"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["エクスポートを構成する際は、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delimiter"]}," に ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]}," を設定してください。これにより、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToAdd"]}," などのカラム内に含まれるカンマ区切りのセグメントリストが、別カラムに分割されることを防げます。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"エクスポートを定義する","__idx":11},"children":["エクスポートを定義する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Data Workbench クエリの結果、または Audience Studio のアクティベーションのいずれからもエクスポートできます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"オプション-1-クエリ結果をエクスポートする","__idx":12},"children":["オプション 1: クエリ結果をエクスポートする"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/integration-hub/batch/export/creating-a-destination-integration"},"children":["Creating a Destination Integration"]}," の手順を完了します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Workbench"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Queries"]}," に移動し、Equativ 向けフォーマットの結果セットを生成するクエリを開きます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["クエリを実行して出力を検証します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Export Results"]}," を選択し、作成した Equativ 向け Google Cloud Storage 認証を選びます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["後述の Integration Parameters を構成します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]}," を選択してクエリを実行します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"オプション-2-audience-studio-からアクティベートする","__idx":13},"children":["オプション 2: Audience Studio からアクティベートする"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"audience-studio-で-segment-をアクティベートする","__idx":14},"children":["Audience Studio で Segment をアクティベートする"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audience Studio"]}," に移動します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["parent segment を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ターゲット segment を開き、右クリックして、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Activation"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]}," パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output Mapping"]}," パネルで activation 出力をカスタマイズします。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Attribute Columns",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Export All Columns"]}," を選択すると、変更を加えずにすべての列をエクスポートできます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add Columns"]}," を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add Columns"]}," を選択し続けて、activation 出力用の新しい列を追加します。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["String Builder",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add string"]}," を選択して、エクスポート用の文字列を作成します。次の値から選択します:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["String: 任意の値を選択します。テキストを使用してカスタム値を作成します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timestamp: エクスポートの日時。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segment Id: segment ID 番号。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segment Name: segment 名。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audience Id: parent segment 番号。"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schedule"]}," を設定します。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スケジュールを定義する値を選択し、オプションでメール通知を含めます。"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," を選択します。"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["batch journey の activation を作成する必要がある場合は、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation"},"children":["Creating a Batch Journey Activation"]}," を参照してください。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アクティベーションを構成する際は、Equativ 向け GCS 認証を指定し、次のセクションに記載した Integration Parameters と同じ値を使用してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integration-parameters","__idx":15},"children":["Integration Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"22%","data-label":"パラメータ"},"children":["パラメータ "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"12%","data-label":"必須"},"children":["必須 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"33%","data-label":"推奨値"},"children":["推奨値 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"33%","data-label":"説明"},"children":["説明 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bucket"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ファイル種別、環境、リージョンに応じて Equativ から提供されるバケット。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["例: タクソノミー本番アップロード用は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxonomy_importer_audience_prod"]},"、US 本番プロファイルアップロード用は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_importer_audience_us_prod"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File Path"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<customer_folder>/taxonomy_${session_unixtime}.csv"]}," または ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<customer_folder>/profile_${session_unixtime}.csv"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ファイル名を含むオブジェクトパス。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<customer_folder>"]}," は Equativ から割り当てられたフォルダ名に置き換えてください。各バッチが独立して処理されるよう、実行ごとに一意のファイル名 (例: セッションタイムスタンプ) を使用してください。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Format"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csv"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equativ では CSV が必須です。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delimiter"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equativ が要求するパイプ文字。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header line?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必須"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equativ はヘッダの有無どちらでも受け付けます。ヘッダを含めると運用上のデバッグが容易になります。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["End-of-line character"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["任意"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LF"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LF"]}," と ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CRLF"]}," のどちらでも受け付けます。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Encoders / Compression"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["任意"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equativ ではバッチ取り込みに圧縮は不要です。"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GCS V2 エクスポートパラメータの全リストについては、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/google-cloud-storage-export-v2-integration#integration-parameters-for-google-cloud-storage"},"children":["Integration Parameters for Google Cloud Storage"]}," を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"エクスポートをスケジュールする","__idx":16},"children":["エクスポートをスケジュールする"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ はバケットにファイルが到着すると即座に処理します。タクソノミーとプロファイルのデータを最新に保つには:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["タクソノミーエクスポート"]}," はセグメント定義が変更されたタイミング (通常は日次またはオンデマンド) でスケジュールします。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["プロファイルエクスポート"]}," は 14 日間のプロファイルレコード保持期間より短い周期でスケジュールします。日次の差分エクスポートが一般的なパターンです。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["エクスポートのスケジュール方法は次のとおりです:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audience Studio のアクティベーションで ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schedule"]}," を設定する"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スケジュールクエリを駆動する ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/treasure-workflow-quick-start-using-td-toolbelt-in-a-cli"},"children":["Treasure ワークフロー"]}," の ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td>"]}," タスクを使用する"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"エクスポートを検証する","__idx":17},"children":["エクスポートを検証する"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["想定した ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["File Path"]}," で、Equativ 管理下のバケットにファイルが存在することを確認します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ファイルを開き、以下を検証します:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["パイプ区切りのカラム"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UTF-8 エンコーディング"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["カンマ区切りの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToAdd"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToRemove"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SegmentToSet"]}," の値"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Equativ の取り込みレポートまたは管理画面で、セグメントタクソノミーまたはプロファイル更新が適用されたことを確認します。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Equativ がファイルを拒否する場合は、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88%E6%A6%82%E8%A6%81"},"children":["ファイルフォーマット概要"]}," のセクションに照らしてファイルを確認し、ファイル種別、環境、リージョンに対応した正しいバケットへアップロードしているかを確認してください。"]}]},"headings":[{"value":"Equativ Batch File Export Integration","id":"equativ-batch-file-export-integration","depth":1},{"value":"前提条件","id":"前提条件","depth":2},{"value":"Treasure Data Integration の静的 IP アドレス","id":"treasure-data-integration-の静的-ip-アドレス","depth":2},{"value":"ファイルフォーマット概要","id":"ファイルフォーマット概要","depth":2},{"value":"タクソノミーファイルのカラム","id":"タクソノミーファイルのカラム","depth":3},{"value":"プロファイルファイルのカラム","id":"プロファイルファイルのカラム","depth":3},{"value":"Treasure コンソールで接続を作成する","id":"treasure-コンソールで接続を作成する","depth":2},{"value":"新しい認証を作成する","id":"新しい認証を作成する","depth":3},{"value":"ソースクエリを作成する","id":"ソースクエリを作成する","depth":2},{"value":"タクソノミーファイル用クエリの例","id":"タクソノミーファイル用クエリの例","depth":3},{"value":"プロファイルファイル用クエリの例","id":"プロファイルファイル用クエリの例","depth":3},{"value":"エクスポートを定義する","id":"エクスポートを定義する","depth":2},{"value":"オプション 1: クエリ結果をエクスポートする","id":"オプション-1-クエリ結果をエクスポートする","depth":3},{"value":"オプション 2: Audience Studio からアクティベートする","id":"オプション-2-audience-studio-からアクティベートする","depth":3},{"value":"Audience Studio で Segment をアクティベートする","id":"audience-studio-で-segment-をアクティベートする","depth":2},{"value":"Integration Parameters","id":"integration-parameters","depth":3},{"value":"エクスポートをスケジュールする","id":"エクスポートをスケジュールする","depth":2},{"value":"エクスポートを検証する","id":"エクスポートを検証する","depth":2}],"frontmatter":{"seo":{"title":"Equativ Batch File Export Integration","description":"Google Cloud Storage Export V2 コネクタと Equativ のバッチファイル同期バケットを使って、Treasure AI からセグメントタクソノミーとユーザープロファイルデータを Equativ に送信します。"}},"lastModified":"2026-06-01T09:47:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/equativ-batch-file-export-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}