Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
CDPCloud Portal
Sitecore CDP
  • データ ブラウザー機能を使用する
    • オーディエンスの活性化のためのアイデア
        • オーディエンスのメールアドレスを即座にエクスポートする
        • オーディエンスのメールアドレスを毎日エクスポートする
        • 完了した注文を持つオーディエンスのデルタをエクスポートする
        • オーディエンスエクスポートの最新の出力をSitecore Connect
        • オーディエンスのエクスポートの特定の出力をSitecore Connect
    • オーディエンスのエクスポートを管理する
    • オーディエンスのエクスポートのトラブルシューティング
  1. オーディエンスのエクスポート
  1. Sitecore CDP
  2. オーディエンスのエクスポート
  3. オーディエンスのエクスポートを操作するためのチュートリアル

オーディエンスのエクスポートの特定の出力を Sitecore Connect

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このチュートリアルでは、オーディエンスのエクスポートの最新の出力をSitecore Connectで受信して、その出力をサードパーティのシステムに送信する方法について説明します。まず、Webhookアドレスとペイロードスキーマを設定するレシピを作成し、次に最新のオーディエンスエクスポート出力を取得するアクションを追加します。次に、レシピを展開して、オーディエンスのエクスポートの実行が完了するたびに出力のgzip圧縮されたファイルを受信して抽出するように設定します。

5ステップのレシピを次の画像に示します。

A five-step recipe in Sitecore Connect that receives and extracts the output of a Sitecore CDP audience export.

このチュートリアルでは、次の方法について説明します。

  • Webhookアドレスを生成し、ペイロード スキーマを設定します。

  • オーディエンスエクスポートの特定の出力のURLを取得するアクションを追加します。

  • gzip圧縮された出力ファイルをURLから取得します。

  • gzip圧縮された出力を抽出します。

  • レシピをテストします。

始める前に
  • Sitecore CDPに有効なAPIキーとAPIシークレットがあることを確認してください。新しいCDP接続を設定する必要がある場合は、これらを提供する必要があります。

  • オーディエンスエクスポートの出力の内容を理解します。

Webhookアドレスを生成し、ペイロード スキーマを設定する

Sitecore Connectでレシピを作成し、トリガーを設定します。これにより、Webhookアドレスを設定および生成し、サンプル ペイロード スキーマを追加できます。このステップは、レシピのステップ1に対応しています。

Webhookアドレスを生成し、ペイロード スキーマを設定するには:

  1. Sitecore Connectのプロジェクトで、「Create > Recipe」をクリックします。

  2. Set up your recipeウィンドウで、「 Trigger from a webhook」をクリックし、「 Start building」をクリックします。

  3. Setupパネルで、setup manuallyをクリックします。

  4. Event nameフィールドに、一意のイベント名を入力します (例: CDP to Connect)。HTTPS Webhook URLが表示されます。

  5. Payload configurationセクションで、Payload schemaの下のUse JSONをクリックします。

  6. Generate schemaウィンドウで、次のJSONサンプルを貼り付け、Nextをクリックします。

    {
      "audienceExportExecutionRef": "",
      "friendlyId": "",
      "clientKey": "",
      "audienceExportRef": ""
    } 
  7. スキーマのプレビューを確認し、「 Generate schema」をクリックします。

  8. Payload configurationセクションでは、JSONスキーマがPayload schemaセクションに追加されました。

特定の出力のURLを取得するアクションを追加する

レシピにアクションを追加して、オーディエンスエクスポートの特定の出力のURLを取得します。このステップは、レシピのステップ2に対応しています。

これらのURLは、出力をダウンロードできる場所です。 Sitecore Connectレシピでそれらを取得することで、レシピで出力を直接操作できます。

URLを取得するには:

  1. レシピキャンバスのActionsの下にあるプラス記号をクリックし、Action in an appをクリックします。

  2. Appペインで、「Sitecore CDP」を検索してクリックします。

  3. Actionパネルで、Audience export - Get files by execution refをクリックします。

  4. Connectionウィンドウで、使用するアクティブな接続が既にある場合は、それを選択します。それ以外の場合は、次のフィールドに入力して新しいものを作成します。

    • Client keyおよびAPI token - これらの値をSitecore CDPで見つけるには、「 > API access」をクリックします。

    • Client IDClient secret- クライアントIDシークレットは APIキー で、クライアント シークレットはAPIシークレットです。これらの値を見つけるには、Sitecore CDP > Developer Center > API keysでAPIキーを作成します。

    • AWS region - この値をSitecore CDPで見つけるには、「 > Company information > Environment」をクリックします。

  5. Setupウィンドウで、Audience export execution refフィールドを見つけます。

  6. レシピキャンバスの右下隅で、Recipe dataを展開します。

  7. Step 1 outputで、Payloadで、Audience export execution refフィールドをクリックしてAudience export execution refフィールドにドラッグします。

    エクスポートジョブ参照は、オーディエンスエクスポートの特定の出力を識別します。 Audience export execution refフィールドに参照を指定することで、Sitecore Connectが受信する正確な出力の出力URLを取得するようにします。

  8. 「 Save」をクリックします。

URLからgzip圧縮された出力ファイルを取得します

出力URLを受信したら、URLからgzip圧縮された出力を取得するようにレシピを構成します。このステップは、レシピのステップ3と4に対応しています。

gzip圧縮された出力を取得するには、次のようにします。

  1. レシピキャンバスのRetrieve output URLsステップの下にあるプラス記号をクリックし、Repeat for eachをクリックします。

  2. 設定ペインで、Input listフィールドをクリックします。 Recipe dataペインが展開されます。

  3. Recipe dataペインのStep 2 outputで、Exportsフィールドをクリックして設定ペインの > Input listフィールドにドラッグします。

  4. 設定ペインのRepeat modeで、Batch of itemsを選択します。

  5. Batch sizeフィールドに5000と入力します。

  6. レシピキャンバスのFor eachステップ内で、「 Select an app and action」をクリックします。 Appペインが表示されます。

  7. Appパネルで、「File tools by Workato」を検索してクリックします。Actionペインが表示されます。

  8. Actionパネルで、Get file from URLをクリックします。SetupペインとRecipe dataペインが表示されます。

  9. Recipe dataペインのStep 3 output > Batchで、URLフィールドをクリックしてSetupペインの > URLフィールドにドラッグします。

    「URL」フィールドに出力URLを指定することで、Sitecore Connect URLからgzip圧縮された出力を確実に取得できます。

gzip圧縮された出力を抽出します

URLからgzip圧縮された出力を取得したら、出力を抽出するようにレシピを設定します。このステップは、レシピのステップ5に対応しています。

gzip圧縮された出力を抽出するには、次のようにします。

  1. レシピキャンバスで、Get file from URLステップの下にカーソルを合わせてプラス記号を表示し、プラス記号をクリックしてSelect an app and actionをクリックします。 Appペインが表示されます。

  2. Appパネルで、「File tools by Workato」を検索してクリックします。Actionペインが表示されます。

  3. Actionパネルで、Uncompress a fileをクリックします。SetupペインとRecipe dataペインが表示されます。

  4. SetupペインのCompression formatで、Gzipを選択します。

  5. Archive formatで、Noneを選択します。

  6. Recipe dataペインのStep 4 outputで、File contentsフィールドをクリックしてSetupペインの > File contentsフィールドにドラッグします。

    「URL」フィールドに出力URLを指定することで、Sitecore Connectがgzip圧縮された出力を確実に抽出します。

  7. 「 Save」をクリックし、「 Exit 」をクリックしてレシピエディタを閉じます。

  8. 「 Start recipe」をクリックします。レシピにActiveステータスが表示されます。

レシピをテストする

これで、レシピを5つのステップに拡張し、オーディエンスエクスポートの出力URLを取得し、URLからgzip圧縮された出力を取得してから、gzip圧縮された出力を抽出するように構成されました。レシピが機能することを確認するには、テストします。

レシピをテストするには:

  1. レシピで、Test recipeをクリックします。

    これで、レシピは新しいWebhook通知をリッスンしています。

  2. Sitecore CDPで、オーディエンスのエクスポートで、もう一度Resend last notificationをクリックします。

  3. レシピのTest jobsで、テストジョブのステータスがSuccessfulであることを確認します。これは、レシピがオーディエンスエクスポートのgzip圧縮された出力を正常に抽出したことを意味します。

次のステップ

これで、オーディエンスエクスポートの出力をSitecore Connectで受信して抽出するレシピの準備が整いました。

次に、Sitecore CDPに移動し、レシピをオーディエンスのエクスポートに接続して 、オーディエンスのエクスポートを実行します。オーディエンスのエクスポートが実行されるたびに、Webhookは接続されたレシピをトリガーし、定義されたアクションを実行します。

また、出力をサードパーティのシステムに送信する プロセスを自動化し続けることで、オーディエンスを活性化することもできます。

この記事を改善するための提案がある場合は、 お知らせください!

Documentation Assistant

This assistant uses AI to generate responses based on Sitecore documentation. While it has access to official sources, answers may be incomplete or inaccurate and should not be considered official advice or support.
Powered by
k
kapa.ai
Protected by reCAPTCHA

© Copyright 2026, Sitecore A/S or a Sitecore affiliated company.
All rights reserved.

Privacy policySitecore Trust CenterTerms of use