このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

トリガープロパティオブジェクト

APIトリガー配信でキャンペーンを送信するためにエンドポイントの1つを使用する場合、メッセージをカスタマイズするためにキーと値のマップを提供できます。

trigger_propertiesのオブジェクトを含むAPIリクエストを行った場合、そのオブジェクトの値は、api_trigger_properties名前空間の下のメッセージテンプレートで参照できます。例えば、以下のようなリクエストでは、{{api_trigger_properties.${product_name}}}を追加することで、メッセージに"shoes"という単語を追加できます。

トリガープロパティはメッセージにテンプレート化できますが、デフォルトではユーザープロファイルに自動的には保存されないことに注意してください。

注

trigger_propertiesオブジェクトとapi_trigger_properties.${product_name}構文はキャンペーンでのみサポートされます。キャンバスのAPIトリガーリクエストからのキーと値でメッセージをカスタマイズするには、キャンバスエントリプロパティオブジェクトを使用してください。trigger_propertiesオブジェクトの最大サイズ制限は50 KBです。

オブジェクト本文

trigger_properties オブジェクトは、データ型として文字列、数値、ブール値、日付、オブジェクト、および配列をサポートしています。

{
  "trigger_properties" : {
    "product_name" : "shoes",
    "product_price" : 79.99,
    "details" : {
      "color" : "red",
      "size" : {
        "numerical" : 10,
        "country" : "US"
      }
    },
    "related_skus": ["123", "456", "789"],
    "line_items": [
      {
        "sku": "WH-9000",
        "name": "Wireless Headphones",
        "quantity": 1,
        "pricing": {
          "amount": 79.99,
          "currency": "USD"
        }
      },
      {
        "sku": "RS-450",
        "name": "Running Shoes",
        "quantity": 2,
        "pricing": {
          "amount": 129.99,
          "currency": "USD"
        }
      }
    ]
  }
}

Liquidテンプレートの例

api_trigger_properties名前空間を使用して、メッセージテンプレート内でトリガープロパティを参照できます。

文字列: {{api_trigger_properties.${product_name}}} は"shoes"を返します
数値: {{api_trigger_properties.${product_price}}} は79.99を返します
ネストされたオブジェクト: {{api_trigger_properties.${details}.${color}}} は"red"を返します
配列要素: {{api_trigger_properties.${related_skus}[0]}} は"123"を返します
複合オブジェクト配列: {{api_trigger_properties.${line_items}[0]}} は最初のラインアイテムオブジェクトを返します

New Stuff!