Google a extins Merchant API cu rapoarte pentru cumpărăturile realizate prin Universal Commerce Protocol, inclusiv în AI Mode din Search și în Gemini. Actualizarea din octombrie adaugă și informații despre videoclipurile produselor, garanții și cauzele respingerii ofertelor. Schimbările privesc integrarea tehnică a magazinelor cu Merchant Center, de la datele trimise despre produse până la măsurarea etapelor unei cumpărături.
Noile rapoarte UCP sunt disponibile în versiunea experimentală v1alpha a componentei de raportare. Google le prezintă ca acces programatic la aceleași informații de performanță oferite în tabloul de analiză UCP din Merchant Center. Ele se referă la activitatea integrării de checkout UCP, cu indicatori proprii pentru interacțiuni, comenzi și transferuri către coșul comerciantului.
De la apăsarea butonului de cumpărare la comanda finalizată
Componenta de raportare separă două perspective. Prima urmărește parcursul cumpărătorului la nivelul contului Merchant Center. A doua identifică produsele pentru care oamenii apasă butonul de cumpărare direct în serviciile Google. Identificatorul ofertei și titlul produsului permit asocierea acestor interacțiuni cu articolele din catalogul magazinului.
La nivelul contului, comercianții pot consulta numărul apăsărilor pe butonul de cumpărare, conectările reușite dintre contul Google al clientului și contul său din magazin, rata acestor conectări și cumpărăturile finalizate. Sunt incluse anulările, valoarea comenzilor și informații despre produsele din comenzile încheiate. Indicatorii descriu etape distincte ale procesului comercial.
Transferul unui coș către website-ul comerciantului are propriile măsurători: numărul transferurilor, valoarea medie a coșului și numărul mediu de produse. În acest fel, datele diferențiază cumpărăturile încheiate direct prin experiența Google de continuarea procesului pe site-ul magazinului. Un transfer de coș este raportat separat de o comandă finalizată.
Perspectiva dedicată produselor raportează apăsările butonului de cumpărare pentru fiecare ofertă. Câmpurile documentate includ identificatorul contului, țara clientului, identificatorul produsului și titlul acestuia. Numărul acestor apăsări măsoară interacțiunea cu butonul; valoarea vânzărilor și comenzile finalizate sunt descrise în raportarea de ansamblu a integrării.
Conturi multiple și valori în monede diferite
Google acceptă interogarea pentru conturi independente, subconturi individuale și conturi avansate care administrează mai mulți comercianți. În cazul unui cont avansat, rezultatele se pot agrega pentru toate subconturile sau se pot separa după identificatorul fiecărui comerciant. Această diferență permite atât examinarea activității totale, cât și analiza unui magazin individual.
Fiecare interogare a celor două rapoarte UCP necesită un filtru de dată. Datele se raportează la fusul orar al comerciantului, iar țara clientului descrie locul acestuia la momentul evenimentului. Pentru situațiile în care țara nu poate fi determinată, referința API prevede codul special ZZ, distinct de codurile obișnuite ale țărilor.
Documentația tratează separat indicatorii de volum și valorile monetare. Sumele sunt returnate împreună cu moneda, în structuri care includ valoarea exprimată în milionimi de unitate monetară. Numărul apăsărilor sau al conectărilor nu are, în sine, o monedă asociată. Combinarea acestor categorii într-o singură interogare poate împărți rezultatele pe monede și poate exclude rânduri fără valori de cumpărare.
Pentru totaluri corecte, Google descrie două interogări distincte: una pentru numărători și etapele parcursului comercial, alta pentru valorile comenzilor și coșurilor, împreună cu numărătorile aferente fiecărei monede. Separarea păstrează diferența dintre câte interacțiuni au avut loc și ce valoare financiară a fost înregistrată.
Videoclipuri, garanții și documente de certificare
În componenta dedicată produselor, atributul videoLinks acceptă adresele videoclipurilor asociate unei oferte. Astfel, o integrare poate transmite materiale video suplimentare față de imaginile produsului, la nivelul articolelor din catalog. Câmpul este opțional și descrie datele furnizate prin API pentru produsul respectiv.
Suportul pentru garanții a fost extins dincolo de anunțurile pentru vehicule, la toate produsele. Durata garanției poate fi exprimată în luni sau ani. Structura de certificare primește, la rândul său, câmpuri distincte pentru documentul de certificare și pentru etichetă, inclusiv fișe de produs și etichete energetice.
Lista actualizărilor menționează explicit și suportul pentru autoritatea britanică Department for Energy Security and Net Zero în informațiile privind eficiența energetică. Referința produselor descrie separat certificările europene EPREL. Datele pentru document și etichetă sunt câmpuri diferite, astfel încât integrarea poate transmite fiecare resursă în rolul său corespunzător.
Cauzele respingerii devin vizibile la nivelul ofertei
O altă schimbare privește diagnosticarea ofertelor afectate de suspendarea contului. În locul unei mențiuni generice de respingere a contului, anumite probleme sunt expuse direct pentru produsele afectate. Potrivit Google, această prezentare precizează impactul asupra ofertei, metodei de promovare și țării. Catalogul poate fi analizat astfel la nivelul consecințelor concrete pentru fiecare produs.
Resursa contului include și homePageUri, un câmp disponibil numai pentru citire, care returnează adresa paginii principale a magazinului. Pentru integrarea notificărilor, listarea abonamentelor folosește implicit pagini de 100 de rezultate, cu maximum 200. Un token de continuare indică existența rezultatelor următoare, păstrând parametrii interogării inițiale.
Google a completat și explicațiile pentru notificările privind schimbarea serviciilor asociate conturilor. Acestea acoperă crearea, actualizarea sau eliminarea unei relații de serviciu și pot viza un comerciant ori toate conturile administrate. Actualizarea reunește astfel măsurarea activității comerciale, descrierea produselor și administrarea relațiilor tehnice în aceeași infrastructură Merchant Center, cu versiunea alpha precizată separat pentru noile rapoarte UCP.
Pachetul din octombrie include și patru perspective noi de raportare pentru campaniile de afiliere YouTube Shopping: statistici de campanie, defalcări după creator și format, rezultate la nivelul videoclipului și rezultate pentru produse. Aceste componente sunt tot în v1alpha. Informațiile despre creatori primesc numărul abonaților canalului, iar raportarea conținutului separă comisioanele platformei de cele ale vânzătorului. Pentru produsele etichetate și vândute este adăugat tipul de produs, completând datele comerciale accesibile prin aceeași interfață.
