Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

Salesforce Marketing Cloud で META WhatsApp 統合に AMPscript を使用する方法

公開日: Jan 23, 2025
説明

この記事では、Marketing Cloud 内で WhatsApp テンプレートメッセージとセッションメッセージに AMPscript を使用する方法について詳しく説明します。META で WhatsApp テンプレートメッセージを作成および承認する方法について説明し、Variable 1 項目で動的変数のマスタッシュ構文と AMPscript を使用してデータを挿入する方法について詳しく説明します。

さらに、受信チャットのエントリソースがあるジャーニーでのシステムデータエクステンションの役割についても説明します。連絡先が新規か、それともアクティブかを識別するための AMPscript ロジックの重要性を強調しています。このガイドでは、連絡先データを管理するために、更新された Master WhatsApp Subscription データエクステンションを維持することを提案しています。

最後に、連絡先データまたはデフォルト値に基づいてメッセージをパーソナル化するための AMPscript ブロックの例を示します。このガイドの目的は、マーケターが Marketing Cloud で AMPscript を効果的に使用して WhatsApp メッセージをパーソナル化できるようにすることです。

 

: Marketing Cloud 内で WhatsApp テンプレートメッセージとセッションメッセージに AMPscript を効果的に使用できるよう、徹底的なテストが行われています。ただし、プロセスを各自の環境に実装する前に、また実装した後にも、すべてのプロセスの機能をユーザが厳格にテストおよび検証することを強くお勧めします。プロセスの途中で問題が発生した場合、トラブルシューティングを容易にするためにソリューションを無効にすることが必要になる可能性があります。パーソナル化されたメッセージによって顧客体験が損なわれるのではなく強化されるよう、このプロセスの間、常に顧客の満足を優先し、顧客の好みを尊重してください。

解決策

WhatsApp テンプレートメッセージとセッションメッセージでの AMPscript の利用

 

パート 1: WhatsApp テンプレートメッセージでの AMPscript の使用

ステップ 1: テンプレートメッセージの作成

最初に、META でテンプレートメッセージを作成します。本文項目では、マスタッシュ構文を使用して変数を呼び出します。次に例を示します。
 

こんにちは。これがあなたのコード {{1}} です。素敵な一日をお楽しみください。


上記のメッセージでは、{{1}} を使用して、データエクステンションから取得した顧客ごとに一意のコードを挿入します。変数を入力すると、各変数のサンプルデータを提供するよう UI から求められます。{{2}}{{3}}{{4}} のようにマスタッシュ構文の数字を 1 ずつ大きくして、テキストメッセージにさらに変数を追加できます。%%CODE%%{{1}} のプレースホルダーサンプルとして使用して、挿入するデータの種類を指定します。
 

ステップ 2: テンプレートメッセージの送信

メッセージの詳細を入力したら、承認のためにテンプレートを送信します。
 

ステップ 3: チャットメッセージテンプレートの作成

承認されたら、Content Builder に移動して、新規チャットメッセージのテンプレートメッセージを作成します。承認済みのテンプレートを選択し、メッセージの優先言語を選択します。次のようになります。
 

こんにちは。これがあなたのコード ${1} です。素敵な一日をお楽しみください。


ステップ 4: AMPscript の挿入

最後に、目的の AMPscript を Variable 1 項目に挿入します。たとえば、次のようにします。
 

%%[ 
var @code, @contactkey
set @contactkey = [contactkey]
set @code = Lookup('Stored_Codes','code','CONTACT_KEY',@contactkey) 
]%%
%=v(@code)=%%


注: v() 関数は変数ごとに 1 つしか表示できません。Variable 1 がある位置に複数のソースからのデータを表示する必要がある場合は、concat() 関数を使用します。次のようにします。
 

%%[
var @firstName, @lastName, @fullName, @contactKey
set @contactKey = [contactKey]
set @firstName = Lookup('Contact_Data1','First_Name','Contact_Key',@contactKey)
set @lastName = Lookup('Contact_Data2','Last_Name','Contact_Key',@contactKey)
et @fullName = concat(@firstName, ' ', @lastName)
]%%
%%=v(@fullName)=%%


パート 2: WhatsApp セッションメッセージでの AMPscript の使用

 

メッセージタイプについて

セッションメッセージの作成中、TEXT タイプまたは MEDIA タイプを選択できます。AMPscript を使用する場合は、TEXT タイプを選択します。
 

システムデータエクステンションについて

受信チャットのエントリソースを使用してジャーニーを設定すると、次の属性を備えたデータエクステンションがシステムによって自動的に作成されます。

  • ContactKey
  • MobileNumber
  • ChannelType
  • ChannelId
  • Keyword

 

AMPscript ロジックの実装

Master WhatsApp Subscription データエクステンションを維持することをお勧めします。この拡張機能は 1 時間ごとに更新され、最新のアクティブな WhatsApp 連絡先とその個人データを保持します。AMPscript ロジックの実装例を次に示します。
 

%%[ 
/* システムデータエクステンションから携帯電話番号を取得 */
SET @mobile= AttributeValue("mobilenumber") 
/* 携帯電話番号が Master WhatsApp Subscription データエクステンションに存在するかどうかをチェック */
SET @row = LookupRows("MasterWhatsAppSubscription", "phone", @mobile) 
/* 携帯電話番号が見つかった場合、名前と国の項目を取得 */
IF RowCount(@row) > 0 THEN SET @row = Row(@row, 1)
SET @name = Field(@row, "Name") 
SET @country = Field(@row, "Country") 
ELSE /* ContactKey が見つからない場合、何らかのデフォルト値を設定 */
SET @name = "there" 
SET @country = "unknown"
ENDIF 
/* パーソナル化されたセッションメッセージの作成方法 */
SET @message = Concat("Hi, ", @name, ". We have some great deals in ", @country, " today.") 
]%% 
%%=v(@message)=%%
 

このスクリプトは、Master WhatsApp Subscription データエクステンションの電話列を検索します。電話番号が見つかった場合、名前と国を取得します。見つからない場合、デフォルト値を設定します。次に、これらの値を使用してパーソナル化したメッセージを作成します。
 

このガイドで説明した手順を理解して実装することで、AMPscript を利用して WhatsApp メッセージのパーソナル化を強化し、より良い体験を顧客に提供することができます。

ナレッジ記事番号

000395692

 
読み込み中
Salesforce Help | Article