Adobe Campaign Standard のユースケースをサポートするタグルールの設定 configuring-rules-launch
データ収集 UI で、データ要素とルールを作成して、モバイルアプリケーションから Adobe Campaign Standard に PII やその他のデータを送信します。
データ収集 UI のすべての設定変更を有効にするには、これらの変更を公開する必要があります。 詳しくは、「 公開」を参照してください。
データ収集 UI でルールを作成するには、次の手順に従います。
-
ルールの作成:サポートを必要とするユースケースに対応
データ要素の作成 create-data-elements
データ収集 UI で作成することをお勧めするデータ要素は次のとおりです。
必要に応じて、追加のデータ要素を作成できます。
- Experience Cloud ID
- Pkey
- Campaign server
これらのデータ要素を作成するには:
-
データ収集 UI で、モバイルアプリケーションダッシュボードから「Data Elements」タブをクリックします。
-
Experience Cloud ID データ要素を作成するには、「Create New Data Element」をクリックします。
-
例えば、「Name」フィールドに mcid と入力します。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、Data element のタイプ ドロップダウンで Experience Cloud ID をクリックします。
-
Pkey データ要素を作成するには、[Add data element] をクリックします。
-
例えば、「Name」フィールドに「pkey」と入力します。
-
Extension ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、Data element のタイプ ドロップダウンで pkey をクリックします。
-
Campaign サーバーデータ要素を作成するには、「Add data element」をクリックします。
-
Name フィールドに名前(例:camp-server)を入力します。
-
Extension ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、「Data element type」ドロップダウンに Campaign Server 力します。
ルールの作成 creating-rules
次のルールを作成する必要があります。
PII ポストバック pii-postback
PII データを Adobe Campaign Standard に送信するには、データ収集 UI でルールを作成します。
-
データ収集 UI のモバイルアプリケーションダッシュボードで、「Rules」タブをクリックし、Create New Rule をクリックします。
-
名前(例:Mobile Core - PII を収集 を入力します。
-
「Events」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Event type」ドロップダウンに Collect PII 力します。
-
「Keep changes」をクリックします。
-
「Actions」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Action type」ドロップダウンに Send PII 力します。
-
URL で、次の URL を入力します。
code language-none https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
-
「Add Post Body」チェックボックスをオンにします。
-
Post Body に、次のように入力します。
code language-none { "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 の例を次に示します。
code language-none { "marketingCloudId":"{%%mcid%%}", "pushPlatform":"{%contextdata.pushPlatform%}", "cusDayslastlaunch": "{%%DaysSinceLastUse%%}", "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}", "cusLaunches": "{%%Launches%%}" }
データ収集 UI で定義するデータ要素は
%%mcid%%
のように二重の割合で囲む必要があり、アプリのコンテキスト変数は %contextdata.email% のように単一の割合で囲む必要があります。 -
Content Type に application/json と入力します。
-
Timeout で、0 を選択します。
これで、Campaign に送信するようにユーザーデータが設定されました。
アプリ内トラッキングのポストバック inapp-tracking-postback
トラッキングデータを Adobe Campaign Standard に送信して、ユーザーがモバイルアプリケーションのアプリ内メッセージとやり取りする方法をレポートするには、データ収集 UI で次のルールを作成します。
-
データ収集 UI で、モバイルアプリケーションダッシュボードから「Rules」タブを選択し、「Add Rule」をクリックします。
-
名前(例:Adobe Campaign - アプリ内クリックの追跡)を入力します。
-
「Events」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Adobe Campaign Standard」を選択します。 次に、「Event type」ドロップダウンに In-App click tracking 力します。
-
「Keep changes」をクリックします。
-
「Actions」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Event type」ドロップダウンに Send postback 力します。
-
URL に、次の URL を入力します。
code language-none https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
-
「Add post body」チェックボックスをオンにします。
-
Post Body に {} と入力します。
-
Content Type に application/json と入力します。
-
Timeout で、0 を選択します。
ポストバックを追跡するプッシュ通知 push-tracking-postback
プッシュ通知配信とモバイルアプリケーションとのユーザーのインタラクションを追跡するのに役立つトラッキングデータを Adobe Campaign Standard に送信するには、データ収集 UI でルールを作成する必要があります。
プッシュトラッキングについて詳しくは、 プッシュトラッキングを参照してください。
アプリのアクションを追跡するには、trackAction API を使用します。 詳しくは、「 アプリのアクションのトラッキング」を参照してください。
-
データ収集 UI で、モバイルアプリケーションダッシュボードから「Rules」タブをクリックし、「Add Rule」をクリックします。
-
名前(例:Adobe Campaign - プッシュクリックの追跡)を入力します。
-
「Events」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Event type」ドロップダウンに Track Action 力します。
-
Action ドロップダウンから「Action」を選択し、「equals」を選択して トラッキング と入力します。
-
「Keep changes」をクリックします。次に、[Actions] セクションの [Add] をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Action type」ドロップダウンに Send postback 力します。
-
URL で、次の URL を入力します。
code language-none https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}
-
「Add post body」チェックボックスをオンにします。
-
投稿の本文を追加します(例:{ })。
-
Content Type に application/json と入力します。
-
Timeout で、0 を選択します。
場所のポストバック location-postback
-
データ収集 UI で、モバイルアプリケーションダッシュボードから「Rules」タブをクリックし、「Add Rule」をクリックします。
-
名前(例:Location postback)を入力します。
-
「Events」セクションで、「Add」をクリックします。
-
イベント(Enter POI や Exit POI など)を作成します。 Extension ドロップダウンから、「場所 – Beta」を選択します。 次に、POI を入力 または POI を終了 して Event type ださい。
-
名前を入力します(例:場所 – Beta - POI を入力 または POI を終了。
-
「Actions」セクションで、「Add」をクリックします。
-
Extension ドロップダウンから「Mobile Core」を選択します。 次に、「Action type」ドロップダウンから Send postback 力します。
-
名前(例:Mobile Core – 場所のポストバックを送信 を入力します。
-
URL で、次の URL を入力します。
code language-none https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
-
「Add post body」チェックボックスをオンにして、投稿本文を追加します。次に例を示します。
code language-none { "locationData": { "distances": "{%%Distance%%}", "poiLabel": "{%%POILabel%%}", "latitude": "{%%Latitude%%}", "longitude": "{%%Longitude%%}", "appId": "{%%AppId%%}", "marketingCloudId": "{%%ECID%%}" } }
note note NOTE 上記の例では、 データ要素の作成の手順を利用して、右側のデータ要素をデータ収集 UI で設定する必要があります。 左側のデータ要素は Adobe Campaign Standard でサポートされており、設定は必要ありません。 追加のデータが必要な場合は、Adobe Campaign Standard でカスタムリソース拡張を実行する必要があります。 -
Content Type に application/json と入力します。
-
Timeout で、「5」を選択します。