Wie lautet der Berichtsumfang?
Für die meisten Berichte empfehlen wir, Reports.reportScope auf ein bestimmtes Engine-Konto oder einen bestimmten Werbetreibenden festzulegen. Für sehr große Berichte wie Keyword-Berichte, Conversion-Berichte oder fein segmentierte Berichte empfehlen wir, den Umfang auf ein bestimmtes Suchmaschinenkonto zu beschränken. Bei Berichten mit mehr als 10 Millionen Zeilen gibt die API möglicherweise Fehler zurück.
Warum erhalte ich die Fehlermeldung „Forbidden (403)“ (Verboten (403))?
Höchstwahrscheinlich müssen Sie ein Aktualisierungs-OAuth-Token abrufen.
Wie finde ich IDs für Agenturen und Werbetreibende?
Wenn Sie noch nicht über die IDs der Agenturen und Werbetreibenden verfügen, zu deren Aufruf Sie berechtigt sind, fordern Sie einen advertiser-Bericht mit den Spalten agencyId und advertiserId an, aber geben Sie keinen reportScope an.
Search Ads 360 gibt eine Liste aller Agentur- und Werbetreibenden-IDs zurück, zu deren Ansicht Ihr Google-Konto berechtigt ist.
Hier ist eine Beispielanfrage:
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"
}
Wie aktuell sind die Berichtsdaten?
Einige Messwerte sind aktueller als andere. Weitere Informationen finden Sie unter Wie aktuell sind die Berichtsdaten in Search Ads 360?.
Damit Ihre Berichte alle verfügbaren Messwerte enthalten, sollten Sie etwa vier Stunden nach Mitternacht (Zeitzone des Engine-Kontos) warten, bevor Sie Berichte zu den gestrigen Messwerten anfordern. Für den Bericht conversion empfehlen wir, zwölf Stunden nach Mitternacht (Zeitzone des Campaign Manager-Werbetreibenden) zu warten. Wenn Sie Conversion-Daten über die API hochladen, finden Sie unter insert.operation weitere Informationen zur Verfügbarkeit hochgeladener Daten.
Auch nach mehreren Tagen kann sich ein Messwert aufgrund von Suchmaschinen-Spamfiltern oder beim Hochladen von Offline-Conversions über die API noch ändern. Wenn Sie diese Änderungen schrittweise herunterladen möchten, können Sie Berichte zu Daten anfordern, die sich seit dem letzten Download geändert haben. Wenn Sie inkrementelle Änderungen herunterladen, empfehlen wir, ab und zu einen vollständigen Bericht anzufordern. Beispielsweise können Sie alle paar Tage inkrementelle Änderungen herunterladen und dann einmal im Monat einen vollständigen Bericht anfordern.
Wann werden Attributänderungen in Berichten angezeigt?
Es dauert etwa eine Minute, bis Attributänderungen, die ein Nutzer in Search Ads 360 vornimmt, in Berichten angezeigt werden, die Sie über die API herunterladen. Änderungen, die direkt in der externen Suchmaschine (nicht über Search Ads 360) vorgenommen werden, müssen zuerst mithilfe der eingehenden Synchronisierung in Search Ads 360 importiert werden.
Wir empfehlen, nur die Daten zurückzugeben, die sich geändert haben, um zu ermitteln, bei welchen Entitäten Attributänderungen vorgenommen wurden.
Was sind nicht zugeordnete Anzeigen und Keywords?
Manchmal kann Search Ads 360 einer bestimmten Anzeige keine Messwerte zuordnen. Beispielsweise kann eine Anzeige mit einem nicht unterstützten Format oder eine Clickserver-URL mit einem Fehler verhindern, dass einer Anzeige Messwerte in Search Ads 360 zugeordnet werden. Für jede Anzeigengruppe meldet Search Ads 360 alle nicht zugeordneten Messwerte als „nicht zugeordnete Anzeige“. Wenn Sie diese Messwerte in einem Bericht anfordern möchten, legen Sie für includeRemovedEntities den Wert true fest. Fügen Sie der Anfrage die Spalte isUnattributedAd hinzu, damit Sie leicht erkennen können, welche Anzeigen nicht zugeordnet sind.
Ebenso kann Search Ads 360 einem bestimmten Keyword manchmal keine Messwerte zuordnen.
Dies ist der Fall, wenn Diskrepanzen in Berichten auftreten. In solchen Fällen wird die Spalte keywordId für nicht zugeordnete Keywords auf 0 gesetzt.
Enthalten Berichte skalierte Conversions?
In einigen Fällen sind Conversions schwer zu messen, z. B. wenn die Website-Cookies, über die Daten zu Anzeigenklicks gespeichert werden, aufgrund verschiedener Faktoren wie den Browsereinstellungen nicht verfügbar sind. In diesen Fällen werden in Floodlight mithilfe von Skalierung die Conversion-Daten berücksichtigt, die nicht direkt erfasst werden können. Floodlight wendet also maschinelles Lernen auf Verlaufsdaten an, um die Anzahl der Conversions und die Höhe des Conversion-Umsatzes zu modellieren, die nicht gemessen werden können. Die resultierende Schätzung kann dann in Floodlight den Conversion-Messwerten hinzugefügt werden, um ein umfassenderes Bild davon zu erhalten, wie Ihre Werbung zu Conversions führt.
Floodlight wendet eine Skalierung immer auf die folgenden Berichtsspalten an:
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Gespeicherte Spalten, die Floodlight-Aktivitäten enthalten
Der Bericht conversion enthält keine skalierten Conversions. Es werden nur Conversions angezeigt, die direkt erfasst wurden. Die Anzahl der Conversions und die Höhe des Umsatzes in einem conversion-Bericht stimmen wahrscheinlich nicht mit den Conversions und Umsätzen in den oben aufgeführten Spalten überein.
Warum ergeben die Rohdaten-Conversions nicht den aggregierten Messwert X?
Im seltenen Fall, dass aggregierte Messwerte nicht mit Rohereignissen in Search Ads 360 übereinstimmen, vertrauen Sie dem aggregierten Messwert. Bei der Berechnung aggregierter Messwerte versucht Search Ads 360, Datenquellen zu bereinigen. Dazu werden Conversions entfernt, die als Duplikate vermutet werden.
Was kann ich tun, wenn meine Frage hier nicht beantwortet wird?
Wenn du die Ressourcen auf dieser Website gelesen hast und ein Problem nicht lösen kannst, wende dich an den Support und halte die folgenden Informationen bereit:
ID der Agentur und des Werbetreibenden in Search Ads 360, auf die Sie zugreifen möchten
Projektnummer aus der Google API Console
Der Nutzername des Google-Kontos, das Sie für den Zugriff auf die API verwenden.
Dies ist das Konto, dem die Berechtigung zum Zugriff auf Search Ads 360 gewährt wurde. Das ist das Konto, mit dem Sie die Autorisierung einrichten.Code-Snippet Ihrer Anfrage
JSON-Antwort
Wenn es sich bei der Antwort um einen Fehler handelt, geben Sie die Fehlermeldung an und nicht nur den numerischen Fehlercode.