Jaki powinien być zakres raportu?
W przypadku większości raportów zalecamy ustawienie właściwości Reports.reportScope na konkretne konto wyszukiwarki lub konkretnego reklamodawcę. W przypadku bardzo dużych raportów (np. raportów o słowach kluczowych, konwersji lub raportów podzielonych na segmenty) zalecamy ograniczenie zakresu do konkretnego konta wyszukiwarki. Interfejs API może zwracać błędy w przypadku raportów zawierających ponad 10 milionów wierszy.
Dlaczego pojawia się błąd 403 (Dostęp zabroniony)?
Najprawdopodobniej musisz uzyskać token odświeżania OAuth.
Jak znaleźć identyfikatory agencji i reklamodawców?
Jeśli nie masz jeszcze identyfikatorów agencji i reklamodawców, które możesz wyświetlać, poproś o raport advertiser z kolumnami agencyId i advertiserId, ale nie podawaj wartości reportScope.
Search Ads 360 zwróci listę wszystkich identyfikatorów agencji i reklamodawców, do wyświetlania których Twoje konto Google ma uprawnienia.
Oto przykładowe żądanie:
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportType": "advertiser",
"columns": [
{ "columnName": "agency" },
{ "columnName": "agencyId" },
{ "columnName": "advertiser" },
{ "columnName": "advertiserId" }
],
"statisticsCurrency": "usd"
}
Jak aktualne są dane raportowania?
Niektóre dane są bardziej aktualne niż inne. Szczegółowe informacje znajdziesz w artykule o tym, jak aktualne są dane raportowania w Search Ads 360.
Aby mieć pewność, że raporty zawierają wszystkie dostępne dane, zalecamy odczekać około 4 godzin po północy (strefa czasowa konta wyszukiwarki) przed wysłaniem prośby o raport z poprzedniego
raportu. W przypadku raportu conversion – 12 godzin po północy (strefa czasowa reklamodawcy w usłudze Campaign Manager). Jeśli do przesyłania danych o konwersjach używasz interfejsu API, wejdź na stronę insert.operation, aby dowiedzieć się więcej o dostępności przesłanych danych.
Nawet po kilku dniach dane mogą się zmienić z powodu filtrów spamu w wyszukiwarce lub konwersji offline przesyłanych przez interfejs API. Aby stopniowo pobierać te zmiany, poproś o raporty z danymi, które uległy zmianie od ostatniego pobrania. W przypadku pobierania przyrostowych zmian zalecamy wysyłanie co jakiś czas pełnego raportu. Możesz np. pobierać przyrostowe zmiany co kilka dni, a potem raz w miesiącu wysyłać prośbę o pełny raport.
Kiedy zmiany atrybutów pojawią się w raportach?
Zmiany atrybutów wprowadzone przez użytkownika w Search Ads 360 pojawiają się w raportach pobieranych przez interfejs API po około minucie. Zmiany wprowadzone bezpośrednio w wyszukiwarce zewnętrznej (nie przez Search Ads 360) trzeba najpierw zaimportować do Search Ads 360 za pomocą synchronizacji przychodzącej.
Zalecamy zwracanie tylko tych danych, które uległy zmianie. Dzięki temu można określić, które elementy mają zmienione atrybuty.
Czym są nieprzypisane reklamy i słowa kluczowe?
Czasami Search Ads 360 nie może przypisać danych do konkretnej reklamy. Search Ads 360 może np. uniemożliwić przypisanie danych do reklamy, jeśli ma
nieobsługiwany format lub zawiera błąd w adresie URL serwera kliknięć. W przypadku każdej grupy reklam Search Ads 360 raportuje wszystkie nieprzypisane dane jako należące do „nieprzypisanej reklamy”. Aby zażądać tych danych w raporcie, ustaw includeRemovedEntities na true. Aby ułatwić sprawdzanie, które reklamy nie są przypisane, do żądania dodaj kolumnę isUnattributedAd.
Czasami Search Ads 360 nie może przypisać danych do konkretnego słowa kluczowego.
Dzieje się tak, gdy w raportach pojawiają się rozbieżności. W takich przypadkach kolumna keywordId w przypadku nieprzypisanych słów kluczowych ma wartość 0.
Czy raporty zawierają skalowane konwersje?
W niektórych przypadkach konwersje są trudne do zmierzenia, np. gdy pliki cookie witryny zawierające informacje o kliknięciach reklam są niedostępne ze względu na różne czynniki, w tym ustawienia przeglądarki. W takich przypadkach Floodlight używa skalowania, aby uwzględniać dane o konwersjach, których nie można zmierzyć bezpośrednio. Oznacza to, że Floodlight stosuje systemy uczące się do danych historycznych, aby modelować liczbę konwersji i przychody z konwersji, których nie można zmierzyć. Floodlight może dodać wynikowe oszacowanie do danych o konwersjach, aby dać pełniejszy obraz tego, jak Twoje reklamy generują konwersje.
Floodlight zawsze stosuje skalowanie do tych kolumn raportowania:
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Zapisane kolumny zawierające dane o aktywnościach Floodlight
Raport conversion nie zawiera skalowanych konwersji. Wyświetla tylko konwersje zmierzone bezpośrednio. Liczba konwersji i kwota przychodów w raporcie conversion nie powinny być zgodne z danymi w kolumnach wymienionych powyżej.
Dlaczego nieprzetworzone konwersje nie są sumowane do zagregowanych danych X?
W rzadkich przypadkach, gdy dane zbiorcze nie zgadzają się z nieprzetworzonymi zdarzeniami w Search Ads 360, należy traktować je jako zaufane. Podczas obliczania danych zbiorczych Search Ads 360 próbuje oczyścić źródła danych, usuwając konwersje, które prawdopodobnie są duplikatami.
Co zrobić, jeśli nie ma tu odpowiedzi na moje pytanie?
Jeśli po zapoznaniu się z materiałami na tej stronie napotkasz problem, którego nie możesz rozwiązać, skontaktuj się z zespołem pomocy i przygotuj te informacje:
Identyfikator agencji w Search Ads 360 i identyfikator reklamodawcy, do których próbujesz uzyskać dostęp
Numer projektu z Konsoli interfejsów API Google
Nazwa użytkownika konta Google, którego używasz, aby uzyskać dostęp do interfejsu API.
Jest to konto, które udzielono dostępu do Search Ads 360. Jest to konto, którego używasz do konfigurowania autoryzacji.Fragment kodu żądania
Odpowiedź JSON
Jeśli odpowiedź jest błędem, podaj komunikat o błędzie, a nie tylko numeryczny kod błędu.