Zapisane kolumny

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.

Aby generować raporty o aktywnościach Floodlight, celach Google Analytics lub niestandardowych wskaźnikach KPI, reklamodawca może zalogować się w interfejsie Search Ads 360 i utworzyć co najmniej 1 zapisaną kolumnę, np. kolumnę aktywności Floodlight, kolumnę aktywności Google Analytics lub kolumnę z formułą. Zapisaną kolumnę możesz uwzględnić w żądaniu raportu, aby pobrać z niej dane lub przefiltrować raport.

Wyświetlanie listy zapisanych kolumn

Aby wyświetlić wszystkie zapisane kolumny utworzone przez reklamodawcę, wyślij prośbę o: SavedColumns.list() . Odpowiedź zawiera savedColumnName w każdej kolumnie reklamodawcy.

Wysyłanie raportów o zapisanych kolumnach

Aby uwzględnić zapisaną kolumnę w żądaniu raportu, dodaj kolumnę z atrybutem savedColumnName ustawionym na nazwę kolumny:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

Korzystając z zapisanych kolumn, pamiętaj, że:

• Zapisane kolumny są zdefiniowane na poziomie reklamodawcy. Jeśli do żądania uwzględnisz zapisaną kolumnę, request.reportScope musi określać reklamodawcę lub węższy zakres. Oznacza to, że każdy raport może zawierać zapisane kolumny tylko dotyczące jednego reklamodawcy.

• W zapisanych nazwach kolumn rozróżniana jest wielkość liter, spacje i znaki interpunkcyjne. Atrybut savedColumnName musi dokładnie odpowiadać nazwie zapisanej kolumny. Jeśli nazwa zapisanej kolumny jest taka sama jak nazwa innej kolumny w tym samym żądaniu, Search Ads 360 wymaga określenia alternatywnej, niepowtarzalnej kolumny headerText w jednej lub obu kolumnach.

• Zapisane kolumny można w każdej chwili zmienić lub usunąć w interfejsie zarządzania kampaniami Search Ads 360. Jeśli żądanie, które wskazuje zapisane kolumny, nie powiedzie się, spróbuj usunąć zapisane kolumny z żądania i wysłać je ponownie.

• Raporty przyrostowe nie mogą zawierać danych, które nie są bezpośrednio obsługiwane przez interfejs API (np. kolumn aktywności Google Analytics). Użytkownicy Search Ads 360 mogą też modyfikować zapisane kolumny, więc raporty przyrostowe zawierające zapisane kolumny mogą nie być dokładne.