​

概要

Content APIs を使用すると、高度にパーソナライズされたマーケティングキャンペーンを作成できます。Content APIs は、メッセージが送信される瞬間に、商品のおすすめ、クーポン、ユーザーの好みなどの動的データを取得します。これにより、各受信者は自分専用にカスタマイズされたコンテンツを受け取ることができ、一般的なキャンペーンと比べてエンゲージメント率とコンバージョン率が大幅に向上します。マーケターやプロダクトマネージャーは、Content APIs を使用してタイムリーで関連性の高いメッセージを配信し、カスタマーエクスペリエンスを向上させています。 たとえば、ユーザーがフライトを予約した場合、Dynamic Content APIs を使用して、フライト予約から数時間以内に目的地のホテル宿泊オファーを記載したメールを送信できます。API ではユーザーの宿泊の好みを考慮できます。 このようなターゲットを絞った、関連性の高いタイムリーなコミュニケーションは、コンバージョンを促進し、アップセルやクロスセルの機会を見つけるのに役立ちます。 ユーザーがショッピングカートに商品 (バリのホテルの部屋など) を追加したものの購入を完了しなかった場合、Content API によってメールをトリガーできます。このメールで取引の完了を促し、類似のホテルをおすすめします。このようなターゲットを絞った、文脈に沿ったパーソナライズされたメールは、ビジネスの成長を目指すマーケターにとって非常に便利なツールです。

​

始める前に

Content APIs を効果的に使用するには、以下を満たしていることを確認してください。

• API とその仕組みに関する基本的な理解 (開発チームと協力することもできます)。
• MoEngage でのキャンペーン作成に関する知識。
• 高度なコンテンツパーソナライゼーションのための JINJA テンプレート言語に関する知識。

​

MoEngage で Content APIs を使用する

MoEngage は、リッチでパーソナライズされたタイムリーなメッセージを顧客に配信するのに役立ちます。キャンペーンで Content APIs を使用する一般的な手順は次のとおりです。

1. MoEngage で外部 API を設定します (技術的なステップ)。
2. API で取得したデータを使用してパーソナライズされたキャンペーンを作成します (マーケティングのステップ)。
3. キャンペーンを実行してモニタリングします。

​

ステップ 1: Content API を追加する

MoEngage キャンペーンで使用する API を設定するには、Content API を追加するを参照してください。 注: Content APIs を使用したキャンペーンのパーソナライズはマーケターにとって強力なツールですが、MoEngage 内でのこれらの API の初期設定には技術的な詳細が伴うことがよくあります。API を設定するには、開発チームとの協力が必要になる場合があります。API が設定されると、マーケターは Jinja を使用して、取得したデータをキャンペーンで活用できます。

​

ステップ 2: キャンペーンで Content APIs を使用する

技術チームが Content API を設定してテストしたら、コンテンツ内に API 呼び出しが埋め込まれた既存のコンテンツテンプレートを使用してキャンペーンの作成を開始できます。これらのキャンペーンには、必要な書式設定、セグメンテーション、トリガースケジュールとともに、さまざまな SKU (この場合はホテル) のプレースホルダーを含めることができます。API から取得したデータをキャンペーンメッセージに挿入するには、Jinja テンプレート言語を使用します。 Content APIs は、次のチャネルを使用して送信されるキャンペーンに追加できます。

• Push (Mobile Push および Web Push)
• Email
• SMS
• On-Site Messaging
• In-App
• WhatsApp
• Connectors

Content APIs を使用したコンテンツのパーソナライズ (つまり、取得したデータで Jinja を使用する方法) の詳細については、Content APIs を使用してコンテンツをパーソナライズするを参照してください。

​

Content API の例

マーケターが、メールキャンペーンで特定の地域のユーザーをターゲットにするために、天気関連の情報を使用したいと考えているとします。以下の例では、E コマース企業のマーケターが、ロンドンでプロモーションを行っている秋物商品 (スカーフ、ブーツ、コートなど) の売上を、メールキャンペーンの送信によって伸ばしたいと考えています。マーケターは、ロンドンの天気情報を取得する Content API を利用し、キャンペーン作成時にコンテンツセクションに組み込みます。

​

ステップ 1: サンプルの Content API を設定する

この天気の例を含め、Content API を設定するには、MoEngage が外部ソースに接続してデータをリクエストする方法を指定する必要があります。そのためには、エンドポイント、必要なパラメーター (API キーや位置識別子など)、返されるデータの構造に関する外部 API のドキュメントを理解する必要があります。 注: この例では MoEngage での設定手順を説明していますが、通常は開発者または技術チームのメンバーがこの設定を担当し、外部 API (この場合は OpenWeatherMap) のすべての技術要件が満たされるようにします。 MoEngage 内で Content API を設定するには、次の手順を実行します。

1. MoEngage UI の左側のナビゲーションメニューで、Settings > Advanced Settings > Content API に移動します。
2. 右上隅の + Add content API をクリックします。Add content API ペインが表示されます。
3. ステップ 1 の Add details で、API を設定します。
   ここでは、天気 API を使用して天気の詳細を取得する次の API を使用しています。この API は、APPID (使用している天気 API のアプリケーション ID で、サードパーティのサイトでホストされています) と都市名の 2 つのパラメーターを受け取ります。
   1. API name: API の名前を入力します。例: Weather。
   2. Method: メソッドを選択します。
   3. Url: API の URL を入力します。例: http://samples.openweathermap.org/data/2.5/weather
      注: これはサンプル URL です。ライブデータを使用する場合は、本番環境の OpenWeatherMap エンドポイントを使用してください。
   4. 渡すパラメーターを入力します。
      • この例では、追加するパラメーターは都市名 (OpenWeatherMap の場合は q) と APPID (appid) です。都市名は静的な値 (例: “London,uk”) にすることも、Value テキストボックスに ’@’ を入力して属性を選択することで、ユーザー属性からパーソナライズして取得することもできます。
      • ユーザーの都市は、キャンペーン送信時にパーソナライゼーションを使用して取得されます (パーソナライゼーションを使用してユーザー属性 city を選択すると、値のテキストフィールドには {{UserAttribute['LastKnownCity']}} と表示されます)。
4. Save をクリックします。ステップ 2 の API response に移動します。
5. Mask PII fields で Yes を選択します。
   MoEngage のログや UI に表示される API レスポンスの PII フィールドをマスクするには、PII マスキングで Yes を選択し、情報をマスクしたいフィールド名を選択します。Content API の出力から PII 値をマスクできるようになりました。詳細については、こちらを参照してください。
6. Done をクリックします。Content API が保存されると、Content API の検索リストに追加されます。これで、任意のキャンペーンのコンテンツ作成に使用できるようになります。

​

ステップ 2: Content API をテストする

Content API をテストして、正しいデータを取得できることを確認します。

1. Content API ページで、Content API 画面の検索リストから作成した Content API (例: “Weather”) をクリックします。
2. 行末の省略記号アイコン をクリックし、Test をクリックします。
3. Test content API ペインで、パラメーターの値を入力します (例: city には “London,uk”、“appid” には有効な API キー)。
4. 右下隅の Test をクリックします。パラメーターが設定済みの Content API に送信され、生成されたレスポンスが表示されます。 注: この例では、都市名に静的パラメーターを指定して Content API を使用しています。
5. この API の JSON レスポンス (ロンドンについて OpenWeatherMap への呼び出しが成功したと仮定) を以下に示します。
   JSON

   {
   "weather": [
   {
   "description": "light intensity drizzle"
   }
   ],
   "coord": {
   "lat": 51.51,
   "lon": -0.13
   },
   "base": "stations",
   "dt": 1485789600,
   "main": {
   "pressure": 1012,
   "temp_min": 279.15,
   "temp_max": 281.15,
   "temp": 280.32,
   "humidity": 81
   },
   "id": 2643743,
   "wind": {
   "speed": 4.1,
   "deg": 80
   },
   "cod": 200
   }
   

このレスポンスには、説明、風速、湿度、気温などの詳細が含まれています。この例では、天気の説明は “light intensity drizzle” です。このレスポンスを JINJA で解析して、コンテンツ作成に使用できます。

​

ステップ 3: キャンペーンコンテンツで Content API を使用する

1 回限りのメールキャンペーンを作成し、ターゲットセグメントを選択して、コンテンツ作成段階 (キャンペーン作成のステップ 2) で次の手順を実行します。

1. 目的のテンプレートを選択します。この例では、秋物商品のおすすめを含む E コマーステンプレートを選択しました。
2. テキストエリアにコンテンツを入力します。
3. このメールキャンペーンでは、次のサンプルテキストを使用しました。 "The weather is inclement and the forecast for the next few days is <add content API call and parse the response to get the description detail from the API>. Why venture out for shopping when you can take a look at our top picks for you from the cozy confines of your home?”
4. 次の JINJA コードを使用して、‘Weather’ Content API を呼び出します。
   {%set weatherAPI = ContentApi.Weather({ ({"params":{"q":"London,uk","appid":""}, "static_params":{},"dynamic_params":{},"request_body":{}}) }) %}
   
   この JINJA コードは、Content API からの JSON レスポンスを weatherAPI 変数に割り当てます。
5. weatherAPI 変数から天気の説明を抽出するには、次の JINJA コードを使用します。
   {% for weather in weatherAPI.weather %} {{weather.description}} {% endfor %}
   
   このコードは、JSON レスポンスの “weather” 配列を反復処理し、“description” フィールドを出力します。
6. 商品のおすすめやその他の必要なコンテンツを追加します。エディターの右上隅にある Preview をクリックします。プレビュー画面が開きます。
7. 上部のペインで Personalized タブをクリックすると、パーソナライズされたコンテンツが表示されます。
   注: この例では、ユーザー固有のパーソナライゼーションは追加していません。ただし、以下に示すように、Content API が実行され、天気情報が取得されてコンテンツで使用されます。ユーザー属性をパーソナライズした場合、それらは選択したキャンペーンセグメントからランダムに選ばれたユーザーについて取得されます。詳細については、パーソナライゼーションの概要を参照してください。
8. キャンペーンの次のステップで配信スケジュールと目標を選択し、キャンペーンを公開します。

​

よくある質問

Content APIs にはリトライメカニズムがありますか？

はい。Content API の呼び出しがタイムアウトにより失敗した場合、MoEngage はリクエストを最大 3 回リトライします。API のタイムアウト上限は最大 5 秒です。

MoEngage キャンペーンはクライアントの Content APIs をどのように呼び出しますか？

MoEngage は、キャンペーン内のユーザー総数を複数のバッチに分割し、それらを並列に処理します。各バッチ内では、API 呼び出しは順次行われます。例: C1 (100 万ユーザー) と C2 (200 万ユーザー) の 2 つのキャンペーンが同時に開始されるとします。バッチサイズが 500 の場合、両方のキャンペーンのバッチ総数は (1M + 2M) / 500 = 6000 バッチです。API 呼び出しに 100 台のマシンを使用し、各マシンに 10 個のプロセスがある場合、1000 件の API 呼び出しを並列に送信できます。500 件の各バッチの呼び出しは順次行われますが、常に 1000 件の API 呼び出しが並列に実行されます。注: バッチサイズと使用されるマシンの最大数はチャネルによって異なります。この例は、MoEngage が Content API 呼び出しを行う仕組みを示すものであり、チャネルの制限を規定するものではありません。

Content APIs で OAuth を有効にするにはどうすればよいですか？

OAuth を有効にするには、カスタマーサクセスマネージャーまたは MoEngage サポートチームにお問い合わせください。

MoEngage は OAuth のトークンを取得するために任意の API を呼び出せますか？

Auth Token サービスは、Authorization Code グラントタイプと Client Credential グラントタイプの API をサポートしています。詳細については、Application Grant Types を参照してください。

トークンのタイムアウトはどのように管理しますか？

認証に使用する API は、レスポンスにトークンの有効期限を含める必要があります。この有効期限は、秒、分、時間、または正確なエポックタイムスタンプで指定できます。MoEngage はこの情報を使用して、トークンの更新を自動的に管理します。

さらにサポートが必要な場合は、MoEngage のカスタマーサクセスマネージャー (CSM) またはサポートチームにお問い合わせください。