複合 ID キーを使用したリソースの呼び出し

場合によっては、2つのフィールドで構成される識別キーをリソースに対して定義する必要があります。 IDキーを設定したら、Campaign StandardインターフェイスまたはAPIからこのIDキーを使用してリソースを呼び出せるように、フィルター定義を設定する必要があります。

この使用例では、 プロファイル リソースがカスタムの「CRM ID 」フィールドと「 カテゴリ」 ​フィールドを使用して拡張されています。 この2つのフィールドで構成されるプロファイルリソースのIDキーを作成します。 次に、IDキーを使用してプロファイルリソースにアクセスできるように、フィルター定義を設定します。

この使用例の主な手順は次のとおりです。

  1. 2つのフィールドに基づいて、プロファイルリソースのIDキーを設定します。
  2. IDキーを使用してプロファイルリソースを呼び出せるように、フィルター定義を設定します。
  3. プロファイルリソースをインターフェイスまたはAPから呼び出します。

関連トピック :

手順1:IDキーの設定

NOTE

IDキーを設定する際のグローバルな概念について詳し くは、この節

  1. IDキーを設定する前に、目的のフィールドでリソースが拡張され、発行されていることを確認します。 詳しくは、この節を参照してください。

  2. Administration / Developement /」 Custom resources メニューに移動し、 Profile リソースを開きます。

  3. In the Identification keys section, click the Create element button.

  4. 2つ追加のカスタム「CRM ID」と「カテゴリ」フィールドで、をクリックし Confirm​ます。

    NOTE

    プロファイルのインターフェイスに2つのカスタムフィールドを表示する場合は、 Screen definition タブを設定します。 詳しくは、この節を参照してください。

  5. これで、フィルター定義のIDキーを使用してリソースを呼び出せるようにフィルター定義を設定できます。

手順2:フィルター定義の設定

NOTE

フィルター定義を設定する際のグローバル概念について詳し くは、この節

  1. タブでをクリック Filter definitionAdd an element​し、フィルタ定義のラベルとIDを入力します。

  2. フィルター定義のプロパティを編集して、ルールを設定します。

  3. IDキーで使用されるフィールドを含むテーブルをワークスペースにドラッグ&ドロップします。

  4. IDキーで使用される最初のフィールド(「CRM ID」)を選択し、この Switch to parameters オプションをアクティブ化します。

  5. このセクションでは、 Filter conditionsEqual 演算子をそのまま使用し、パラメーターの名前を定義し、プラス記号をクリックして作成します。

    NOTE

    +」 ボタンをクリックすると、パラメーター名が自動的に生成されます。 この情報は、APIのフィルタを使用する必要があるので、注意してください。

  6. IDキー(「カテゴリ」)を構成するすべてのフィールドに対して上記の手順を繰り返し、変更を保存します。

  7. これで、フィルター定義が設定されます。 リソースを公開して、フィルターを使用できます。

手順3:識別キーに基づいてリソースを呼び出す

IDキーとそのフィルター定義が設定されたら、それらを使用して、キャンペーン標準インターフェイスまたはREST APIからリソースを呼び出すことができます。

インターフェイスのフィルタ定義を使用するには、ワークフローで Query アクティビティを使用します( この節を参照)。 その後、左側のペインでフィルターを使用できます。

Campaign StandardREST APIのフィルター定義を使用するには、次の構文を使用します。

GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>

この例では、「123456」CRM IDを持つ「spring」カテゴリからプロファイルを取得する構文は次のようになります。

GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456

詳しくは、 Campaign StandardREST APIのドキュメントを参照してください

このページ