コンテンツAPI

Overview

成功したマーケティングキャンペーンのための重要な要素の1つは、キャンペーンの目標が受取人にとって関連性があることです。コンテンツAPIを使用すると、送信時に取得したデータを使用して、推奨やクーポン、その他のパーソナライズAPIから動的にパーソナライズされたキャンペーンを作成できます。

そのようなターゲットを絞った関連性のあるタイムリーなコミュニケーションは、一般的なキャンペーンと比較して、はるかに良いエンゲージメントとコンバージョン率を持つことが証明されています。

以下の例に示すように、ユーザーがフライトを予約すると、Dynamic Content APIを使用して、フライト予約から数時間以内にユーザーの宿泊先の好みを考慮した目的地のホテル宿泊に関するオファーを含むメールを送信できます。

このようなパーソナライズされた関連性の高いメールは、さまざまなシナリオでコンバージョンを促進し、アップセルやクロスセルの機会を開放するために使用できます。

バリのリゾートを探している間に、ユーザーがショッピングカートにホテルの予約を未完了のまま残した別の例を見てみましょう。この場合、ユーザーがカートにアイテム（この場合はホテルの部屋）を追加したウェブサイトは、取引を完了するようにリマインダーのメールをトリガーし、選択できる類似のホテルについての推奨を行います。このようなターゲットを絞った、文脈に応じた、パーソナライズされたメールは、ビジネスを成長させようとするマーケターにとって非常に有用なツールです。

MoEngageのコンテンツAPIを使用する

MoEngageが、上記のユースケース（ホテルの詳細を閲覧しているが予約をしていないユーザー）に対処するために、自動化されたキャンペーンを作成することで、顧客との豊かでパーソナライズされた、タイムリーな会話を実現する方法を見てみましょう。これを行うには、3つのステッププロセスに従う必要があります：

MoEngageにAPIを追加する
APIを使用してパーソナライズされたキャンペーンを作成する
キャンペーンを実行する

info	情報あなたのエンドポイントがVPC内にある場合、または公開されていない場合は、ワークスペースの地域に応じてこれらの MoEngage IPをホワイトリストに追加する必要があります。

ステップ 1 – API URL の追加

MoEngageキャンペーンで使用するAPIを設定するには、コンテンツAPIを追加を参照してください。

ステップ2 - コンテンツAPIを使用してパーソナライズされたキャンペーンを作成する

API URLが保存されると、ユーザーはコンテンツに埋め込まれたAPI呼び出しを使用して、既存のコンテンツテンプレートを利用してキャンペーンを作成できます。これらのキャンペーンには、必要なフォーマット、セグメンテーション、およびトリガースケジュールとともに、さまざまなSKU（この場合はホテル）のプレースホルダーが含まれています。

コンテンツAPIは、次のチャネルを使用して送信されるキャンペーンに追加できます：

コンテンツ API を使用してコンテンツをパーソナライズする方法についての詳細は、こちらを参照してください。

コンテンツAPIの例

マーケティング担当者が特定の地域のユーザーをターゲットにするために、天候に関連する情報を使用したい場合の例を考えてみましょう。以下の例では、eコマース企業のマーケターがロンドン地域でプロモーションしている秋の製品ライン（スカーフ、ブーツ、コートなど）の販売を促進するために、メールキャンペーンを送信したいと考えています。マーケターは、ロンドンの天気情報を取得するコンテンツAPIを使用し、キャンペーン作成時にコンテンツセクションでそれを使用します。

ステップ 1: コンテンツ API を設定する

天気コンテンツAPIを設定する手順は次のとおりです。

コンテンツAPIの設定に移動し、APIを構成します。
以下のAPIを使用して、天気APIを介して天気情報を取得しました。このAPIは、2つのパラメーターを受け取ります。APPID（これは、私たちが使用した天気APIのアプリケーションIDで、サードパーティサイトにホストされています）と都市名です。
- API名: Weather
- API URL: http://samples.openweathermap.org/data/2.5/weather
- API名とURLを入力すると、渡すパラメーターを入力できます。
- この例では、追加されたパラメーターは都市名とAPPIDです。都市名は静的に、APIに渡す都市名を入力することもできますし、または、値のテキストボックスに「@」を入力することでユーザー属性から取得することもできます。
- ユーザーの都市は、キャンペーンを送信する際にパーソナライズを使用して取得されます（ユーザー属性の都市がパーソナライズで選択されると、値のテキストフィールドでは {{UserAttribute['LastKnownCity']}} として表されます）。
- 更新をクリックします。
「 コンテンツ編集API 」ページが開きます。
PIIフィールドをマスクするには、はいを選択し、情報をマスクしたいフィールド名を選択してから、完了を選択します。これで、Content APIの出力からPII値をマスクできます。詳細については、こちらを参照してください。
保存されると、このコンテンツ API はコンテンツ API 検索リストに追加されます。今では、どのキャンペーンのためのコンテンツを作成するために使用できます。

ステップ2：コンテンツAPIをテストする

コンテンツ API 画面の検索リストに作成されたコンテンツ API をクリックします。
行の最後にあるをクリックして テスト オプションを表示します。
クリック テスト。
画面の右下隅にある テスト をクリックします。これにより、設定された ContentAPI にパラメータが渡され、以下に示すように生成されたレスポンスが表示されます。

注: この例では、都市名の静的パラメータを使用して Content API を使用しています。

The JSON response generated for this API is shown below.

"description": "弱い降雨強度"
          }
          ],
          "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
          }

応答には、説明、風速、湿度、温度、視界、天気の説明（この場合は弱い霧雨）が含まれています。このレスポンスはJINJAを使用して解析でき、以下のステップに示すようにコンテンツ作成中に使用できます。

ステップ3：キャンペーン作成中にコンテンツAPIを使用します。

ターゲットセグメントを指定した一回限りのメールキャンペーンを作成し、コンテンツ作成ステップ（キャンペーン作成のステップ2）で次のことを行います。

希望するテンプレートを選択してください。以下の例では、秋のラインの製品推奨が含まれるeコマーステンプレートが選択されています。
テキストエリアに、希望する内容を入力してください。
このメールキャンペーンのために、以下のサンプルテキストを選びました。
天候が悪化しており、今後数日の予報は<add conteAPIapi call and parse the response to get the description detail from the API>です。

自宅の快適な空間から、私たちのお勧め商品をチェックすることができるのに、なぜ買い物に出かける必要があるのでしょうか？
以下のJINJAを使用して、'Weather'という名前のコンテンツAPIを呼び出し、そのレスポンスを解析して天気の説明を取得します。
```
{%set weatherAPI = ContentApi.Weather({ ({"params":{"q":"London,uk","appid":""}, "static_params":{},"dynamic_params":{},"request_body":{}}) }) %}
```
weatherAPI変数は、コンテンツAPIをテストしている間に上記に示されたJSONレスポンスを含むことになります。この応答の説明フィールドにアクセスするには、次のコードを使用してください：
```
{% for weather in weatherAPI.weather %} {{weather.description}} {% endfor %}
```
製品の推奨事項とその他の必要なコンテンツを追加します。エディタの右上隅にある「プレビュー」をクリックします。プレビュー画面が以下のように表示されます。
上部のペインにあるパーソナライズタブをクリックして、以下に示すパーソナライズされたコンテンツを確認してください。
注意: この例ではパーソナライズは追加していません。しかし、コンテンツAPIは実行され、天気情報が取得されてコンテンツに使用されます。以下に示すように、パーソナライズされたユーザー属性がある場合、キャンペーンのために選択されたセグメントから選ばれたランダムなユーザーのために取得されます。詳細についてはパーソナライズをクリックしてください。
次のステップのキャンペーンの配信スケジュールと目標を選択し、キャンペーンを公開します。

FAQs

arrow_drop_down コンテンツAPIには再試行メカニズムがありますか？

コンテンツAPIがAPIタイムアウトのために失敗した場合、MoEngageはリクエストを再試行します。リトライは最大3回まで行われ、APIの最大タイムアウト制限は5秒です。

arrow_drop_down MoEngage キャンペーンはどのようにしてクライアントコンテンツ API を呼び出すのでしょうか?

キャンペーンの総ユーザー数は複数のバッチに分割され、並行して処理されます。これらのバッチの各々では、API コールが順次行われます。
例: 2 つのキャンペーン C1 (目標ユーザーセグメントが 100 万ユーザー) と C2 (目標ユーザーセグメントが 200 万ユーザー) を同時に開始したとします。バッチサイズが 500 の場合、両キャンペーンの総バッチ数は (1M+2M)/500 で、6000 バッチになります。API コールを行うために使用される最大マシン数が 100 で、各マシンに 10 のプロセスがある場合、並行して行われる API コールの数は 1000 になります。各バッチ 500 に対して、コールは順次行われます。しかし、特定の時点で 1000 の API コールを並行して行います。

info	Information バッチサイズと使用中の最大機械数のカウントは、各チャネルごとに異なります。上記の例は、MoEngageがコンテンツAPI呼び出しをどのように行うかを説明するためにのみ使用されています。

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

OAuthを有効にするには、カスタマーサクセスマネージャーまたはMoEngageサポートチームに連絡してください。MoEngage ダッシュボード内の サポートウェブフォーム を通じてチケットを作成できます。詳細については、こちらを参照してください。

arrow_drop_down MoEngageはOAuthのためにトークンにアクセスするためにAPIを呼び出すことができますか？

Auth Token サービスは、認可コードグラントタイプおよびクライアント資格情報グラントタイプの API をサポートしています。
詳細については、アプリケーショングラントタイプを参照してください。

arrow_drop_down トークンのタイムアウトを管理する方法は？

上記で使用されるAPIは、レスポンス内のトークンの有効期限を持っている必要があります。この有効期限は、秒、分、時間、または正確なエポックタイムスタンプで指定できます。

MoEngageサポートチームに連絡するには、MoEngageダッシュボード内の サポートウェブフォーム を通じてチケットを提出できます。詳細については、こちらを参照してください。