Caso de uso

Importe avaliações do AliExpress para a sua loja WooCommerce

O seu produto tem milhares de avaliações no AliExpress e nenhuma na sua loja. Obtenha-as em JSON e crie avaliações nativas do WooCommerce com poucas linhas de PHP.

Obter uma API key grátis Ver a documentação

Porque não um plugin?

Os importadores de avaliações que fazem scraping do AliExpress deixam de funcionar sempre que a página muda, e muitos guardam as avaliações em tabelas próprias, pelo que o seu tema, o seu schema markup e as suas estrelas as ignoram.

As avaliações do WooCommerce são apenas comentários do WordPress do tipo review com um valor de meta rating. Se as criar você mesmo a partir de JSON limpo, aparecem em todo o lado onde aparece uma avaliação normal: separadores do produto, classificação média, dados estruturados e widgets de avaliações.

Como funciona

Encontre o ID do produto no AliExpress no URL: o número em aliexpress.com/item/1005006123456789.html.
Escolha as avaliações: só 5 estrelas (filter=5), só com fotos (filter=image) ou as de compradores do país dos seus clientes (filter=local&country=PT).
Traduza-as com lang (pt_BR, es_ES, fr_FR…) para coincidirem com o idioma da sua loja.
Insira-as como avaliações do WooCommerce, guardando o id da avaliação do AliExpress para que uma segunda execução nunca crie duplicados.

Exemplo: do AliExpress a avaliações do WooCommerce

Execute-o a partir de um script WP-CLI ou de uma tarefa agendada. Lê as avaliações de 5 estrelas de um produto do AliExpress e cria-as como avaliações de um produto do WooCommerce. Substitua $wc_product_id pelo id do produto na sua loja.

PHP — reviews to WooCommerce

<?php
// Create WooCommerce reviews from the 5-star reviews of an AliExpress product.
// Run it with WP-CLI (wp eval-file import-reviews.php) or from a scheduled task.
$wc_product_id = 123; // your WooCommerce product
$response = wp_remote_get('https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20', [
    'headers' => ['x-api-key' => getenv('REVIEWS_API_KEY')],
    'timeout' => 30,
]);
if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
    exit('Request failed');
}
$reviews = json_decode(wp_remote_retrieve_body($response), true)['data'];

foreach ($reviews as $r) {
    // Skip reviews imported on a previous run.
    $exists = get_comments([
        'post_id' => $wc_product_id,
        'meta_key' => 'aliexpress_review_id',
        'meta_value' => $r['id'],
        'count' => true,
    ]);
    if ($exists) continue;

    wp_insert_comment([
        'comment_post_ID' => $wc_product_id,
        'comment_author' => $r['author'],
        'comment_content' => $r['content'],
        'comment_type' => 'review',
        'comment_approved' => 1,
        'comment_date' => $r['date'] . ' 12:00:00',
        'comment_meta' => ['rating' => $r['rating'], 'aliexpress_review_id' => $r['id']],
    ]);
}
WC_Comments::clear_transients($wc_product_id);

Detalhes que vale a pena acertar

Mantenha a API key no servidor. Execute a importação a partir de PHP, WP-CLI ou cron, nunca com JavaScript no navegador.
Evite duplicados. Guarde o id do AliExpress como meta do comentário e ignore as avaliações já importadas.
Fotos (filter=image, plano Max): cada avaliação inclui os URL das imagens. Descarregue-as para a biblioteca de multimédia se quiser conservá-las caso o AliExpress as remova.
Atualize a classificação. Depois de uma importação em lote, chame WC_Comments::clear_transients( $wc_product_id ) para que a classificação média seja recalculada.

Use-as com transparência

Identifique-as como o que são: avaliações do produto de compradores do AliExpress, não dos seus clientes. Na UE, a lei do consumidor obriga a informar de onde vêm as avaliações, e ser claro sobre isso é também o que gera confiança.

Perguntas

As avaliações aparecem na classificação do WooCommerce e no schema markup?

Sim, se as criar como avaliações do WooCommerce (comentários do tipo review com uma classificação), como no exemplo. Contam para a classificação média como qualquer outra avaliação.

Posso agendá-lo para manter as avaliações atualizadas?

Sim. Execute o script com WP-Cron ou com um cron job do servidor, e ignore os ids que já importou.

Quantas avaliações posso obter?

Até 20 por pedido no Free e até 100 no Pro e no Max, com paginação para as percorrer todas. A quota é de 100, 1.000 ou 10.000 pedidos por dia, consoante o plano.

A API é afiliada ao AliExpress?

Não. Devolve as avaliações públicas que o AliExpress mostra nas páginas de produto, mas é um serviço independente.

Experimente com os seus produtos

100 pedidos por dia grátis, sem cartão. Cole o ID de um produto no tester do painel e veja o JSON.

Obter uma API key grátis Preços