Raportowanie niestandardowych zmiennych Floodlight

Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na nowy interfejs Search Ads 360 Reporting API i jego używaniu.

Reklamodawcy używają niestandardowych zmiennych Floodlight do raportowania danych o konwersjach odpowiadających ich potrzebom biznesowym, np. gatunku filmu kupionego przez użytkownika, nazwy sklepu, w którym kupił produkt, kosztów dostawy itp. Dane te możesz przesyłać za pomocą tagu Floodlight w witrynie reklamodawcy lub interfejsu Search Ads 360 API. Za pomocą interfejsu API możesz też pobierać raporty zawierające te dane.

Dowiedz się więcej o niestandardowych zmiennych Floodlight w Search Ads 360.

Dane lub wymiar

Podczas konfigurowania niestandardowych zmiennych Floodlight reklamodawca używa interfejsu Search Ads 360, aby wskazać, jak każdej zmiennej można użyć w raportach:

• Dane: w większości raportów Search Ads 360 agreguje wartości zmiennych zdefiniowanych jako dane.
  Na przykład reklamodawca używa niestandardowej zmiennej Floodlight do śledzenia kosztów dostawy. Jeśli użytkownik Search Ads 360 zdefiniuje tę zmienną jako dane, a Ty uwzględnisz ją w raporcie adGroup, zobaczysz łączne koszty dostawy powiązane z każdą grupą reklam w zakresie raportu.

  W raporcie conversion Search Ads 360 dostarcza nieprzetworzone dane o poszczególnych konwersjach, a nie dane zbiorcze.

  Uwaga: dane niestandardowe mogą też pojawiać się w kolumnach raportowania Floodlight. W interfejsie Search Ads 360 użytkownicy dodają dane niestandardowe do kolumn raportowania Floodlight, a potem dodają te kolumny do raportów. Możesz też uwzględnić te kolumny Floodlight w żądaniu raportu, tak jak każdy inny typ zapisanej kolumny.

• Wymiar: zmienne zdefiniowane jako wymiary mogą służyć do podziału większości raportów na segmenty.
  Na przykład reklamodawca używa niestandardowej zmiennej Floodlight do śledzenia nazw sklepów. Gdy użytkownik Search Ads 360 zdefiniuje tę zmienną jako wymiar, możesz jej używać do podziału raportu adGroup na segmenty, aby wyświetlać liczbę zakupów w poszczególnych sklepach przypisanych do reklam w grupie reklam.

  W raporcie conversion Search Ads 360 dostarcza nieprzetworzone dane o poszczególnych konwersjach zamiast danych zbiorczych. Jeśli więc dodasz do raportu conversion wymiar niestandardowy, zobaczysz jego wartość. Kontynuując przykład z poprzedniego akapitu: jeśli posegmentujesz raport conversion według wymiaru niestandardowego storeName, zobaczysz nazwę sklepu, w którym miał miejsce każdy konkretny zakup.

  Uwaga: gdy użytkownicy Search Ads 360 zdefiniują kolumnę raportowania Floodlight, mogą użyć wymiarów niestandardowych jako filtra. Dzięki temu kolumna będzie zawierać tylko konwersje, które zarejestrowały określoną wartość wymiaru.

Uwzględnianie danych niestandardowych w żądaniu raportu

Aby uwzględnić dane niestandardowe w żądaniu raportu:

• Musisz znać nazwę przyjazną, która została określona podczas tworzenia niestandardowej zmiennej Floodlight w usłudze Campaign Manager. Przyjazna nazwa pojawia się też w interfejsie Search Ads 360 podczas konfigurowania wymiarów i danych niestandardowych.

• Zakres raportu musi dotyczyć konkretnego reklamodawcy lub niższego.

Następnie w prośbie o raport uwzględnij:

• customMetricName: określa przyjazną nazwę danych niestandardowych.
  Wielkość liter w nazwie danych niestandardowych ma znaczenie.

• platformSource: zawsze ustawiaj tę wartość na Floodlight.

Jeśli na przykład reklamodawca utworzył dane niestandardowe o nazwie shippingCost, uwzględnij w raporcie koszt dostawy customMetricName:

{
   "reportScope": {
     "agencyId": "12300000000000456", // Replace with your ID
     "advertiserId": "21700000000011523", // Replace with your ID
   },
   ...
   "columns": [
     {
        "customMetricName": "shippingCost",
        "platformSource": "floodlight"
     }
   ],
   ...
}
   

Podział raportu na segmenty według wymiaru niestandardowego

Aby podzielić raport na segmenty według wymiaru niestandardowego:

• Musisz znać nazwę przyjazną, która została określona podczas tworzenia niestandardowej zmiennej Floodlight w usłudze Campaign Manager. Przyjazna nazwa pojawia się też w interfejsie Search Ads 360 podczas konfigurowania wymiarów i danych niestandardowych.

• Zakres raportu musi dotyczyć konkretnego reklamodawcy lub niższego.

• W każdym żądaniu raportu można określić tylko jeden wymiar niestandardowy. Prośba może jednak obejmować dodatkowe segmenty niestandardowe.
  Możesz np. posegmentować raport według wymiaru niestandardowego storeName oraz według kwartału i nieniestandardowego segmentu według urządzenia. Pamiętaj, że liczba wierszy może wzrastać wykładniczo z każdym dodatkowym segmentem.

Następnie w prośbie o raport uwzględnij:

• customDimensionName: określa przyjazną nazwę wymiaru niestandardowego.
  Wielkość liter w nazwie wymiaru niestandardowego ma znaczenie.

• platformSource: zawsze ustawiaj tę wartość na Floodlight.

Jeśli np. reklamodawca utworzył wymiar niestandardowy o nazwie storeName, uwzględnij w raporcie nazwę storeName customDimensionName, aby podzielić dane na segmenty według nazwy sklepu:

{
   "reportScope": {
     "agencyId": "20700000000000123", // Replace with your IDs
     "advertiserId": "2170000012345" // Replace with your IDs
   },
   "reportType": "campaign",

   "columns": [
     { "columnName": "campaignId" },
     { "columnName": "clicks" },
     { "columnName": "cost" },
     { "columnName": "dfaRevenue"},

     {
        "customDimensionName": "storeName",
        "platformSource": "floodlight"
     }
   ],
   ...
}