ユースケース
AliExpress のレビューをPrestaShopストアにインポート
レビューのない商品ページはコンバージョン率が下がります。サプライヤーがすでに持っているレビューを JSON で取得し、PrestaShop 標準の商品コメントに読み込みましょう。
カタログの中に存在するレビュー
PrestaShop は Product Comments モジュールのテーブルにレビューを保存しており、商品ページの星、平均、構造化データはそこから生成されます。そのテーブルにインポートすれば、追加のモジュールも、サードパーティの iframe も不要です。
この API なら、数週間ごとに動かなくなるスクレイパーの代わりに、AliExpress の商品ページに表示されるのと同じレビューを、同じフィルターで、安定した JSON 形式で取得できます。
使い方
- URL からAliExpress の商品 ID を見つけます。
aliexpress.com/item/1005006123456789.htmlの数字です。 - レビューを選びます。星4と星5(
filter=5とfilter=4の2リクエスト)、写真付きのみ、またはfilter=localで顧客と同じ国のレビュー。 langで、ショップビューごとの言語に翻訳します。es_ES、fr_FR、it_IT…- 承認済みとして、元の日付とともに商品コメントのテーブルに挿入します。
例:AliExpress から PrestaShop の商品コメントへ
サーバー上でコマンドラインから実行できるスタンドアロンの PHP スクリプトです。PrestaShop を読み込み、星5のレビューを取得して1つの商品に挿入します。本番環境で実行する前に、列名がお使いのバージョンの Product Comments モジュールと一致しているか確認してください。
<?php
// Insert the 5-star reviews of an AliExpress product as PrestaShop product comments.
// Run it from the command line on your server, after backing up the database.
require_once __DIR__ . '/config/config.inc.php';
$idProduct = 42; // your PrestaShop product
$ch = curl_init('https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20');
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('REVIEWS_API_KEY')],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$body = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 200) {
exit("Request failed\n");
}
$reviews = json_decode($body, true)['data'];
foreach ($reviews as $r) {
Db::getInstance()->insert('product_comment', [
'id_product' => (int) $idProduct,
'id_customer' => 0,
'id_guest' => 0,
'customer_name' => pSQL($r['author']),
'title' => pSQL(mb_substr($r['content'], 0, 60)),
'content' => pSQL($r['content']),
'grade' => (int) $r['rating'],
'validate' => 1,
'deleted' => 0,
'date_add' => pSQL($r['date'] . ' 12:00:00'),
]);
}押さえておきたいポイント
- まずバックアップを取りましょう。テーブルのスキーマはモジュールのバージョンによって異なるため、データベースのコピーでテストしてください。
- API key をフロントオフィスに出さないでください。CLI スクリプトまたは cron ジョブから実行し、テンプレートからは決して実行しないでください。
- 重複を避けるため、インポート済みの AliExpress のレビュー ID を、たとえば小さなテーブルやファイルに保存しておきます。
- 写真(
filter=image、Max プラン):レスポンスには画像の URL が含まれており、説明文に表示したりダウンロードしたりできます。
誠実に活用しましょう
レビューは、あなたの顧客ではなく AliExpress の購入者による商品レビューであることを明示して表示してください。EU では消費者法によりレビューの出所を示すことが義務付けられており、それが信頼の構築にもつながります。
よくある質問
PrestaShop 1.7 と 8 で使えますか?
API は PrestaShop のバージョンに依存しません。変わるのは Product Comments モジュールのスキーマなので、インポートする前に、お使いの環境のテーブルの列名を確認してください。
別のレビューモジュールを使えますか?
はい。API は JSON を返すので、フィールド(評価、本文、投稿者、日付)を任意のレビューモジュールのテーブルやインポート形式に対応付けられます。
レビューは何件取得できますか?
1リクエストあたり Free で最大20件、Pro と Max で最大100件で、ページネーションですべてのレビューを取得できます。クォータはプランに応じて1日100、1,000、10,000リクエストです。
この API は AliExpress と提携していますか?
いいえ。AliExpress の商品ページに表示される公開レビューを返しますが、独立したサービスです。
ご自身の商品で試してみましょう
1日100リクエストまで無料、カード登録は不要です。ダッシュボードのテスターに商品 ID を貼り付けて、JSON を確認してください。