Adobe Campaign Standard のユースケースをサポートするタグルールの設定 configuring-rules-launch

データ収集UIで、データ要素とルールを作成して、モバイルアプリケーションからAdobe Campaign StandardにPIIやその他のデータを送信します。

データ収集UIのすべての設定変更を有効にするには、これらの変更を公開する必要があります。 詳しくは、公開を参照してください。

データ収集UIでルールを作成するには、次の手順に従います。

データ要素の作成 create-data-elements

データ収集UIで作成することをお勧めするデータ要素は次のとおりです。
必要に応じて、データ要素を追加できます。

  • Experience Cloud ID
  • Pkey
  • Campaign server

これらのデータ要素を作成するには:

  1. データ収集UIで、モバイルアプリケーションダッシュボードから「Data Elements」タブをクリックします。

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

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

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

  5. キーデータ要素を作成するには、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 ​です。

ルールの作成 creating-rules

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

PII ポストバック pii-postback

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

PII データをAdobe Campaign Standardに送信するには、データ収集UIでルールを作成します。

  1. データ収集UIで、モバイルアプリケーションダッシュボードから「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を入力します。

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
    
  9. Add Post Body」チェックボックスをオンにします。

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

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

    marketingCloudIdを使用すると、アプリのサブスクライバーとデータベース内の受信者を紐付けることができます。そのため、必要になります。 ビジネスニーズに応じて、他のキーと値のペアを指定できます。 上記の例では、Email、First Name、Last Nameがアプリから渡されています。

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

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

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

    データ収集UIで定義されるデータ要素は、例えば%%mcid%%のように2つのパーセンテージで囲み、アプリのコンテキスト変数は%contextdata.email%のように1つのパーセンテージで囲む必要があります。

  11. Content Type​に「application/json」と入力します。

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

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

アプリ内トラッキングのポストバック inapp-tracking-postback

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

ユーザーがモバイルアプリケーションでアプリ内メッセージをどのように操作しているかをレポートするためにトラッキングデータをAdobe Campaign Standardに送信するには、データ収集UIに次のルールを作成します。

  1. データ収集UIで、モバイルアプリケーションダッシュボードから「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を入力します。

    code language-none
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
    
  9. Add post body」チェックボックスをオンにします。

  10. Post Body​に「{}」と入力します。

  11. Content Type​に「application/json」と入力します。

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

プッシュ通知の追跡ポストバック push-tracking-postback

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

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

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

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

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

  2. 名前を入力します。例:Adobe Campaign - プッシュクリックトラッキング

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

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

  5. Action ドロップダウンから、Action​を選択し、equals​を選択して、トラッキング​と入力します。

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

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

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

    code language-none
    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」を選択します。

場所のポストバック location-postback

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

  2. 名前を入力します。例:場所ポストバック

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

  4. イベントを作成します。例えば、「POI」または「POIを終了」と入力します。 Extension ドロップダウンから、場所 – Beta​を選択します。 次に、Event type ドロップダウンで​ POI ​または​ POI ​を終了します。

  5. 例えば、Places - Beta - Enter POI​または​ Exit POI ​という名前を入力します。

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

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

  8. 名前を入力します(例:Mobile Core - Send Location Postback)。

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

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
    
  10. Add post body」チェックボックスを選択し、投稿本文を追加します。例:

    code language-none
    {
    "locationData": {
        "distances": "{%%Distance%%}",
        "poiLabel": "{%%POILabel%%}",
        "latitude": "{%%Latitude%%}",
        "longitude": "{%%Longitude%%}",
        "appId": "{%%AppId%%}",
        "marketingCloudId": "{%%ECID%%}"
    }
    }
    
    note
    NOTE
    上記の例では、右側のデータ要素は、​ データ要素の作成の手順を利用して、データ収集UIで設定する必要があります。 左側のデータ要素はAdobe Campaign Standardでサポートされており、設定は必要ありません。 追加のデータが必要な場合は、Adobe Campaign Standardでカスタムリソース拡張機能を実行する必要があります。
  11. Content Type​に「application/json」と入力します。

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

recommendation-more-help
campaign-standard-help