Adobe Campaign Standard のユースケースをサポートするための Launch ルールの設定

Adobe Experience Platform Launch で、PII やその他のデータをモバイルアプリケーションから Adobe Campaign Standard に送信するためのデータ要素とルールを作成します。

Adobe Experience Platform Launch 内のすべての設定変更を有効にするには、これらの変更を公開する必要があります。 詳しくは、 公開 を参照してください。

Experience Platform Launch でルールを作成するには、次の手順に従います。

  1. データ要素の作成
  2. サポート するユースケースのルールの作成：

データ要素の作成

Experience Platform Launch で作成することをお勧めするデータ要素を次に示します。
必要に応じて、追加のデータ要素を作成できます。

  • Experience Cloud ID
  • Pkey
  • Campaign server

次のデータ要素を作成するには：

  1. Experience Platform Launch のモバイルアプリケーションダッシュボードで、「Data Elements」タブをクリックします。

  2. Experience Cloud ID データ要素を作成するには、Create New Data Element をクリックします。

  3. Name フィールドに、例えば mcid と入力します。

  4. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Data element タイプのドロップダウンで Experience Cloud ID を入力します。

  5. Pkey データ要素を作成するには、Add data element をクリックします。

  6. Name フィールドに、例えば pkey と入力します。

  7. 「Extension」ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、Data element タイプのドロップダウンで pkey を入力します。

  8. Campaign サーバーのデータ要素を作成するには、Add data element をクリックします。

  9. Name フィールドに名前を入力します（例：camp-server）。

  10. 「Extension」ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、Data element タイプのドロップダウンで Campaign Server を指定します。

ルールの作成

次のルールを作成する必要があります。

PII ポストバック

メモ

モバイルアプリからAdobe Campaignに PII 情報を送信するには、SDK API を実装する必要があります。 詳しくは、CollectPII を参照してください。

PII データを Adobe Campaign Standard に送信するには、Experience Platform Launch にルールを作成します。

  1. Experience Platform Launch で、モバイルアプリケーションダッシュボードから「Rules」タブをクリックし、「Create New Rule」をクリックします。

  2. 名前を入力します（例：Mobile Core - Collect PII）。

  3. Events セクションで、Add をクリックします。

  4. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Event type ドロップダウンで Collect PII を選択します。

  5. 「Keep changes」をクリックします。

  6. Actions セクションで、Add をクリックします。

  7. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Action type ドロップダウンで Send PII を選択します。

  8. URL に、次の URL を入力します。

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  9. Add Post Body チェックボックスをオンにします。

  10. Post Body に、次のように入力します。

    {
"marketingCloudId":
"{%%mcid%%}",
"pushPlatform":
"{%contextdata.pushPlatform%}",
"cusEmail":
"{%contextdata.email%}",
"cusFirstName":
"{%contextdata.firstName%}",
"cusLastName":
"{%contextdata.lastName%}" }

    marketingCloudId を使用すると、アプリの購読者とデータベース内の受信者を紐付けでき、その結果、が必要になります。 ビジネスのニーズに応じて、他のキーと値のペアを指定できます。 上記の例では、アプリから電子メール、名、姓が渡されています。

    キー（例えば、cusEmail、cusFirstName、cusLastName）は、Adobe Campaign Standardインスタンスのカスタムリソースで定義されたフィールド ID と一致する必要があります。 値の変数（email、firstName、LastName など）は、アプリコードから AMS collectPII API を呼び出す際にモバイルアプリから送信される JSON データのキーと一致する必要があります。

    また、ライフサイクルデータを、イベントデータに応じて PII ポストバックを収集または別のポストバックに渡すこともできます。トリガー ライフサイクルデータ JSON の例を次に示します。

    {
"marketingCloudId":"{%%mcid%%}",
"pushPlatform":"{%contextdata.pushPlatform%}",
"cusDayslastlaunch": "{%%DaysSinceLastUse%%}", 
"cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}", 
"cusLaunches": "{%%Launches%%}"
}

    Experience Platform Launch で定義するデータ要素は、%%mcid%%のように 2 倍の割合で囲み、アプリのコンテキスト変数は%contextdata.email%のように 1 つの割合で囲む必要があります。

  11. Content Type で、application/json と入力します。

  12. Timeout で、「0」を選択します。

これで、ユーザーデータが Campaign に送信されるように設定されました。

アプリ内トラッキングポストバック

メモ

Android ACPCore v1.4.0 以降または iOS ACPCore v2.3.0 以降を使用している場合、トラッキングポストバックを設定する必要はありません。

モバイルアプリケーションでユーザーがアプリ内メッセージとどのようにやり取りするかを報告するために、Adobe Campaign Standard にトラッキングデータを送信するには、Experience Platform Launch で次のルールを作成します。

  1. Experience Platform Launch で、モバイルアプリケーションダッシュボードから「Rules」タブを選択し、「Add Rule」をクリックします。

  2. 名前を入力します ( 例：Adobe Campaign — アプリ内クリック追跡)。

  3. Events セクションで、Add をクリックします。

  4. 「Extension」ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、Event type ドロップダウンで In-App click tracking を選択します。

  5. 「Keep changes」をクリックします。

  6. Actions セクションで、Add をクリックします。

  7. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Event type ドロップダウンで Send postback を選択します。

  8. URL に、次の URL を入力します。

    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  9. Add post body チェックボックスをオンにします。

  10. Post Body に、{} と入力します。

  11. Content Type で、application/json と入力します。

  12. Timeout で、「0」を選択します。

プッシュ通知トラッキングポストバック

メモ

Android ACPCore v1.4.0 以降または iOS ACPCore v2.3.0 以降を使用している場合、トラッキングポストバックを設定する必要はありません。

プッシュ通知配信とユーザーのモバイルアプリケーションとのやり取りを追跡するのに役立つトラッキングデータを Adobe Campaign Standard に送信するには、Experience Platform Launch にルールを作成する必要があります。

プッシュトラッキングについて詳しくは、 プッシュトラッキング を参照してください。

アプリのアクションを追跡するには、 trackAction API を使用します。 詳しくは、 アプリのアクションの追跡 を参照してください。

  1. Experience Platform Launch のモバイルアプリケーションダッシュボードで、「Rules」タブをクリックし、「Add Rule」をクリックします。

  2. 名前を入力します ( 例：Adobe Campaign — プッシュクリック追跡)。

  3. Events セクションで、Add をクリックします。

  4. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Event type ドロップダウンで Track Action を選択します。

  5. 「Action」ドロップダウンから「Action」を選択し、「equals」を選択して、「tracking」と入力します。

  6. 「Keep changes」をクリックします。次に、「Actions」セクションで「Add」をクリックします。

  7. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Action type ドロップダウンで Send postback を選択します。

  8. URL に、次の URL を入力します。

    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  9. Add post body チェックボックスをオンにします。

  10. 投稿の本文を追加します（例： { } ）。

  11. Content Type で、application/json と入力します。

  12. Timeout で、「0」を選択します。

場所ポストバック

  1. Experience Platform Launch のモバイルアプリケーションダッシュボードで、「Rules」タブをクリックし、「Add Rule」をクリックします。

  2. 名前を入力します（例：Location postback）。

  3. Events セクションで、Add をクリックします。

  4. イベント（「POI を入力」や「POI を終了」など）を作成します。 「Extension」ドロップダウンから「Places - Beta」を選択します。 次に、​Event type​ドロップダウンに POI または 出口 POI と入力します。

  5. 名前を入力します（例： Places - Beta - POI または Exit POI）。

  6. Actions セクションで、Add をクリックします。

  7. 「Extension」ドロップダウンから「Mobile Core」を選択します。 次に、Action type ドロップダウンから Send postback を選択します。

  8. 名前を入力します（例：Mobile Core - Send Location Postback）。

  9. URL に、次の URL を入力します。

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  10. 「Add post body」チェックボックスを選択して、次のように投稿本文を追加します。

    {
"locationData": {
    "distances": "{%%Distance%%}",
    "poiLabel": "{%%POILabel%%}",
    "latitude": "{%%Latitude%%}",
    "longitude": "{%%Longitude%%}",
    "appId": "{%%AppId%%}",
    "marketingCloudId": "{%%ECID%%}"
}
}
    メモ

    上記の例では、 データ要素の作成 の手順を利用して、右側のデータ要素を Experience Platform Launch で設定する必要があります。 左側のデータ要素は Adobe Campaign Standard でサポートされており、設定は不要です。 追加のデータが必要な場合は、Adobe Campaign Standard でカスタムリソース拡張を実行する必要があります。

  11. Content Type で、application/json と入力します。

  12. Timeout で、「5」を選択します。

このページ