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。
-
キーデータ要素を作成するには、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 タイプ ドロップダウンの Campaign Server です。
ルールの作成 creating-rules
次のルールを作成する必要があります。
PII ポストバック pii-postback
PII データをAdobe Campaign Standardに送信するには、データ収集UIでルールを作成します。
-
データ収集UIで、モバイルアプリケーションダッシュボードから「Rules」タブをクリックし、「Create New Rule」をクリックします。
-
名前を入力します。例:Mobile Core - Collect 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を使用すると、アプリのサブスクライバーとデータベース内の受信者を紐付けることができます。そのため、必要になります。 ビジネスニーズに応じて、他のキーと値のペアを指定できます。 上記の例では、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つのパーセンテージで囲む必要があります。 -
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」をクリックします。
-
名前を入力します。例:場所ポストバック。
-
Events セクションで、Addをクリックします。
-
イベントを作成します。例えば、「POI」または「POIを終了」と入力します。 Extension ドロップダウンから、場所 – Betaを選択します。 次に、Event type ドロップダウンで POI または POI を終了します。
-
例えば、Places - Beta - Enter POIまたは Exit POI という名前を入力します。
-
Actions セクションで、Addをクリックします。
-
Extension ドロップダウンから、Mobile Coreを選択します。 次に、Action type ドロップダウンからSend postback。
-
名前を入力します(例:Mobile Core - Send Location Postback)。
-
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 上記の例では、右側のデータ要素は、 データ要素の作成の手順を利用して、データ収集UIで設定する必要があります。 左側のデータ要素はAdobe Campaign Standardでサポートされており、設定は必要ありません。 追加のデータが必要な場合は、Adobe Campaign Standardでカスタムリソース拡張機能を実行する必要があります。 -
Content Typeに「application/json」と入力します。
-
Timeoutで、「5」を選択します。