ドキュメントTargetTarget ガイド

JSON オファーの作成

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック:
  • エクスペリエンスおよびオファー

Form-Based Experience Composer で使用する JSON オファーを Adobe Target の Offer Library で作成します。

JSON オファーをフォームベースのアクティビティで使用すると、SPA フレームワークまたはサーバーサイド統合で使用するために JSON 形式でオファーを送信する際に Target ーザー決定が必要になるユースケースを可能にできます。

JSON の考慮事項

JSON オファーを使用する際は次の点を考慮してください。

  • JSON オファーは現在、A/B Test、Automated Personalization (AP)および Experience Targeting (XT)アクティビティでのみ使用できます。
  • JSON オファーは、 フォームベースのアクティビティでのみ使用できます。
  • JSON オファーは、 サーバーサイド API および Mobile Node.js、Java、.NET、Python SDK を使用している場合に直接取得できます。
  • ブラウザーでは、JSON オファーは、at.js 1.2.3 (またはそれ以降)経由でのみ取得でき、setJson アクションを使用してアクションをフィルタリングすることで getOffer ()を使用できます。
  • JSON オファーは、文字列ではなくネイティブの JSON オブジェクトとして配信されます。これらのオブジェクトを利用する際に、オブジェクトを文字列として処理し、JSON オブジェクトに変換する必要はなくなりました。
  • JSON オファーはビジュアルオファーではないので、他のオファー(HTML オファーなど)とは異なり自動的に適用されることはありません。開発者は、getOffer ()を使用してオファーを明示的に取得するコードを記述する必要があります。

JSON オファーの作成

  1. Offers/Code Offers ​をクリックします。
  2. Create Offer/JSON Offer ​をクリックします。
  3. オファー名を入力します。
  4. (条件付き) Target Premium アカウントをお持ちの場合は、目的の ワークスペースを選択します。
  5. (条件付き)目的のプロファイル属性を選択します。
  6. Code ボックスに JSON コードを入力または貼り付けます。
  7. Create をクリックします。

JSON の例

JSON オファーは、 フォームベースの Experience Composer を使用して作成されたアクティビティでのみサポートされます。 現在、JSON オファーを使用できるのは、API またはSDKの直接呼び出しを介してのみです。

次に例を示します。

JSON オファーを作成ダイアログボックス

success コールバックに渡すアクションは、オブジェクトの配列です。1 つの JSON オファーがあり、そこに次のコンテンツがあるとします。

{
  "demo": {"a": 1, "b": 2}
}

アクション配列の構造は次のとおりです。

[
 {
   action: "setJson",
   content: [{
     "demo": {"a": 1, "b": 2}
   }]
 }
]

JSON オファーを抽出するには、アクションを反復処理し、setJson アクションを含むアクションを見つけて、コンテンツ配列を反復処理します。

ユースケース

次の JSON オファーが Web ページに配信されるとします。

{
    "_id": "5a65d24d8fafc966921e9169",
    "index": 0,
    "guid": "7c006504-c6f7-468d-a46f-f72531ea454c",
    "isActive": true,
    "balance": "$2,075.06",
    "picture": "https://placehold.it/32x32",
    "tags": [
      "esse",
      "commodo",
      "excepteur"
    ],
    "friends": [
      {
        "id": 0,
        "name": "Carla Lyons"
      },
      {
        "id": 1,
        "name": "Ollie Mooney"
      }
    ],
    "greeting": "Hello, Stephenson Fernandez! You have 4 unread messages.",
    "favoriteFruit": "strawberry"
}

次のコードは、「greeting」属性にアクセスする方法を示しています。

adobe.target.getOffer({
  "mbox": "name_of_mbox",
  "params": {},
  "success": function(offer) {
        console.log(offer[0].content[0].greeting);
  },
  "error": function(status, error) {
      console.log('Error', status, error);
  }
});

Real-time CDP プロファイル属性を使用した JSON オファーの例

Real-time CDP プロファイル属性は、HTMLオファーと JSON オファーで使用するために Target と共有できます。

詳しくは、Real-time CDP プロファイル属性の Target との共有を参照してください。

JSON オファータイプによるオファーのフィルタリング

Show filters のアイコン( フィルターを表示アイコン )をクリックし、「JSON Offers」チェックボックスを選択すると、JSON オファータイプで Offers ライブラリをフィルタリングできます。

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654