Journey Builder の連絡先の更新アクティビティでのジャーニーデータまたは連絡先データの使用

ジャーニーデータ

ジャーニーデータとは、ジャーニーの開始時にエントリイベントデータエクステンションから取得した連絡先データのスナップショットです。このデータが変更されることはなく、連絡先がジャーニーを進行している間連絡先に保持されます。このデータは次の形式で、連絡先の更新アクティビティに使用できます。

{{Event.EventKey.FieldName}}

API イベントの場合は、エントリイベントの概要ページにイベントキーが指定されます。

API イベントジャーニーのバインド式:

{{Event.APIEvent-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}}

その他のイベントについては、他の方法でイベントキーを検索する必要があります。

注意: データバインド式では大文字小文字が区別されます。データエクステンション項目内の空白文字に注意してください。空白文字が存在するとデータバインドが失敗する可能性があります。

イベントキーの取得

連絡先の更新アクティビティにジャーニーデータの値を使用するよう設定する場合は、次のいずれかの方法でイベントキーを取得する必要があります。

[ジャーニーの設定] の UI を使用する方法

1. 完了を目指すジャーニー内にエントリーイベントを設定します。
2. ジャーニーを保存します。
3. [ジャーニーの設定] ページ (ギアアイコン) に移動します。
4. [デフォルトのメールアドレス] または [デフォルトの携帯番号] に値が入力されている場合は、エントリソースデータエクステンションに適切な項目種別が存在するということであるため、値を右クリックして「検証」します。
5. ブラウザの開発者ツールに、「ul」という短縮形の順不同のリストが表示されます。
6. このリストを開くと、{{Event.DEAudience-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}} のような形式のエントリが表示されます。適切な詳細が見つからない場合は、Ctrl + F キーを使用して、「Event.DE」を検索します。
7. この値が連絡先の更新アクティビティで使用する EventKey であるため、コピーします。

Journey Builder API を使用する方法

1. 完了を目指すジャーニー内にエントリーイベントを設定します。
2. ジャーニーに一意の名前を付けます。
3. ジャーニーを保存します。
4. 「name」のクエリ文字列パラメータを指定して、/interaction/v1/eventDefinitions ルートに GET コールを実行します。
5. 例: GET /interaction/v1/eventDefinitions?name=JourneyBuilderTest
6. 結果から、先ほど作成した特定のジャーニーを探します。
7. eventDefinitionKey 値を見つけたら、後で連絡先の更新アクティビティ設定で使用するためメモしておきます。

対象のジャーニーのイベントキーを取得できたため、次の手順に従って連絡先の更新アクティビティで使用します。 

連絡先の更新アクティビティの設定

1. [連絡先の更新アクティビティ] をキャンバスにドラッグします。
2. データを記録するデータエクステンションを選択します。
3. 更新する属性を選択します。
4. [値] 項目に、データバインド式 (例: {{Event.DEAudience-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}}) を入力します。
5. [サマリー]、[完了] の順にクリックします。
6. ジャーニーの残りの設定を行って有効にします。連絡先がこのアクティビティに達すると、データエクステンションがエントリイベントデータエクステンションの値で更新されます。

連絡先データ

連絡先データとは、特定の連絡先に関連するある時点のデータです。このデータは、Contact Builder のデータデザイナ機能内で設定されます。連絡先の更新アクティビティでこのデータを使用する場合は、次の形式を使用します。

{{Contact.Attribute.DataExtension.FieldName}}

たとえば、「ContactInfo」というデータエクステンションがあり、「Contact Info Attribute Group」という属性グループにリンクされているとします。このデータエクステンションで、「FavoriteColor」という項目を使用して、別のデータエクステンションを更新したいと考えています。次の手順に従って、この作業を実行します。

1. [連絡先の更新アクティビティ] をキャンバスにドラッグします。
2. データを記録するデータエクステンションを選択します。
3. 更新する属性を選択します。
4. [値] 項目に、「{{Contact.Attribute.ContactInfo.FavoriteColor}}」と入力します。
5. [サマリー]、[完了] の順にクリックします。
6. ジャーニーの残りの設定を行って有効にします。連絡先がこのアクティビティに達すると、データエクステンションのその時点の値でターゲットデータエクステンションが更新されます。

注意: データデザイナ内にデータエクステンションへのパスが複数存在する場合は、最短のパスが選択されます。最短のパスが複数ある場合は、任意のパスが選択されます。属性を正常に取得するためには、リンクされているすべてのデータエクステンションに連絡先が存在しなければなりません。このプロセスを簡素化するために、ContactKey に直接リンクされているデータエクステンションのみを使用します。連絡先キーが見つからない場合は、アクティビティによって項目値が空の文字列で更新されます。