このページ： Journey Optimizer で API トリガーキャンペーンを作成して、個々のユーザーまたはオーディエンスのライブアクティビティをリモートで開始、更新、終了できるようにします。
モバイル設定を指定し、Adobe Experience Platform Mobile SDK を実装したら、Journey Optimizer でライブアクティビティの作成を開始できます。
-
キャンペーンメニューにアクセスし、「キャンペーンを作成」をクリックします。
-
API トリガーキャンペーンタイプを選択します。
-
オーディエンスベースのキャンペーンには、「API トリガーマーケティング」を選択します
-
個々のキャンペーンには、「API トリガートランザクション」を選択します。
note important IMPORTANT API トリガートランザクションには、「高スループット」オプションを有効にしないでください。 
-
-
「プロパティ」セクションで、キャンペーンの「タイトル」と「説明」を編集します。
-
「アクション」セクションで、「ライブアクティビティ」を選択し、新しい設定を選択または作成します。
ライブアクティビティの設定について詳しくは、このページを参照してください。
-
「実験を作成」をクリックしてコンテンツ実験の設定を開始し、パフォーマンスを測定してターゲットオーディエンスに最適なオプションを特定するための処理を作成します。 詳細情報
-
「オーディエンス」タブから、ID タイプを選択します 詳細情報
note NOTE API トリガーマーケティングキャンペーンの場合、API ペイロードから APNs channelID サブスクリプションを確認する前に、最初のセグメントとして機能する既存のオーディエンスを選択できます。 -
キャンペーンは、特定の日付に実行するか、繰り返し頻度で実行するように設計されています。 キャンペーンの スケジュール を設定する方法については、この節を参照してください。
-
設定が完了したら、「レビューしてアクティブ化」をクリックし、「アクティブ化」をクリックします。
-
キャンペーンをアクティブ化したら、指定された cURL リクエストをテンプレートとして使用して、ライブアクティビティの開始、更新、終了イベントをトリガーします。 実行前に、特定のデータでサンプルペイロードを更新します。
また、ペイロードに含めるキャンペーン ID 識別子もコピーします。
➡️ OAuth トークンや API キーを含む認証要件について詳しくは、API トリガーキャンペーンドキュメントを参照してください。
accordion 単一ユースケース用のペイロードの例（API トリガートランザクションキャンペーン） このペイロードの例は、API トリガートランザクションキャンペーンのタイプを使用する個々のキャンペーン用です。 次のペイロード例のフィールドのほとんどは必須で、
requestId、dismissal-date、alertのみがオプションです。code language-json { "requestId": "your-request-id", "campaignId": "your-campaign-id", "recipients": [ { "type": "aep", "userId": "testemail@gmail.com", "namespace": "email", "context": { "requestPayload": { "aps": { "content-available": 1, "timestamp": 1756984054, // current epoch time "dismissal-date": 1756984084, // optional – auto remove when event="end" "event": "update", // start | update | end // Fields from FoodDeliveryLiveActivityAttributes "content-state": { "orderStatus": "Delivered" }, "attributes-type": "FoodDeliveryLiveActivityAttributes", "attributes": { "restaurantName": "Pizza", "liveActivityData": { "liveActivityID": "orderId1" // customer reference ID } }, "alert": { "title": "Order Delivered!", "body": "Your pizza has arrived." } } } } } ] }accordion ブロードキャストユースケース用のペイロードの例（API トリガーマーケティングキャンペーン） このペイロードの例は、API トリガーマーケティングキャンペーンのタイプを使用するオーディエンスベースのキャンペーン用です。
code language-json { "requestId": "123400000", "campaignId": "d32e6f6c-56df-4a98-a2c0-6db6008f8f32", "audience": { "id": "508f9416-52d0-4898-ba47-08baaa22e9c7" }, "context": { "requestPayload": { "aps": { "input-push-channel": "V+8UslywEfAAAOq9SbTrLg==", //apns-channel-id "content-available": 1, "timestamp": 1770808339, "event": "update", // start | update | end // Fields from GameScoreLiveActivityAttributes "content-state": { "homeTeamScore": 33, "awayTeamScore": 49, "statusText": "Wingdom keeps scoring!" }, "attributes-type": "GameScoreLiveActivityAttributes", "attributes": { "liveActivityData": { "channelID": "V+8UslywEfAAAOq9SbTrLg==" //apns-channel-id, must match the "input-push-channel" value } }, "alert": { "title": "This is the title for game", "body": "This is the body for body" } } } } }
ライブアクティビティをデザインしたら、ビルトインのレポートを使用してライブアクティビティの影響の測定を追跡できます。
実行メタデータを使用したカスタムデータの追加 metadata
executionMetadataは、API トリガートランザクションおよび API トリガーマーケティング の両方のキャンペーンで使用できます。オプションのexecutionMetadata フィールドを使用して、注文ID、ロイヤルティ層、地域コードなどのプロファイルに独自の カスタムデータ を添付します。 Journey Optimizerは、このデータを実行と並行して保存するので、ライブアクティビティフィードバックデータセットから後で取得し、配信結果を独自のビジネスレコードに一致させることができます。
実行メタデータを含むカスタムデータを追加するには：
-
executionMetadataをuserIdとnamespaceの横にあるプロファイルに追加します。 文字列キーと文字列値のみが受け入れられ、文字列以外の値を文字列に変換してから送信します。 -
値は送信時とまったく同じように記録されます。
executionMetadataはパーソナライゼーション式をサポートしていないため、{{...}}式は解決済みではなくリテラルテキストとして扱われます。 常に最終的なリテラル値を送信する必要があります。 -
各プロファイルは、最大 50個のキーと値のペア を持つことができ、すべてのキーと値の合計サイズ制限は 2 KB です。 この制限を超えるメタデータは破棄されますが、ライブアクティビティは引き続き配信されます。 レポート目的で必要な情報にペイロードを制限します。
この例では、orderId、tier、restaurantおよびregionは独自の値です。 ライブアクティビティがトリガーされたら、フィードバックデータセットから読み取り、配信を注文レコードにリンクできます。
| code language-json |
|---|
|
ライブアクティビティをデザインしたら、ビルトインのレポートを使用してライブアクティビティの影響の測定を追跡できます。
チュートリアルビデオ
iOS ライブアクティビティを Adobe Journey Optimizer と連携して設定し、iPhone のロック画面と Dynamic Island でリッチなリアルタイム更新を提供する方法について説明します。