Podobnie jak w przypadku innych typów reklam, możesz używać GoogleAdsService.SearchStream do pobierania stanu produktów i danych o skuteczności produktów w reklamach produktowych.
Kampanie, które obsługują produkty z pliku danych Google Merchant Center, mają te raporty:
- Widok skuteczności zakupów
- Widok grupy produktów
- Widok grupy produktów w grupie plików
- Shopping Product
- Widok sprzedaży danych koszyka (dostępny w wersji 24 i nowszych)
- Widok komponentu z rozwinięciem końcowego adresu URL (dostępny w przypadku kampanii produktowych w wersji 26 i nowszych).
Dodatkowo od wersji 26 w kampaniach produktowych final_url_expansion_asset_view raportuje komponenty dostosowywania tekstu wyświetlane, gdy włączone są funkcje AI Max (campaign.ai_max_setting.enable_ai_max = true) i rozwinięcie końcowego adresu URL (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN).
Wymagania dotyczące zapytań i przykład znajdziesz w sekcji Widok komponentu z rozwinięciem końcowego adresu URL.
Widok wyników dotyczących Zakupów
Widok skuteczności zakupów zawiera zbiorcze statystyki raportowania historycznego dotyczące produktów według atrybutów takich jak product_item_id.
Obsługuje wszystkie typy kampanii, które korzystają z plików danych o produktach z Google Merchant Center, w tym kampanie produktowe, Performance Max, kampanie generujące popyt, wideo, promujące aplikacje i w sieci reklamowej.
Widok skuteczności kampanii produktowej rejestruje stan produktu w momencie zarejestrowania odpowiednich danych. Obejmuje to segmenty takie jak product_title, które mogły się zmienić od czasu zarejestrowania danych.
shopping_performance_view obsługuje też te segmenty i dane:
segments.ad_sub_network_type(obsługiwane też wproduct_group_viewiasset_group_product_group_view).- Dane posegmentowane według daty konwersji:
metrics.conversions_by_conversion_date,metrics.all_conversions_by_conversion_date,metrics.conversions_value_by_conversion_date,metrics.all_conversions_value_by_conversion_date,metrics.value_per_conversions_by_conversion_dateimetrics.value_per_all_conversions_by_conversion_date. - Dane o udziale w wyświetleniach w porównaniu z konkurencją:
metrics.search_budget_lost_impression_share,metrics.search_rank_lost_impression_share,metrics.search_budget_lost_absolute_top_impression_shareimetrics.search_rank_lost_absolute_top_impression_share. - Dostępne w wersji 24 i nowszych: segment
segments.conversion_attribution_event_typeimetrics.all_*dane koszyka (które raportują dane koszyka we wszystkich konwersjach, w tym w konwersjach bez możliwości określania stawek).
Oto przykładowe zapytanie, które pobiera wyświetlenia, kliknięcia, koszt, konwersje i wszystkie konwersje w przypadku produktów według product_item_id z kliknięciami w ciągu ostatnich 30 dni (posortowane malejąco według wszystkich konwersji, następnie konwersji, kliknięć, kosztu i wyświetleń):
SELECT
segments.product_item_id,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.clicks > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.cost_micros DESC,
metrics.impressions DESC
Logika atrybucji w raportach na temat produktów
Raporty na poziomie produktu korzystają z określonego modelu atrybucji, aby przypisywać udział w wynikach poszczególnym produktom, gdy w jednej reklamie pojawia się kilka produktów.
Dane finansowe
Dane finansowe, takie jak metrics.cost_micros i metrics.conversions, są obliczane w taki sposób, aby ich suma we wszystkich produktach nie przekraczała wartości w raportach na poziomie kampanii.
- Interakcje bezpośrednie
- Gdy intencja użytkownika jest jasna i powiązana z jednym produktem (np. kliknięcie bezpośrednio produktu), 100% powiązanego kosztu i udziału w konwersji jest przypisywane do tego konkretnego produktu.
- Interakcje pośrednie
- Gdy intencja użytkownika jest skierowana na reklamę jako całość (np. gdy użytkownik kliknie nagłówek, przycisk wezwania do działania lub film), powiązany koszt i udział w konwersji są rozdzielane równomiernie między wszystkie produkty wyświetlane w tej reklamie.
Dane o interakcjach
Dane dotyczące interakcji, takie jak metrics.impressions i metrics.clicks, mierzą zaangażowanie związane z konkretnym produktem.
W przypadku wyświetleń liczba jest zwiększana dla każdego produktu uwzględnionego w reklamie, gdy wystąpi zdarzenie, niezależnie od tego, czy produkt był widoczny w widocznym obszarze użytkownika. Z tego powodu suma wyświetleń wszystkich produktów w raporcie może być znacznie wyższa niż odpowiadające jej sumy na poziomie kampanii.
Z kolei metrics.clicks mierzy tylko kliknięcia, które miały miejsce w przypadku tego konkretnego produktu. W interfejsie Google Ads pole metrics.clicks jest wyraźnie oznaczone jako Kliknięcia związane z produktem.
Widok grupy produktów
Widok grupy produktów zawiera zbiorcze statystyki raportowania dotyczące grup informacji o produktach (w interfejsie nazywanych grupami produktów). Przykłady widoku grupy produktów w grupie plików znajdziesz w przewodniku po raportach dotyczących kampanii Performance Max.
Oto przykładowe zapytanie, które pobiera wyświetlenia, kliknięcia, konwersje i wszystkie konwersje dla grup informacji o produktach w kampanii z wyświetleniami w ciągu ostatnich 30 dni (posortowane malejąco według wszystkich konwersji, następnie konwersji, kliknięć i wyświetleń):
SELECT
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.impressions > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
Raport dotyczący produktów w ramach Zakupów Google
Raport Produkt w reklamie produktowej zawiera atrybuty i statystyki raportowania dotyczące produktów, które znajdują się na kontach Google Merchant Center połączonych z kontem Google Ads. Za pomocą tego raportu możesz sprawdzać statystyki na poziomie klienta, kampanii i grupy reklam. Obsługuje kampanie produktowe, kampanie Performance Max, kampanie generujące popyt, kampanie wideo i (w wersji 24 i nowszych) kampanie promujące aplikacje. Możesz też wysłać zapytanie do shopping_product.product_image_uri, aby pobrać identyfikator URI zdjęcia produktu podany przez sprzedawcę.
Oto przykładowe zapytanie, które pobiera dane o wyświetleniach, kliknięciach, konwersjach i wszystkich konwersjach z ostatnich 30 dni (posortowane malejąco według wszystkich konwersji, konwersji, kliknięć i wyświetleń) w przypadku wszystkich produktów w reklamach produktowych ze wszystkich połączonych kont Google Merchant Center:
SELECT
shopping_product.resource_name,
shopping_product.item_id,
shopping_product.feed_label,
shopping_product.merchant_center_id,
metrics.clicks,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
Więcej informacji o zapytaniach znajdziesz w przewodniku po raportach.
Możliwe spowolnienie działania witryny
Raport o produktach w reklamach produktowych może zwracać znaczną ilość danych, gdy konto jest połączone z dużą liczbą produktów. Te zalecenia mogą pomóc Ci zwiększyć skuteczność zapytań GAQL:
- Zapytania na poziomie kampanii i grupy reklam są zwykle szybsze niż na poziomie konta, ponieważ prawdopodobnie zawierają mniej produktów i wymagają dostępu do mniejszej ilości danych.
- Im więcej pól i danych w klauzuli
SELECT, tym dłuższy czas odpowiedzi. Wybierz tylko te pola i dane, których potrzebujesz w zapytaniu. - Produkty z co najmniej jednym problemem zwracają więcej danych. Możesz filtrować według
shopping_product.statusw klauzuliWHERE, aby dowiedzieć się, które produkty mogą powodować problemy, które doprowadziły do odpowiedniego stanu.
Typowe zastosowania raportu dotyczącego produktów w Zakupach Google
Raport Produkt z Zakupów Google zapewnia elastyczny dostęp do informacji o produktach w przypadku kampanii, które korzystają z plików danych o produktach. Może dostarczać informacji o stanie produktów z kont Google Merchant Center, a także informacji dotyczących reklam, takich jak wskaźniki skuteczności i problemy, które uniemożliwiają wyświetlanie reklam produktów.
W tej sekcji opisujemy kilka typowych przypadków użycia podobnych do tych, które są możliwe w widoku Produkty w interfejsie Google Ads.
Pole issues dla shopping_product jest podobne do ProductStatus w Merchant API, ale zawiera dodatkowo problemy dotyczące Google Ads.
Aby sprawdzić, czy problem należy rozwiązać w Google Merchant Center czy w Google Ads, najpierw sprawdź pole shopping_product.issues.documentation w odpowiedzi, które zawiera artykuł w Centrum pomocy.
Stany usług (poziom konta)
Jeśli wygenerujesz raport bez filtrów kampanii lub grupy reklam, otrzymasz wszystkie produkty na poziomie konta.
Obsługuje dane, stan i problemy ze wszystkich kampanii na koncie typu:
- Zakupy
- Performance Max
To zapytanie pozwala sprawdzić stan produktu, np. NOT_ELIGIBLE, oraz listę problemów związanych z produktem, które spowodowały dany stan:
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
Stany produktów (na poziomie kampanii)
Określenie raportu z zasobem kampanii w ramach klauzuli WHERE zwraca wszystkie produkty uwzględnione w wybranej kampanii.
Jest obsługiwany przez te typy kampanii, które mogą korzystać z plików danych o produktach:
- Zakupy
- Performance Max
- kampanie generujące popyt,
- Wideo
- Aplikacja (dostępna w wersji 24 i nowszych)
To zapytanie pozwala sprawdzić stan każdego produktu uwzględnionego w danej kampanii, w tym problemy, które powodują ten stan. Na przykład wstrzymana kampania wpływa na stan produktu:
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
Stany produktów (na poziomie grupy reklam)
Jeśli w klauzuli WHERE określisz raport, podając zarówno zasób grupy reklam, jak i zasób kampanii, zwrócone zostaną wszystkie produkty uwzględnione w wybranej kampanii. Dane, stan i problemy dotyczące produktu odzwierciedlają, czy jest on uwzględniony w wybranej grupie reklam, czy z niej wykluczony.
Jest obsługiwany w tych typach kampanii:
- Zakupy
- Generowanie popytu
- Wideo
- Aplikacja (dostępna w wersji 24 i nowszych; obsługuje tylko dane
impressions,clicksictr, nie obsługuje danychstatusaniissues)
To zapytanie pozwala sprawdzić stan produktu w odniesieniu do tej grupy reklam. Umożliwia sprawdzenie, czy filtry grup produktów (na poziomie grupy reklam) są stosowane prawidłowo, oraz sprawdzenie stanu każdego produktu:
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.ad_group,
ad_group.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
AND shopping_product.ad_group =
'customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>'
Dane o produktach filtrowane według daty (poziom konta)
Określenie raportu z datą lub zakresem dat w klauzuli WHERE zwraca dane dla wszystkich produktów na poziomie konta w określonym przedziale czasu, niezależnie od tego, czy dane są niezerowe.
Nie możesz wybrać segments.date. Jeśli to zrobisz, pojawi się błąd UNSUPPORTED_DATE_SEGMENTATION.
To zapytanie pozwala sprawdzić skuteczność każdego produktu w danym dniu lub w innym zgodnym zakresie dat, zagregowaną we wszystkich kampaniach:
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
metrics.clicks,
metrics.impressions,
metrics.cost_micros
FROM shopping_product
WHERE
segments.date DURING LAST_30_DAYS
Skuteczność produktów z danymi koszyka
Reklamodawcy z branży handlu detalicznego mogą uzyskiwać dostęp do odpowiednich danych o sprzedaży i zyskach, takich jak przychody, zysk brutto, marża zysku brutto i liczba sprzedanych jednostek. Te dane są dostępne dla wszystkich reklamodawców, którzy wdrożyli konwersje z danymi koszyka w kampaniach produktowych, i są zgodne z tymi raportami:
ad_groupad_group_adcampaigncart_data_sales_view(dostępne w wersji 24 i nowszych)customer(zagregowane dla wszystkich kampanii)product_group_viewshopping_performance_viewshopping_product(w przypadku danych koszykametrics.all_*w wersji 24 i nowszych)
W raportach dotyczących kampanii produktowych, np. w shopping_performance_view, możesz używać tych danych koszyka:
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
W wersji 24 i nowszych dostępne są też te dane koszyka, które można raportować we wszystkich konwersjach (w tym w konwersjach nieużywanych do określania stawek):
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_units_sold
Poniższy przykład pokazuje, jak można wykorzystać dane koszyka do analizy skuteczności kampanii produktowych na poziomie produktu w ciągu ostatnich 30 dni:
SELECT
segments.product_item_id,
segments.product_title,
metrics.average_cart_size,
metrics.average_order_value_micros,
metrics.conversions,
metrics.conversions_value,
metrics.gross_profit_micros,
metrics.gross_profit_margin,
metrics.revenue_micros,
metrics.units_sold,
campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
AND metrics.conversions > 0
ORDER BY
metrics.gross_profit_margin DESC,
metrics.revenue_micros DESC,
metrics.conversions_value DESC
Skuteczność kampanii z danymi koszyka
Danych o koszyku można używać na poziomie kampanii i łączyć je z innymi danymi o skuteczności, takimi jak wyświetlenia, kliknięcia i koszt:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.cost_micros,
metrics.average_order_value_micros,
metrics.gross_profit_micros,
metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
ORDER BY
metrics.gross_profit_margin DESC,
metrics.average_order_value_micros DESC,
metrics.cost_micros DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
Widok komponentów z rozwinięciem końcowego adresu URL
Od wersji 26 możesz używać final_url_expansion_asset_view do pomiaru skuteczności na poziomie komponentu w przypadku komponentów dostosowywania tekstu wyświetlanych w kampaniach produktowych, gdy włączone są funkcje AI Max (campaign.ai_max_setting.enable_ai_max = true) i rozwinięcie końcowego adresu URL (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN).
Podczas wysyłania zapytań do final_url_expansion_asset_view przestrzegaj tych reguł filtrowania i wyboru pól:
- Zapytania dotyczące
final_url_expansion_asset_viewmuszą być filtrowane według co najmniej jednego z tych pól:campaign.advertising_channel_type,campaign(campaign.id,campaign.resource_namelubfinal_url_expansion_asset_view.campaign) lubad_group(ad_group.id,ad_group.resource_namelubfinal_url_expansion_asset_view.ad_group). Pominięcie wszystkich tych pól spowoduje zwrócenie błęduFinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER. - Podczas wysyłania zapytania do
final_url_expansion_asset_vieww przypadku kampanii produktowych na poziomie konta lub kampanii musisz filtrować wedługcampaign.advertising_channel_type = 'SHOPPING'(lub filtrować według pojedynczej grupy reklam za pomocą=). Filtrowanie według kampanii (campaign.id,campaign.resource_namelubfinal_url_expansion_asset_view.campaign) również wymagacampaign.advertising_channel_type = 'SHOPPING'. Jeśli go pominiesz, zwrócony zostanie błądFinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER, natomiast filtrowanie według pojedynczegoad_groupsamo w sobie spełnia wymagania filtra. - Filtry
campaign.advertising_channel_type,campaignlubad_groupmuszą używać operatora=w przypadku pojedynczej wartości. Użycie operatoraINlub wielu warunków dla tego samego typu zasobu zwraca błądFinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE. - W przypadku kampanii produktowych możesz wybierać i filtrować pola
ad_group, ale nie możesz wybierać pólasset_group. Wybranie pólasset_groupw kampaniach produktowych (lub podczas filtrowania według polaad_group) zwracaFinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP(lubCANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP, gdy wybrane są też polaad_group). Filtrowanie wedługasset_groupprzy wybranych polachad_groupzwracaCANNOT_SELECT_AD_GROUP, a filtrowanie wedługad_groupiasset_groupzwracaCANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.
To zapytanie pobiera wskaźniki skuteczności na poziomie komponentu dla kampanii produktowych z ostatnich 30 dni:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
final_url_expansion_asset_view.asset,
final_url_expansion_asset_view.field_type,
final_url_expansion_asset_view.final_url,
final_url_expansion_asset_view.status,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM final_url_expansion_asset_view
WHERE
campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS