ユースケース

AliExpress のレビューをPrestaShopストアにインポート

レビューのない商品ページはコンバージョン率が下がります。サプライヤーがすでに持っているレビューを JSON で取得し、PrestaShop 標準の商品コメントに読み込みましょう。

無料の API key を取得ドキュメントを読む

カタログの中に存在するレビュー

PrestaShop は Product Comments モジュールのテーブルにレビューを保存しており、商品ページの星、平均、構造化データはそこから生成されます。そのテーブルにインポートすれば、追加のモジュールも、サードパーティの iframe も不要です。

この API なら、数週間ごとに動かなくなるスクレイパーの代わりに、AliExpress の商品ページに表示されるのと同じレビューを、同じフィルターで、安定した JSON 形式で取得できます。

使い方

  1. URL からAliExpress の商品 ID を見つけます。aliexpress.com/item/1005006123456789.html の数字です。
  2. レビューを選びます。星4と星5(filter=5 と filter=4 の2リクエスト)、写真付きのみ、または filter=local で顧客と同じ国のレビュー。
  3. lang で、ショップビューごとの言語に翻訳します。es_ES、fr_FR、it_IT…
  4. 承認済みとして、元の日付とともに商品コメントのテーブルに挿入します。

例:AliExpress から PrestaShop の商品コメントへ

サーバー上でコマンドラインから実行できるスタンドアロンの PHP スクリプトです。PrestaShop を読み込み、星5のレビューを取得して1つの商品に挿入します。本番環境で実行する前に、列名がお使いのバージョンの Product Comments モジュールと一致しているか確認してください。

PHP — reviews to PrestaShop
<?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 を確認してください。

無料の API key を取得料金