3.5セグメントの作成 — API

この演習では、PostmanとAdobe I/Oを使用し、Adobe Experience PlatformのAPIを使用して、セグメントを作成し、そのセグメントの結果をデータセットとして保存します。

Story

リアルタイム顧客プロファイルでは、すべてのプロファイルデータが、イベントデータと既存のセグメントメンバーシップと共に表示されます。 表示されるデータは、Adobe・アプリケーションや外部ソリューションなど、どこからでも取得できます。 これは、過去最高の経験システムであるAdobe Experience Platformで最も強力なビューです。

演習3.5.1 - Platform APIを使用してセグメントを作成する

郵便番に行く。

コレクションを探します。_Adobe Experience Platformの有効化。 このコレクションには、フォルダー​2が表示されます。 セグメント. この演習では、これらのリクエストを使用します。

セグメント化

次に、APIを使用してセグメントを作成するために必要なすべての手順に従います。 シンプルなセグメントを作成します。"ldap — すべての女性顧客。"

手順1 — セグメント定義の作成

Step 1 - Profile:セグメント定義​を作成します。

セグメント化

このリクエストの​Body​セクションに移動します。

セグメント化

このリクエストの​Body​には、次の内容が表示されます。

セグメント化

このリクエストに使用する言語は、プロファイルクエリ言語、または​PQL​と呼ばれます。

PQL に関する詳細およびドキュメントは、で確認できます。

注意:ldap​を特定の​ldap​に置き換えて、以下のリクエストで変数​name​を更新してください。

{
    "name" : "ldap - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "ldap",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

特定の​ldap​を追加した後、本文は次のようになります。

{
    "name" : "vangeluw - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "vangeluw",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

また、リクエストの​Header — フィールドも確認する必要があります。 Headers​に移動します。 次の内容が表示されます。

郵便配達人

キー
x-sandbox-name --aepSandboxId--
メモ

使用しているAdobe Experience Platformサンドボックスの名前を指定する必要があります。 x-sandbox-nameは--aepSandboxId--にする必要があります。

次に、青い「送信」ボタンをクリックして、セグメントを作成し、その結果を表示します。

セグメント化

この手順の後、Platform UIでセグメント定義を表示できます。 これを確認するには、Adobe Experience Platformにログインし、Segments​に移動します。

セグメント化

手順2 — セグメントジョブのPOST

前の練習では、ストリーミング​セグメントを作成しました。 ストリーミングセグメントは、リアルタイムで継続的に資格を評価します。 ここで何をするかは、バッチ​セグメントを作成することです。 バッチセグメントでは、資格に関してセグメントがどのように表示されるかをプレビューできますが、はセグメントが実際に実行されたとは限りません。 現在、このセグメントには​誰も該当しません。 ユーザーを絞り込むには、バッチセグメントを実行する必要があります。これは、ここでおこなう操作です。

次に、セグメントジョブをPOSTします。

郵便番に行く。

セグメント化

Postmanコレクションで、Step 2 - Segment Job​という名前のリクエストをクリックして開きます。

セグメント化

また、リクエストの​Header — フィールドも確認する必要があります。 Headers​に移動します。 次の内容が表示されます。

郵便配達人

キー
x-sandbox-name --aepSandboxId--
メモ

使用しているAdobe Experience Platformサンドボックスの名前を指定する必要があります。 x-sandbox-nameは--aepSandboxId--にする必要があります。

青い「送信」ボタンをクリックします。

同様の結果が表示されます。

セグメント化

このセグメントジョブは現在実行中です。この処理には時間がかかる場合があります。 手順3で、このジョブのステータスを確認できます。

手順3 -GETセグメントジョブのステータス

郵便番に行く。

セグメント化

Postmanコレクションで、手順3 -GETセグメントジョブのステータス​という名前のリクエストをクリックします。

セグメント化

また、リクエストの​Header — フィールドも確認する必要があります。 Headers​に移動します。 次の内容が表示されます。

郵便配達人

キー
x-sandbox-name --aepSandboxId--
メモ

使用しているAdobe Experience Platformサンドボックスの名前を指定する必要があります。 x-sandbox-nameは--aepSandboxId--にする必要があります。

青い「送信」ボタンをクリックします。

同様の結果が表示されます。

セグメント化

この例では、ジョブの​status​が​QUEUED​に設定されます。

ステータス​が​SUCCEEDED​に設定されるまで、青い「送信」ボタンを数分ごとにクリックして、このリクエストを繰り返します。

セグメント化

ステータスが「SUCCEEDED」になると、セグメントジョブが実行され、お客様はセグメントの条件を満たすようになります。

これで、セグメント化の演習が完了しました。 次に、企業全体でリアルタイム顧客プロファイルを有効化する方法を見てみましょう。

次の手順:3.6コールセンターでリアルタイム顧客プロファイルの実行状況を確認する

モジュール3に戻る

すべてのモジュールに戻る

このページ