Berichte zu Kampagnen- und Anzeigengruppenzielen erstellen

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität, um benutzerdefinierte Berichte zu erstellen und die Daten in Ihre Berichtsanwendungen und -prozesse zu integrieren. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zu ihrer Verwendung

Ziele sind Kriterien für die Auslieferung von Anzeigen, die auf Standort, demografischen Merkmalen und anderen Merkmalen einer Suchanfrage basieren. Ein Werbetreibender kann beispielsweise festlegen, dass die Anzeigen einer Kampagne nur in New York, Boston und Chicago ausgeliefert werden. Oder ein Werbetreibender kann die Gebote für Suchanfragen von Mitgliedern einer bestimmten Werbezielgruppe erhöhen und so die Wahrscheinlichkeit erhöhen, dass die Anzeige für diese Zielgruppe ausgeliefert wird.

Einige Arten von Zielen können nur auf Kampagnen, andere nur auf Anzeigengruppen angewendet werden. Informationen zu den auf den einzelnen Ebenen verfügbaren Zielen finden Sie in der Dokumentation zu den Berichten campaignTarget und adGroupTarget.

Sie können Berichte anfordern, die Leistungsmesswerte für bestimmte Zieltypen enthalten. Wenn ein Werbetreibender beispielsweise eine Kampagne auf geografische Standorte ausrichtet, schließen Sie die Spalte locationTargetName in eine campaignTarget-Anfrage ein. Wenn Sie den generierten Bericht abrufen, sehen Sie die Leistung der Kampagne in den einzelnen Zielregionen.

Auszuschließende Ziele

Mit auszuschließenden Zielen wird verhindert, dass Anzeigen ausgeliefert werden, wenn Suchanfragen bestimmte Kriterien erfüllen. Ähnlich wie Ziele können einige Arten von auszuschließenden Zielen nur auf Kampagnen angewendet werden, andere nur auf Anzeigengruppen. Weitere Informationen finden Sie unter negativeCampaignTarget und negativeAdGroupTarget.

Sie können Berichte anfordern, um die Kriterien zu sehen, anhand derer auszuschließende Ziele Anzeigen ausschließen. Wenn ein Werbetreibender beispielsweise auszuschließende Ziele verwendet, um zu verhindern, dass in einer Kampagne Anzeigen an bestimmten geografischen Standorten ausgeliefert werden, schließen Sie die Spalte locationTargetName in eine negativeCampaignTarget-Anfrage ein. Wenn Sie den generierten Bericht abrufen, sehen Sie eine Liste der Standorte, die von der Kampagne ausgeschlossen sind.

Beispielanfragen

Hier sehen Sie Beispielanfragen für verschiedene Arten von Zielen:

Berichte zu geografischen Zielen in einer Kampagne erstellen

Im folgenden Beispiel für eine asynchrone Anfrage wird die Anzahl der Klicks, Impressionen und anderer Daten für geografische Ziele zurückgegeben. Berichte für geografische Ziele sind nur für Google Ads-Kampagnen verfügbar. Search Ads 360 unterstützt verschiedene Arten von geografischen Zielen, z. B. geografische Ziele, Umgebungen und Umkreisziele für Google Ads-Standorterweiterungen. Berichte für geografische Ziele enthalten Daten für alle Arten von geografischen Zielen, die innerhalb des Berichtsumfangs angewendet werden.

Beispielanfrage

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Beispielbericht

Hier ein Beispiel für einen campaignTarget-Bericht. Der Bericht zeigt die Leistung für ein geografisches Ziel, das „US“ angibt, ein Umgebungsziel mit einem Wert von „160,0 Meilen im Umkreis (37.4220041,-122.0862462)“ und ein weiteres geografisches Ziel, das eine US-Postleitzahl (90210) angibt:

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

Remarketing-Ziele für alle Anzeigengruppen in einem Konto

In der folgenden asynchronen Anfrage werden die Anzahl der Klicks, Impressionen und andere Daten für alle Remarketing-Ziele zurückgegeben, die für Anzeigengruppen in einer bestimmten Google Ads-Kampagne definiert sind.

Beispielanfrage

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Beispielbericht

Hier ein Beispiel für einen adGroupTarget-Bericht. Dem Bericht können Sie entnehmen, dass in der Kampagne „Accessories“ für drei Anzeigengruppen Remarketing-Ziele definiert werden. Leistungsmesswerte für die einzelnen Remarketing-Ziele sind ebenfalls enthalten:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

Dynamische Anzeigenziele für alle Anzeigengruppen in einem Konto

Ein dynamisches Anzeigenziel legt Seiten auf Ihrer Website fest, für die Sie mit dynamischen Suchanzeigen werben möchten. Dynamische Anzeigenziele sind nur in Google Ads-Engine-Konten verfügbar und werden immer in bestimmten Anzeigengruppen erstellt. Anhand des Suchindex von Google wird ermittelt, ob die Suchanfrage eines Nutzers für Seiten relevant ist, die mit Ihren dynamischen Anzeigenzielen übereinstimmen. Wenn eine Suchanfrage relevant ist, zeigt Google eine dynamische Suchanzeige an, die Sie in derselben Anzeigengruppe wie die Ziele definiert haben.

Die folgende asynchrone Anfrage gibt die Anzahl der Klicks, Impressionen und andere Daten für alle dynamischen Anzeigenziele zurück, die für Anzeigengruppen in einem Engine-Konto definiert sind.

Beispielanfrage

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Beispielbericht

Hier ein Beispiel für einen adGroupTarget-Bericht. Der Bericht zeigt, dass eine Anzeigengruppe in der Kampagne „Google Stores“ ein dynamisches Anzeigenziel definiert. Leistungsmesswerte für das Ziel sind ebenfalls enthalten:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

Berichte zu auszuschließenden geografischen Zielen für Kampagnen erstellen

Im folgenden Beispiel für eine asynchrone Anfrage werden die Standorte zurückgegeben, die von Kampagnen in einem Engine-Konto ausgeschlossen sind. Berichte für auszuschließende geografische Ziele sind nur für Google Ads-Kampagnen verfügbar. Für auszuschließende geografische Ziele werden nur geografische Ziele als Kriterien verwendet. Sie können keine Umgebungen oder umkreisbezogenen Ziele festlegen. Berichte für auszuschließende geografische Ziele enthalten daher nur die Liste der Standorte, die von Kampagnen innerhalb des Berichtsumfangs ausgeschlossen werden.

In einer Anforderung für einen Bericht zu auszuschließenden Zielen muss kein Zeitraum angegeben werden. Bei auszuschließenden Berichten werden immer die aktuellen Einstellungen zurückgegeben. Es ist beispielsweise nicht möglich, einen Bericht anzufordern, der die im letzten Quartal verwendeten auszuschließenden Ziele enthält.

Beispielanfrage

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Beispielbericht

Hier ein Beispiel für einen negativeCampaignTarget-Bericht. Der Bericht zeigt, dass die Kampagne „Große Eröffnungen – NE“ den Bundesstaat Maine ausschließt und die Kampagne „Großeröffnungen – West“ den Bundesstaat Kalifornien ausschließt:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA