オーディエンスのエクスポートの特定の出力を Sitecore Connect
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このチュートリアルでは、オーディエンスのエクスポートの最新の出力をSitecore Connectで受信して、その出力をサードパーティのシステムに送信する方法について説明します。まず、Webhookアドレスとペイロードスキーマを設定するレシピを作成し、次に最新のオーディエンスエクスポート出力を取得するアクションを追加します。次に、レシピを展開して、オーディエンスのエクスポートの実行が完了するたびに出力のgzip圧縮されたファイルを受信して抽出するように設定します。
5ステップのレシピを次の画像に示します。

このチュートリアルでは、次の方法について説明します。
-
Webhookアドレスを生成し、ペイロード スキーマを設定します。
-
オーディエンスエクスポートの特定の出力のURLを取得するアクションを追加します。
-
gzip圧縮された出力ファイルをURLから取得します。
-
gzip圧縮された出力を抽出します。
-
レシピをテストします。
-
Sitecore CDPに有効なAPIキーとAPIシークレットがあることを確認してください。新しいCDP接続を設定する必要がある場合は、これらを提供する必要があります。
Webhookアドレスを生成し、ペイロード スキーマを設定する
Sitecore Connectでレシピを作成し、トリガーを設定します。これにより、Webhookアドレスを設定および生成し、サンプル ペイロード スキーマを追加できます。このステップは、レシピのステップ1に対応しています。
Webhookアドレスを生成し、ペイロード スキーマを設定するには:
-
Sitecore Connectのプロジェクトで、「Create > Recipe」をクリックします。
-
Set up your recipeウィンドウで、「 Trigger from a webhook」をクリックし、「 Start building」をクリックします。
-
Setupパネルで、setup manuallyをクリックします。
-
Event nameフィールドに、一意のイベント名を入力します (例: CDP to Connect)。HTTPS Webhook URLが表示されます。
-
Payload configurationセクションで、Payload schemaの下のUse JSONをクリックします。
-
Generate schemaウィンドウで、次のJSONサンプルを貼り付け、Nextをクリックします。
-
スキーマのプレビューを確認し、「 Generate schema」をクリックします。
-
Payload configurationセクションでは、JSONスキーマがPayload schemaセクションに追加されました。
特定の出力のURLを取得するアクションを追加する
レシピにアクションを追加して、オーディエンスエクスポートの特定の出力のURLを取得します。このステップは、レシピのステップ2に対応しています。
これらのURLは、出力をダウンロードできる場所です。 Sitecore Connectレシピでそれらを取得することで、レシピで出力を直接操作できます。
URLを取得するには:
-
レシピキャンバスのActionsの下にあるプラス記号をクリックし、Action in an appをクリックします。
-
Appペインで、「Sitecore CDP」を検索してクリックします。
-
Actionパネルで、Audience export - Get files by execution refをクリックします。
-
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」をクリックします。
-
-
Setupウィンドウで、Audience export execution refフィールドを見つけます。
-
レシピキャンバスの右下隅で、Recipe dataを展開します。
-
Step 1 outputで、Payloadで、Audience export execution refフィールドをクリックしてAudience export execution refフィールドにドラッグします。
エクスポートジョブ参照は、オーディエンスエクスポートの特定の出力を識別します。 Audience export execution refフィールドに参照を指定することで、Sitecore Connectが受信する正確な出力の出力URLを取得するようにします。
-
「 Save」をクリックします。
URLからgzip圧縮された出力ファイルを取得します
出力URLを受信したら、URLからgzip圧縮された出力を取得するようにレシピを構成します。このステップは、レシピのステップ3と4に対応しています。
gzip圧縮された出力を取得するには、次のようにします。
-
レシピキャンバスのRetrieve output URLsステップの下にあるプラス記号をクリックし、Repeat for eachをクリックします。
-
設定ペインで、Input listフィールドをクリックします。 Recipe dataペインが展開されます。
-
Recipe dataペインのStep 2 outputで、Exportsフィールドをクリックして設定ペインの > Input listフィールドにドラッグします。
-
設定ペインのRepeat modeで、Batch of itemsを選択します。
-
Batch sizeフィールドに5000と入力します。
-
レシピキャンバスのFor eachステップ内で、「 Select an app and action」をクリックします。 Appペインが表示されます。
-
Appパネルで、「File tools by Workato」を検索してクリックします。Actionペインが表示されます。
-
Actionパネルで、Get file from URLをクリックします。SetupペインとRecipe dataペインが表示されます。
-
Recipe dataペインのStep 3 output > Batchで、URLフィールドをクリックしてSetupペインの > URLフィールドにドラッグします。
「URL」フィールドに出力URLを指定することで、Sitecore Connect URLからgzip圧縮された出力を確実に取得できます。
gzip圧縮された出力を抽出します
URLからgzip圧縮された出力を取得したら、出力を抽出するようにレシピを設定します。このステップは、レシピのステップ5に対応しています。
gzip圧縮された出力を抽出するには、次のようにします。
-
レシピキャンバスで、Get file from URLステップの下にカーソルを合わせてプラス記号を表示し、プラス記号をクリックしてSelect an app and actionをクリックします。 Appペインが表示されます。
-
Appパネルで、「File tools by Workato」を検索してクリックします。Actionペインが表示されます。
-
Actionパネルで、Uncompress a fileをクリックします。SetupペインとRecipe dataペインが表示されます。
-
SetupペインのCompression formatで、Gzipを選択します。
-
Archive formatで、Noneを選択します。
-
Recipe dataペインのStep 4 outputで、File contentsフィールドをクリックしてSetupペインの > File contentsフィールドにドラッグします。
「URL」フィールドに出力URLを指定することで、Sitecore Connectがgzip圧縮された出力を確実に抽出します。
-
「 Save」をクリックし、「 Exit 」をクリックしてレシピエディタを閉じます。
-
「 Start recipe」をクリックします。レシピにActiveステータスが表示されます。
レシピをテストする
これで、レシピを5つのステップに拡張し、オーディエンスエクスポートの出力URLを取得し、URLからgzip圧縮された出力を取得してから、gzip圧縮された出力を抽出するように構成されました。レシピが機能することを確認するには、テストします。
レシピをテストするには:
-
レシピで、Test recipeをクリックします。
これで、レシピは新しいWebhook通知をリッスンしています。
-
Sitecore CDPで、オーディエンスのエクスポートで、もう一度Resend last notificationをクリックします。
-
レシピのTest jobsで、テストジョブのステータスがSuccessfulであることを確認します。これは、レシピがオーディエンスエクスポートのgzip圧縮された出力を正常に抽出したことを意味します。
次のステップ
これで、オーディエンスエクスポートの出力をSitecore Connectで受信して抽出するレシピの準備が整いました。
次に、Sitecore CDPに移動し、レシピをオーディエンスのエクスポートに接続して 、オーディエンスのエクスポートを実行します。オーディエンスのエクスポートが実行されるたびに、Webhookは接続されたレシピをトリガーし、定義されたアクションを実行します。
また、出力をサードパーティのシステムに送信する プロセスを自動化し続けることで、オーディエンスを活性化することもできます。