複合 ID キーを使用したリソースの呼び出し calling-a-resource-using-a-composite-identification-key
場合によっては、リソースに対して 2 つのフィールドで構成される識別キーを定義する必要があります。 識別キーを設定したら、Campaign Standardインターフェイスまたは API からこの識別キーを使用してリソースを呼び出せるように、フィルター定義を設定する必要があります。
この使用例では、 プロファイル リソースがカスタムで拡張されました "CRM ID" および "category" フィールド。 プロファイルリソースの識別キーを作成します。このキーは、これら 2 つのフィールドで構成されます。 次に、識別キーを使用してプロファイルリソースにアクセスできるように、フィルター定義を設定します。
この使用例の主な手順は次のとおりです。
- 2 つのフィールドに基づいて、プロファイルリソースの識別キーを設定します。
- フィルター定義を設定し、その識別キーを使用してプロファイルリソースを呼び出すことができるようにします。
- インターフェイスまたは APis からプロファイルリソースを呼び出します。
関連トピック :
手順 1:識別キーの設定 step-1-configure-the-identification-key
-
識別キーを設定する前に、目的のフィールドを使用してリソースが拡張され、公開されていることを確認します。 詳しくは、この節を参照してください。
-
次に移動: Administration / Development / Custom resources メニューを開き、 Profile リソース。
-
Adobe Analytics の Identification keys セクションで、 Create element 」ボタンをクリックします。
-
2 つのカスタム「CRM ID」フィールドと「カテゴリ」フィールドを追加し、「 Confirm.
note note NOTE プロファイルのインターフェイスに 2 つのカスタムフィールドを表示する場合は、 Screen definition タブをクリックします。 詳しくは、この節を参照してください。 -
これで、フィルター定義の識別キーを使用してリソースを呼び出せるように、フィルター定義を設定できます。
手順 2:フィルター定義の設定 step-2-configure-the-filter-definition
-
Adobe Analytics の Filter definition タブ、クリック Add an element 次に、フィルター定義のラベルと ID を入力します。
-
フィルター定義のプロパティを編集して、ルールを設定します。
-
識別キーで使用するフィールドを含むテーブルをワークスペースにドラッグ&ドロップします。
-
識別キーで使用する最初のフィールド (「CRM ID」) を選択し、 Switch to parameters オプション。
-
Adobe Analytics の Filter conditions セクション、 Equal 演算子を使用して、パラメーターの名前を定義し、プラス記号をクリックして作成します。
note note NOTE 次に、 + 」ボタンをクリックすると、パラメーターの名前が自動的に生成されます。 API からフィルターを使用するにはこの情報が必要なので、この情報に注意してください。 -
識別キー(「カテゴリ」)を構成するすべてのフィールドに対して上記の手順を繰り返し、変更を保存します。
-
これで、フィルター定義が設定されました。 フィルターを使用できるように、リソースを公開できます。
手順 3:識別キーに基づいてリソースを呼び出す step-3-call-the-resource-based-on-its-identification-key
識別キーとそのフィルター定義を設定したら、それらを使用して、Campaign Standard インターフェイスまたは 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 のドキュメント.