Yotpo
Yotpo は大手eコマースマーケティングプラットフォームであり、何千もの先進的なブランドが消費者直販の成長を加速できるよう支援しています。Yotpo のシングルプラットフォームアプローチは、レビュー、ロイヤルティ、SMS マーケティングなどのデータドリブン型のソリューションを統合し、ブランドがよりスマートでコンバージョンの高いカスタマーエクスペリエンスを創造できるようにします。
この統合は Yotpo によって管理されます。
統合について
Brazeと Yotpo の統合により、Braze内のメールやその他のコミュニケーションチャネルで、商品に関する星評価、トップレビュー、視覚的なユーザー生成コンテンツ(UGC)を動的に取得し、表示できます。また、顧客レベルのロイヤルティデータをメールやその他のコミュニケーション手段に組み込むことで、よりパーソナライズされたインタラクションを実現し、売上とロイヤルティを高めることができます。
前提条件
| 必要条件 | 説明 |
|---|---|
| Yotpo アカウント | このパートナーシップを利用するには、Yotpo アカウントが必要です。 |
| Yotpo レビュー API キー | この API は、コネクテッドコンテンツのコードスニペット内に実装されます。 詳細については、Yotpo アプリのキーとシークレットキーの確認方法を参照してください。 |
| Yotpo ロイヤルティ API キー | この API キーとグローバル一意識別子(GUID)は、コネクテッドコンテンツのコードスニペット内に実装されます。 詳細については、ロイヤルティ & リファーラル API キーと GUID の確認方法を参照してください。 |
続行する前に、Yotpo のプロダクト ID が、Brazeから動的に取得されるproduct_idと同じであることを確認してください。これは統合が機能するために必須の作業です。
Yotpo プロダクト ID を確認するには、以下のステップを実行します。
- ストアのWebサイトに移動します。
- 製品ページを開きます。
- 右クリックしてInspectを選択します。
- Control + Fキーを押し、コード内で
yotpo-mainを検索します。data-product ID変数とその値が Yotpo div に表示されます。

統合
Yotpo とBrazeを統合するには、以下のステップを実行します。
- Brazeのダッシュボードに移動します。
- CampaignsページでCreate Campaignをクリックし、Emailを選択します。
- 好みのテンプレートを選択します。
- Edit email bodyをクリックし、ユースケースに応じたコネクテッドコンテンツのスニペットを追加します。
商品の星評価とレビュー数を表示する
このスニペットを使って、メールに含まれる商品の公開平均スコアとレビュー総数を提供します。
1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/products/<YOTPO-API-KEY>/{{event_properties.${product_id}}}/bottomline :save result %}
{% if {{result.response.bottomline.average_score}} != 0 %}
The average rating for this product is:
{{result.response.bottomline.average_score}}/5, based on {{result.response.bottomline.total_reviews}} reviews.
{% else %}
{% endif %}
<YOTPO-API-KEY>をお使いの Yotpo レビュー API キーに置き換えてください。product_idはBrazeから動的に取得されます。統合を機能させるには、Brazeのproduct_idが Yotpo の製品 ID(通常はeコマース親製品 ID)と一致している必要があります。

製品の最近の5つ星レビューを表示する
このスニペットを使って、メールに含まれる特定の商品のトップ(公開済み)レビューを提供します。
1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/products/{{event_properties.${product_id}}}/reviews.json?per_page=50&star=5&sort=votes_up :save result %}
{% if {{result.response.reviews[0].score}} == 5 %}
Recent 5 Star Review for this product:
{{result.response.reviews[0].content}}
{% else %}
{% endif %}
<YOTPO-API-KEY>をお使いの Yotpo レビュー API キーに置き換えてください。product_idはBrazeから動的に取得されます。統合が機能するためには、Brazeのproduct_idが Yotpo の製品 ID(通常はeコマース親製品 ID)と一致している必要があります。
メールエディターでのスニペットは次のようになります。

製品別にビジュアル UGC を表示する
次のスニペットを使用して、タグ付けされ公開された Yotpo 画像を取得し、ストック画像の代わりに、または追加のギャラリーとしてメールに追加します。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/albums/product/{{event_properties.${product_id}}}?per_page=1 :save result %}
{% if {{result.response.images[0].tagged_products[0].image_url}} != null %}
The Visual content of the product:
<img src="{{result.response.images[0].tagged_products[0].image_url}}" border="0" width="200" height="200" alt="" />
{% else %}
Image return NULL
{% endif %}
<YOTPO-API-KEY>をお使いの Yotpo レビュー API キーに置き換えてください。product_idはBrazeから動的に取得されます。統合が機能するためには、Brazeのproduct_idが Yotpo の製品 ID(通常はeコマース親製品 ID)と一致している必要があります。
スニペットは次のようになります。

顧客のロイヤルティポイント残高をメールに表示する
次のスニペットを使用して、顧客のロイヤルティポイント残高を取得してメールメッセージに使用します。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{% connected_content
https://loyalty.yotpo.com/api/v2/customers?customer_email=**{{${email_address}}}**
:method get
:headers {
"x-guid": "<YOTPO-LOYALTY-GUID>",
"x-api-key": "<YOTPO-LOYALTY-API-KEY>"
}
:content_type application/json
:save publication
%}
You have {{publication.points_balance}} points
Only {{publication.vip_tier_upgrade_requirements.points_needed}} more points to become part of our VIP Tier!
<YOTPO-LOYALTY-GUID>と<YOTPO-LOYALTY-API-KEY>をお使いの Yotpo ロイヤルティ認証情報に置き換えてください。email_addressはBrazeから動的に取得されます。この統合が機能するためには、メールアドレスがこのメールを受信する顧客のメールアドレスと一致している必要があります。
スニペットは次のようになります。

よくある質問
5つ星レビューがない場合はどうなりますか?
5つ星のレビューがない場合(エンドポイントのレスポンスが5つ星のレビューに対して NULL を返した場合など)、コンテンツは表示されません。
商品の画像が公開されていない場合はどうなりますか?
商品の画像がない場合(エンドポイントのレスポンスが商品画像に対して NULL を返した場合など)、コンテンツは表示されません。
ルック&フィールをカスタマイズしたり、Yotpo から他のデータフィールドを取得したりできますか?
はい、できます。その他のデータポイントやカスタマイズオプションについては、API 呼び出しを参照してください。そのためには、フロントエンド開発者の支援が必要になる場合があります。
Yotpo はこのガイドに記載されている以上のカスタム要件には対応していません。