Meldungen: Häufig gestellte Fragen

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet Mehr Flexibilität bei der Erstellung benutzerdefinierter Berichte und Integration der Daten in Ihre Berichtsanwendungen und Prozesse. Weitere Informationen zur Migration zur neuen Search Ads 360-Berichterstellung und deren Verwendung API hinzu.

Welchen Umfang sollte der Bericht umfassen?

Für die meisten Berichte empfehlen wir, Reports.reportScope einem bestimmten Engine-Konto oder Werbetreibenden zugewiesen. Für sehr große wie Keyword-Berichte, Conversion-Berichte oder fein segmentierten Berichten erstellen können. Wir empfehlen, den Umfang auf eines bestimmten Engine-Kontos. Die API gibt möglicherweise Fehler für Berichte zurück, die größer sind als 10 Millionen Zeilen.

Warum erhalte ich die Fehlermeldung „Verboten“ (403)?

Höchstwahrscheinlich müssen Sie Rufen Sie ein OAuth-Aktualisierungstoken ab.

Wie finde ich IDs für Agenturen und Werbetreibende?

Wenn Sie noch keine IDs für die Agenturen und Werbetreibenden haben, Berechtigung zum Anzeigen, Anfordern einer advertiser mit den Spalten agencyId und advertiserId, aber ohne reportScope. Search Ads 360 gibt dann eine Liste aller Agentur- und Werbetreibenden-IDs zurück, Google-Konto hat die Berechtigung zum Ansehen.

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 dazu, wie aktuell die Berichtsdaten sind in Search Ads 360?

Um sicherzustellen, dass Ihre Berichte alle verfügbaren Messwerte enthalten, sollten Sie etwa vier Stunden nach Mitternacht (Zeitzone des Engine-Kontos), bevor Berichte zum gestrigen Tag metrics; für den Bericht conversion zu warten, 12 Stunden nach Mitternacht (Zeitzone des Campaign Manager-Werbetreibenden). Wenn Sie die API zum Hochladen von Conversion-Daten verwenden, lesen Sie insert.operation finden Sie weitere Informationen zur Verfügbarkeit hochgeladener Daten.

Ein Messwert kann sich auch nach mehreren Tagen aufgrund von Spamfiltern der Suchmaschine oder aufgrund von Offlinezugriff ändern. die über die API hochgeladen werden. Um diese inkrementell herunterzuladen, Änderungen anfordern, Berichte anfordern zu den Daten, die sich seit Ihrem letzten Download geändert haben. Wenn Sie inkrementell sollten Sie hin und wieder einen vollständigen Bericht anfordern. Beispiel: Sie können alle paar Tage inkrementelle Änderungen herunterladen und dann einmal einen vollständigen Bericht anfordern. pro Monat.

Wann werden Attributänderungen in Berichten angezeigt?

Es dauert etwa eine Minute, bis Attributänderungen, die ein Nutzer in Search Ads 360 vornimmt, in Berichte, die Sie über die API herunterladen. Änderungen, die direkt in der externen Suchmaschine vorgenommen wurden (nicht über Search Ads 360) müssen zuerst mithilfe der eingehenden Synchronisierung in Search Ads 360 importiert werden.

Wir empfehlen die Rückgabe nur die Daten, die sich geändert haben, um festzustellen, 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. Beispiel: Eine Anzeige mit einer nicht unterstütztes Format oder eine fehlerhafte Clickserver-URL kann verhindern, dass Search Ads 360 einer Anzeige hinzufügen. Für jede Anzeigengruppe meldet Search Ads 360 alle nicht zugeordneten Messwerte als zu eine „nicht zugeordnete Anzeige“. Um diese Messwerte in einem Bericht anzufordern, legen Sie includeRemovedEntities an true. Fügen Sie den Parameter isUnattributedAd in der Anfrage.

Ebenso kann Search Ads 360 gelegentlich Messwerte nicht einem bestimmten Keyword zuordnen. Dies ist der Fall, wenn Abweichungen in Berichten auftreten. In solchen Fällen kann das Die Spalte „keywordId“ für nicht zugeordnete Keywords ist auf 0 gesetzt.

Enthalten Berichte skalierte Conversions?

Manchmal sind Conversions schwer zu messen, z. B. wenn die Website-Cookies, über die Informationen zu Ihren Anzeigenklicks sind aufgrund verschiedener Faktoren wie den Browsereinstellungen nicht verfügbar. In diesen Fällen berücksichtigt Floodlight mithilfe von Skalierung die Conversion-Daten, die nicht direkt gemessen werden. Das heißt, Floodlight wendet maschinelles Lernen auf Verlaufsdaten an, um den Anzahl der Conversions und die Höhe des Conversion-Umsatzes, die nicht messbar sind. Floodlight kann Dann fügen Sie die resultierende Schätzung ihren Conversion-Messwerten hinzu, um ein umfassenderes Bild wie Sie mit Ihrer Werbung Conversions erzielen.

Floodlight wendet immer Skalierung auf die folgenden Berichtsspalten an:

  • dfaActions
  • dfaRevenue
  • dfaTransactions
  • dfaWeightedActions
  • Gespeicherte Spalten, die Bericht zu Floodlight-Aktivitäten

Die conversion enthält keine skalierten Conversions. Es werden nur Conversions angezeigt, die gemessen wurden. . Die Anzahl der Conversions und die Umsatzhöhe in einem conversion-Bericht nicht mit den Conversions und Umsätzen in den oben aufgeführten Spalten übereinstimmen.

Warum entspricht die Summe der Roh-Conversions nicht dem aggregierten Messwert X?

Im seltenen Fall, dass aggregierte Messwerte nicht mit Rohereignissen in Search Ads 360 übereinstimmen, können Sie den aggregierten Messwerts. Bei der Berechnung der aggregierten Messwerte versucht Search Ads 360, die Daten zu bereinigen. Quellen durch Entfernen von Conversions, die es vermutet, dass es sich um Duplikate handelt.

Was ist, wenn meine Frage hier nicht beantwortet wird?

Wenn Sie ein Problem haben, das Sie nach dem Lesen der Ressourcen auf dieser Website nicht lösen können, wenden Sie sich an den Support und bitten Sie folgende Informationen bereit:

  • ID der Search Ads 360-Agentur und des Werbetreibenden, auf die Sie zugreifen möchten

  • Projektnummer aus der Google API Console

  • Der Nutzername des Google-Kontos, mit dem Sie auf die API zugreifen.
    Dies ist das Konto, dem die Berechtigung, auf Search Ads 360 zuzugreifen, das Konto, das Sie auch für Richten Sie die Autorisierung ein.

  • Code-Snippet Ihrer Anfrage

  • JSON-Antwort
    Wenn es sich bei der Antwort um einen Fehler handelt, geben Sie die Fehlermeldung an, nicht nur numerischer Fehlercode.