Adobe Target モジュール

Adobe Workfront Fusion シナリオ内で、Adobe Target を使用し、複数のサードパーティのアプリケーションやサービスに接続するワークフローを自動化できます。Adobe Target モジュールを使用すると、レコードの作成、読み取り、更新または削除、特定のタイプのすべてのレコードのリスト作成、指定した条件に基づくレコードの検索または Adobe Target API へのカスタム API 呼び出しの実行を行うことができます。

シナリオの作成手順について詳しくは、シナリオの作成を参照してください。

モジュールについては、モジュール: Adobe Workfront Fusionを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Adobe Target コネクタを使用する前に、次の前提条件が満たされていることを確認する必要があります。

  • アクティブな Adobe Target アカウントが必要です。

Adobe Target API の情報

Adobe Target コネクタでは、以下を使用します。

API タグ
v1.7.33

Adobe Target への接続の作成

IMPORTANT
2024 年 6 月 3 日(PT)以降に作成された接続では、Adobe Target サーバー間接続が必要になります。
  • 既存のサービスアカウント接続は、2025 年 1 月まで引き続き機能します。 サービスアカウント接続は、2024 年 1 月までにAdobe Target サーバー間接続に置き換える必要があります。
  • Adobe Target サーバー間接続を作成するには、組織の開発者である必要があります。 デベロッパーの役割は、Adobe Admin Consoleで設定されます。

Adobe Target モジュールの接続を作成するには、次の手順に従います。

  1. 「接続」ボックスの横に表示される「追加」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name この接続の名前を入力します。
    Connection type

    サービスアカウント接続を作成するか、Adobe Target サーバー間接続を作成するかを選択します。

    重要 :2024 年 6 月 3 日(PT)以降に作成された接続では、Adobe Target サーバー間接続が必要です。 既存のサービスアカウント接続は、2025 年 1 月まで引き続き機能します。 サービスアカウント接続は、2024 年 1 月までにAdobe Target サーバー間接続に置き換える必要があります。

    Environment 実稼動環境と非実稼動環境のどちらに接続するかを選択します。
    Type サービスアカウントと個人アカウントのどちらに接続するかを選択します。
    Client ID Adobe クライアント ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Client Secret Adobe クライアントの秘密鍵を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Technical account ID Adobe テクニカルアカウント ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Organization ID Adobe 組織 ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Tenant

    テナントを見つけるには、Adobe Experience Cloud にログインして、Target を開き、Target カードをクリックします。URL サブドメインで指定されているように、テナント ID の値を使用します。

    例えば、Adobe Target ログイン時に URL が <https://mycompany.experiencecloud.adobe.com/...> の場合、テナント ID は「mycompany」になります。

    Meta Scopes 入力 ent_marketing_sdk
    Private key

    Adobe Developer Console で資格情報が作成された際に生成された秘密鍵を入力します。

    秘密鍵または証明書を抽出するには:

    1. Extract をクリックします。

    2. 抽出するファイルのタイプを選択します。

    3. 秘密鍵または証明書を含むファイルを選択します。

    4. ファイルのパスワードを入力します。

    5. Save をクリックしてファイルを抽出し、接続設定に戻ります。

  3. 続行」をクリックして接続を保存し、モジュールに戻ります。

Adobe Target モジュールとそのフィールド

Adobe Target モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Adobe Target フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

アクション

レコードを作成

このアクションモジュールは、AB または XT のアクティビティ、オファーまたはオーディエンスを作成します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type

作成するレコードのタイプを選択します。

XT アクティビティフィールド
Name
このアクティビティの名前を入力またはマッピングします。名前は 250 文字以下にする必要があります。
Options

アクティビティに追加する各オプションで、Add item をクリックして、次のフィールドに入力します。

  • Option local ID

    API リクエストをまたいでオプションを追跡するために使用する文字列を入力またはマッピングします。

  • Name

    オプションの名前を入力またはマッピングします。名前は 250 文字以下にする必要があります。

  • Offer ID

  • オプションに関連付けられたオファーを選択またはマッピングします。

Locations

アクティビティに追加する mbox ごとに、Add item をクリックして、次のフィールドに入力します。

  • Audience IDs

    mbox に追加するオーディエンスごとに、Add item をクリックして、「オーディエンス ID 」を選択します。

  • Location local ID

    API リクエスト全体で場所を追跡するために使用する文字列を入力またはマッピングします。

  • Name

    場所の名前を入力またはマッピングします。名前は 250 文字以下にする必要があります。

Experiences

コンテンツオファーが提供されるページ上の場所のリスト。場所には次の情報が含まれます。

  • Experience Local ID

    エクスペリエンスの ID の入力またはマッピング

  • Name

    エクスペリエンスの名前を入力またはマッピング

  • Audience IDs

    エクスペリエンスを表示するオーディエンスごとに、Add item をクリックして、オーディエンス ID を入力します。

  • Visitor Percentage

    エクスペリエンスに割り当てられる訪問者の割合を入力またはマッピングします

Metrics
Third Party ID
このアクティビティを識別する ID を入力またはマッピングします。この ID を選択できます。この ID は、他のアクティビティと同じにすることはできません。また、250 文字以下にする必要があります。
Starts at
アクティビティを開始する日付と時刻を YYYY-MM-DD hh:mm:ss.z 形式で入力またはマッピングします。
Ends at
アクティビティを終了する日付と時刻を YYYY-MM-DD hh:mm:ss.z 形式で入力またはマッピングします。
State

アクティビティの状態を入力またはマッピングします。

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
アクティビティの優先度を定義する数値を入力します。数値が大きいほど、優先度が高くなります。この値は 0 ~ 999 の範囲で設定する必要があります。デフォルト値は 5 です。
Auto-allocate traffic

トラフィックを自動配分するには、このオプションを有効にします。自動配分により、より多くのトラフィックがより効果の高いエクスペリエンスに送信されます。

どのエクスペリエンスがより効果が高いかを判断するための評価基準を選択またはマッピングします。

Workspace
アクティビティが関連付けられているワークスペースを入力またはマッピングします
Property IDs
アクティビティに追加する各プロパティで、「Add item」をクリックして、プロパティの ID を選択またはマッピングします。
Reporting audiences

アクティビティに追加するレポートオーディエンスごとに、「Add item」をクリックし、次の情報を入力します。

  • Reporting Audience local ID

    API リクエスト全体でレポートオーディエンスを追跡するために使用する文字列を入力またはマッピングします。

  • Audience ID

    レポートで使用するセグメントを入力またはマッピングします

  • Metric local ID

    API リクエスト全体で指標を追跡するために使用する文字列を入力またはマッピングします。

オファーフィールド
Name
このアクティビティの名前を入力またはマッピングします。名前は 250 文字以下にする必要があります。
Content
ユーザーに表示するオファーのコンテンツを入力またはマッピングします。
Workspace
オファーに関連付けられているワークスペースの ID を入力またはマッピングします。空白の場合、オファーはアカウントのデフォルトのワークスペースに関連付けられます。この機能は、Target Premium アカウントのみに適用します。
Workspace
このオファーが変更された日時を入力またはマッピングします。

カスタム API 呼び出しの実行

このモジュールは、Adobe Target API に対してカスタム API 呼び出しを実行します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続の作成を参照してください。
Target Base URL
Target ベース URL を入力またはマッピングします。
Path
{baseURL}/ に対する相対パスの入力
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion 認証ヘッダーおよび x-api-key ヘッダーを自動的に追加します。

Query String
リクエストクエリ文字列を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

レコードの削除

このアクションモジュールは、1 つの AB アクティビティ、XT アクティビティ、オファーまたはオーディエンスを削除します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type
削除するレコードのタイプを選択します。
Record ID
削除するレコードの ID を入力またはマッピングします。

レコードの読み取り

このアクションモジュールは、1 つのアクティビティ、オファー、オーディエンス、プロパティまたはレポートのデータを取得します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type
読み取るレコードのタイプを選択します。
Record ID
読み取るレコードの ID を入力またはマップします。

レコードの更新

このアクションモジュールは、Target のレコードを更新します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type
更新するレコードのタイプを選択します。
フィールド名 ​

更新するフィールドを選択します。 フィールドが下に表示されます。

フィールドについて詳しくは、Adobe Target API ドキュメントを参照してください。

検索

レコードの取得

この検索モジュールは、選択したタイプのレコードのリストを取得します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type
更新するレコードのタイプを選択します。
Sort by
並べ替えるフィールドごとに、「Add item」をクリックして、フィールドを選択して、返される結果を昇順または降順のどちらにするかを選択します。
Starts At

レコードを取得する最も早い日付を入力します。

サポートされる日付と時刻の形式のリストについて詳しくは、Adobe Workfront Fusion での型強制を参照してください。

Ends At

レコードを取得する最新の日付を入力します。

サポートされる日付と時刻の形式のリストについて詳しくは、Adobe Workfront Fusion での型強制を参照してください。

検索

この検索モジュールは、指定した条件に基づいてアクティビティ、オファーまたはオーディエンスを検索します。

Connection
Adobe Target への接続を作成する手順については、この記事のAdobe Target への接続を作成を参照してください。
Record type
更新するレコードのタイプを選択します。
Sort by
並べ替えるフィールドごとに、「Add item」をクリックして、フィールドを選択し、返される結果を昇順または降順のどちらにするかを選択します。
Search criteria
設定するルールごとに、フィールド、演算子および値を選択します。「Add AND rule」をクリックして、追加のルールを作成します。
Offset

モジュールが返す最初の応答の数を入力します。最初に返された応答のオフセットは 0 です。このフィールドを Maximum number of returned results フィールドと組み合わせて使用し、応答をページ番号付けします。

例えば、応答の 3 ページ目を表示する際、各ページに 10 件の応答がある場合、Offset を 20 に、Maximum number of returned の結果を 10 に設定します。

Limit

各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。このフィールドを Offset フィールドと組み合わせて使用し、応答をページ番号付けします。

例えば、応答の 3 ページ目を表示する際、各ページに 10 件の応答がある場合、Offset を 20 に、Maximum number of returned の結果を 10 に設定します。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43