- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CampaignDuration
- FrequencyCap
- EffectiveFrequencyLimit
- Ausrichtung
- AudienceTargeting
- PlannedProduct
- AdvancedProductTargeting
- TargetFrequencySettings
- YouTubeSelectSettings
- ForecastMetricOptions
- OnTargetAudienceMetrics
- ReachCurve
- ReachForecast
- Prognose
- EffectiveFrequencyBreakdown
- PlannedProductReachForecast
- PlannedProductForecast
- Testen!
Erstellt eine Reichweitenprognose für eine bestimmte Targeting-/Produktkombination.
Liste der ausgelösten Fehler: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError ReachPlanError RequestError
HTTP-Anfrage
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateReachForecast
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
customerId |
Erforderlich. Die ID des Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "campaignDuration": { object ( |
Felder | |
---|---|
campaignDuration |
Erforderlich. Kampagnendauer |
cookieFrequencyCapSetting |
Sie haben das Frequency Capping für Cookies ausgewählt, das auf jedes geplante Produkt angewendet werden soll. Dieser Wert entspricht dem Frequency Capping, das in Google Ads beim Erstellen einer Kampagne angewendet wird. Er gibt an, wie oft eine Anzeige demselben Nutzer innerhalb eines bestimmten Zeitintervalls maximal präsentiert werden kann. Wenn keine Angabe erfolgt, wird der Standardwert 0 (keine Begrenzung) angewendet. Dieses Feld ersetzt das eingestellte Feld „cookieFrequencyCap“. |
targeting |
Das Targeting, das auf alle in der Kombination ausgewählten Produkte angewendet werden soll. Dies ist die geplante Ausrichtung. Die Ausführungsdetails können je nach Werbeprodukt variieren. Wenden Sie sich an einen Implementierungsexperten. Informationen zu den Auswirkungen des Targetings auf die spezifischen Messwerte erhalten Sie unter den jeweiligen Messwerten. |
plannedProducts[] |
Erforderlich. Die zu prognostizierenden Produkte. Die maximal zulässige Anzahl von geplanten Produkten ist 15. |
forecastMetricOptions |
Steuert die in der Antwort zurückgegebenen Prognosemesswerte. |
currencyCode |
Der Währungscode. Dreistelliger Währungscode gemäß ISO 4217. |
cookieFrequencyCap |
Sie haben das Frequency Capping für Cookies ausgewählt, das auf jedes geplante Produkt angewendet werden soll. Dieser Wert entspricht dem Frequency Capping, das in Google Ads beim Erstellen einer Kampagne angewendet wird. Er gibt an, wie oft eine Anzeige demselben Nutzer maximal präsentiert werden kann. Wenn keine Angabe erfolgt, wird keine Begrenzung angewendet. Dieses Feld ist veraltet und wird in v4 entfernt. Verwenden Sie stattdessen cookieFrequencyCapSetting. |
minEffectiveFrequency |
Die ausgewählte minimale effektive Häufigkeit (wie oft eine Person die Anzeige gesehen hat) für die gemeldeten Reichweitenmesswerte [1–10]. Dies wirkt sich nicht auf das Targeting aus, sondern nur auf die Berichte. Wenn keine Angabe erfolgt, wird der Standardwert 1 angewendet. Dieses Feld kann nicht mit dem Feld „effectiveFrequencyLimit“ kombiniert werden. |
effectiveFrequencyLimit |
Der höchste Wert für die minimale effektive Häufigkeit (wie oft eine Person eine Anzeige gesehen hat) [1–10], der in „ Forecast.effective_frequency_breakdowns“ einbezogen wird. Wenn nicht angegeben, wird „ Forecast.effective_frequency_breakdowns“ nicht angegeben. Der hier angegebene Wert für die effektive Häufigkeit wird auch als minimale effektive Häufigkeit für die gemeldeten Messwerte zur Reichweite verwendet. Dieses Feld kann nicht mit dem Feld „minEffectiveFrequency“ kombiniert werden. |
customerReachGroup |
Der Name des Kunden, für den Sie in der Planung sind. Dies ist ein benutzerdefinierter Wert. |
Antworttext
Antwortnachricht mit der generierten Reichweitenkurve.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "onTargetAudienceMetrics": { object ( |
Felder | |
---|---|
onTargetAudienceMetrics |
Referenz zu Zielgruppen für diese Kurve. |
reachCurve |
Das generierte Reichweitendiagramm für die geplante Kombination. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
CampaignDuration
Die Dauer einer geplanten Kampagne.
JSON-Darstellung |
---|
{
"dateRange": {
object ( |
Felder | |
---|---|
dateRange |
Zeitraum der Kampagne. Datumsangaben werden im Format jjjj-mm-tt angegeben. Das Enddatum muss maximal 1 Jahr in der Zukunft liegen und der Zeitraum darf maximal 92 Tage umfassen. Dieses Feld kann nicht mit dem Feld „durationInDays“ kombiniert werden. |
durationInDays |
Der Wert für die Dauer in Tagen. Dieses Feld kann nicht mit dem dateRange-Feld kombiniert werden. |
FrequencyCap
Eine Regel, die angibt, wie oft eine Anzeige einem Nutzer innerhalb eines bestimmten Zeitraums maximal präsentiert werden kann.
JSON-Darstellung |
---|
{
"impressions": integer,
"timeUnit": enum ( |
Felder | |
---|---|
impressions |
Erforderlich. Die Anzahl der Impressionen (einschließlich). |
timeUnit |
Erforderlich. Der Typ der Zeiteinheit. |
EffectiveFrequencyLimit
Effektives Frequenzlimit.
JSON-Darstellung |
---|
{ "effectiveFrequencyBreakdownLimit": integer } |
Felder | |
---|---|
effectiveFrequencyBreakdownLimit |
Der höchste Wert für die effektive Häufigkeit, der in „Prognose.effective_frequency_breakdowns“ aufgenommen wird. Dieses Feld unterstützt Häufigkeiten von 1 bis 10 (einschließlich). |
Targeting
Das Targeting, für das Traffic-Messwerte erfasst werden.
JSON-Darstellung |
---|
{ "plannableLocationIds": [ string ], "ageRange": enum ( |
Felder | |
---|---|
plannableLocationIds[] |
Die Liste der planbaren Standort-IDs, auf die diese Prognose ausgerichtet werden soll. Wenn mehr als eine ID angegeben ist, müssen alle IDs denselben Für Anfragen muss entweder dieses Feld oder |
ageRange |
Zielaltersgruppe. Ein nicht festgelegter Wert entspricht der Ausrichtung auf alle Altersgruppen. |
genders[] |
Ausrichtung auf Geschlechter. Ein nicht festgelegter Wert entspricht dem Targeting auf MALE und FEMALE. |
devices[] |
Zielgeräte. Falls nicht angegeben, erfolgt die Ausrichtung auf alle anwendbaren Geräte. Die verfügbaren Geräte variieren je nach Produkt und Region und sind bei |
network |
Netzwerk für das Anzeigenprodukt, auf das ein Targeting möglich ist. Falls nicht angegeben, erfolgt die Ausrichtung auf alle anwendbaren Netzwerke. Die verfügbaren Netzwerke variieren je nach Produkt und Region. Sie erhalten sie unter |
audienceTargeting |
Zielgruppen. Ist nicht angegeben, erfolgt keine Ausrichtung auf eine bestimmte Zielgruppe. |
plannableLocationId |
Die ID des ausgewählten Standorts. Geplante Standort-IDs finden Sie unter Für Anfragen muss entweder dieses Feld oder Dieses Feld wird ab Version 12 nicht mehr unterstützt und in einer zukünftigen Version entfernt. Verwenden Sie stattdessen |
AudienceTargeting
Ausrichtung auf Zielgruppen für Prognose zur Reichweite.
JSON-Darstellung |
---|
{
"userInterest": [
{
object ( |
Felder | |
---|---|
userInterest[] |
Liste der Zielgruppen basierend auf Nutzerinteressen für die Ausrichtung. |
PlannedProduct
Ein Produkt, für das eine größere Reichweite geplant ist
JSON-Darstellung |
---|
{
"advancedProductTargeting": {
object ( |
Felder | |
---|---|
advancedProductTargeting |
Targeting-Einstellungen für das ausgewählte Produkt. Verwenden Sie |
plannableProductCode |
Erforderlich. Für die Planung ausgewähltes Produkt. Der mit dem Anzeigenprodukt verknüpfte Code (z. B. TrueView, Bumper). Verwenden Sie |
budgetMicros |
Erforderlich. Maximale Budgetzuweisung in Mikroeinheiten für das ausgewählte Produkt. Der Wert wird im ausgewählten Währungscode für die Planung angegeben. Beispiel: 1 000 000$ = 1 000 000 000 000 micros. |
AdvancedProductTargeting
Erweiterte Ausrichtungseinstellungen für Produkte.
JSON-Darstellung |
---|
{ "surfaceTargetingSettings": { object ( |
Felder | |
---|---|
surfaceTargetingSettings |
Ausrichtungseinstellungen für dieses Produkt. |
targetFrequencySettings |
Einstellungen für eine Kampagne mit dem Zielvorhaben „Angestrebte Häufigkeit“. Muss bei Auswahl des Produkts TARGET_FREQUENCY festgelegt werden. Weitere Informationen zu Kampagnen mit der Gebotsstrategie „Angestrebte Häufigkeit“ finden Sie unter https://support.google.com/google-ads/answer/12400225. |
Union-Feld advanced_targeting . Ausrichtungsoptionen für dieses Produkt. Für advanced_targeting ist nur einer der folgenden Werte zulässig: |
|
youtubeSelectSettings |
Einstellungen für das YouTube Select-Targeting. |
TargetFrequencySettings
Einstellungen für die angestrebte Häufigkeit für ein unterstütztes Produkt.
JSON-Darstellung |
---|
{
"timeUnit": enum ( |
Felder | |
---|---|
timeUnit |
Erforderlich. Die Zeiteinheit, mit der der Zeitrahmen für „targetFrequency“ beschrieben wird. |
targetFrequency |
Erforderlich. Das Ziel für die angestrebte Häufigkeit pro ausgewählter Zeiteinheit. |
YouTubeSelectSettings
Einstellungen für YouTube Select-Pakete anfordern
JSON-Darstellung |
---|
{ "lineupId": string } |
Felder | |
---|---|
lineupId |
Paket für YouTube Select-Targeting. |
ForecastMetricOptions
Steuert die zurückzugebenden Prognosemesswerte.
JSON-Darstellung |
---|
{ "includeCoview": boolean } |
Felder | |
---|---|
includeCoview |
Gibt an, ob Co-Viewing-Messwerte in die Antwortprognose einbezogen werden sollen. |
OnTargetAudienceMetrics
Zielgruppenmesswerte für die geplanten Produkte. Bei diesen Messwerten werden die folgenden Targeting-Dimensionen berücksichtigt:
- Standort
- PlannableAgeRange
- Geschlecht
- Zielgruppen-Targeting (nur für youtubeAudienceSize)
JSON-Darstellung |
---|
{ "youtubeAudienceSize": string, "censusAudienceSize": string } |
Felder | |
---|---|
youtubeAudienceSize |
Die Größe der Referenzzielgruppe entspricht dem berücksichtigten Targeting für YouTube. |
censusAudienceSize |
Die Größe der Referenzzielgruppe stimmt mit dem Targeting für die Volkszählung überein. |
ReachCurve
Das Kurvendiagramm mit Messwerten zur Reichweite für die geplanten Produkte.
JSON-Darstellung |
---|
{
"reachForecasts": [
{
object ( |
Felder | |
---|---|
reachForecasts[] |
Alle Punkte auf der Reichweitenkurve. |
ReachForecast
Eine Reichweitenkurve für einen Punkt.
JSON-Darstellung |
---|
{ "costMicros": string, "forecast": { object ( |
Felder | |
---|---|
costMicros |
Die Kosten in Mikroeinheiten. |
forecast |
Prognostizierte Traffic-Messwerte für diesen Punkt. |
plannedProductReachForecasts[] |
Die prognostizierten Zuordnungs- und Traffic-Messwerte für jedes geplante Produkt an diesem Punkt auf der Reichweitenkurve. |
Prognose
Messwerte zu prognostizierten Zugriffen für die geplanten Produkte und die Ausrichtung
JSON-Darstellung |
---|
{
"effectiveFrequencyBreakdowns": [
{
object ( |
Felder | |
---|---|
effectiveFrequencyBreakdowns[] |
Eine Liste von Prognosen zur effektiven Häufigkeit. Die Liste ist geordnet und beginnt mit 1+ und endet mit dem Wert, der in GenerateReachReachRequest.effective_frequency_limit festgelegt wird. Wenn kein effektivesFrequencyLimit festgelegt wurde, ist diese Liste leer. |
onTargetReach |
Die Anzahl der einzelnen Nutzer, die mindestens so oft erreicht wurden, dass sie mit dem Targeting übereinstimmt: Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wird die Mindestanzahl nicht erreicht, wird der Wert für „onTargetReach“ auf 0 gerundet. |
totalReach |
Gesamtzahl der einzelnen Nutzer, die mindestens „GenerateReachPrognoseRequest.min_effective_frequency“ oder GenerateReachMetricsRequest.effective_frequency_limit Mal erreicht werden. Dazu gehören auch Nutzer, die eventuell nicht in das angegebene Targeting fallen. Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wenn die Mindestanzahl nicht erreicht wird, wird der totalReach-Wert auf 0 gerundet. |
onTargetImpressions |
Anzahl der Anzeigenimpressionen, die genau mit dem Targeting übereinstimmen. |
totalImpressions |
Gesamtzahl der Anzeigenimpressionen Dazu gehören Impressionen, die aufgrund unzureichender Informationen über angemeldete Nutzer möglicherweise außerhalb des festgelegten Targetings liegen. |
viewableImpressions |
Gibt an, wie oft die Anzeigenimpressionen als sichtbar eingestuft wurden. Weitere Informationen dazu, was eine Anzeige sichtbar macht und wie die Sichtbarkeit gemessen wird, finden Sie unter https://support.google.com/google-ads/answer/7029393. |
onTargetCoviewReach |
Anzahl der einzelnen Nutzer, die erreicht wurden und genau mit dem Targeting übereinstimmen, einschließlich Co-Viewern. |
totalCoviewReach |
Anzahl der einzelnen Personen, die erreicht wurden, einschließlich Co-Viewern. Dazu gehören auch Nutzer, die eventuell nicht in das angegebene Targeting fallen. |
onTargetCoviewImpressions |
Anzahl der Anzeigenimpressionen, die genau mit dem Targeting übereinstimmen, einschließlich Co-Viewern. |
totalCoviewImpressions |
Gesamtzahl der Anzeigenimpressionen einschließlich Co-Viewern. Dazu gehören Impressionen, die aufgrund unzureichender Informationen über angemeldete Nutzer möglicherweise außerhalb des festgelegten Targetings liegen. |
views |
Anzahl der prognostizierten Anzeigenaufrufe für das angegebene Produkt und Targeting. Ein Aufruf wird gezählt, wenn ein Nutzer sich über die Impression hinaus einen größeren Teil oder die gesamte Anzeige ansieht. Weitere Informationen zu Datenansichten finden Sie unter https://support.google.com/google-ads/answer/2375431. |
EffectiveFrequencyBreakdown
Eine Aufschlüsselung der Anzahl einzelner Nutzer, die bei einer bestimmten effektiven Häufigkeit erreicht wurden.
JSON-Darstellung |
---|
{ "effectiveFrequency": integer, "onTargetReach": string, "totalReach": string, "effectiveCoviewReach": string, "onTargetEffectiveCoviewReach": string } |
Felder | |
---|---|
effectiveFrequency |
Die effektive Häufigkeit [1–10]. |
onTargetReach |
Die Anzahl der einzelnen Nutzer, die mindestens eine effektive Häufigkeit erreicht haben, die genau mit dem Targeting übereinstimmt. Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wird die Mindestanzahl nicht erreicht, wird der Wert für „onTargetReach“ auf 0 gerundet. |
totalReach |
Gesamtzahl der einzelnen Nutzer, die mindestens eine effektive Häufigkeit erreicht haben Dazu gehören auch Nutzer, die eventuell nicht in das angegebene Targeting fallen. Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wenn die Mindestanzahl nicht erreicht wird, wird der totalReach-Wert auf 0 gerundet. |
effectiveCoviewReach |
Die Anzahl der Nutzer (einschließlich Co-Viewing-Nutzer), die für den zugehörigen Wert „effectiveFrequency“ erreicht wurden. |
onTargetEffectiveCoviewReach |
Die Anzahl der Nutzer (einschließlich Co-Viewing-Nutzer), die für den verknüpften „effectiveFrequency“-Wert in der angegebenen demografischen Gruppe des Plans erreicht wurden. |
PlannedProductReachForecast
Die prognostizierten Zuordnungs- und Traffic-Messwerte für ein bestimmtes Produkt an einem Punkt auf der Reichweitenkurve.
JSON-Darstellung |
---|
{
"plannableProductCode": string,
"costMicros": string,
"plannedProductForecast": {
object ( |
Felder | |
---|---|
plannableProductCode |
Für die Planung ausgewähltes Produkt. Die zurückgegebenen Produktcodes gehören zu den Codes, die von ListPlannableProducts zurückgegeben werden, wenn dieselbe Standort-ID verwendet wird. |
costMicros |
Die Kosten in Mikroeinheiten. Diese kann von der eingegebenen Zuordnung des Produkts abweichen, wenn das Budget für ein oder mehrere geplante Produkte aufgrund von begrenztem Inventar nicht erfüllt werden kann. |
plannedProductForecast |
Prognostizierte Traffic-Messwerte für dieses Produkt. |
PlannedProductForecast
Prognostizierte Traffic-Messwerte für ein geplantes Produkt
JSON-Darstellung |
---|
{ "onTargetReach": string, "totalReach": string, "onTargetImpressions": string, "totalImpressions": string, "viewableImpressions": string, "onTargetCoviewReach": string, "totalCoviewReach": string, "onTargetCoviewImpressions": string, "totalCoviewImpressions": string, "averageFrequency": number, "views": string } |
Felder | |
---|---|
onTargetReach |
Anzahl der erreichten einzelnen Nutzer, die genau mit der Ausrichtung übereinstimmen. Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wird die Mindestanzahl nicht erreicht, wird der Wert für „onTargetReach“ auf 0 gerundet. |
totalReach |
Anzahl der erreichten einzelnen Nutzer Dazu gehören auch Nutzer, die eventuell nicht in das angegebene Targeting fallen. Beachten Sie, dass eine Mindestanzahl von einzelnen Personen erreicht werden muss, damit Daten gemeldet werden. Wenn die Mindestanzahl nicht erreicht wird, wird der totalReach-Wert auf 0 gerundet. |
onTargetImpressions |
Anzahl der Anzeigenimpressionen, die genau mit dem Targeting übereinstimmen. |
totalImpressions |
Gesamtzahl der Anzeigenimpressionen Dazu gehören Impressionen, die aufgrund unzureichender Informationen über angemeldete Nutzer möglicherweise außerhalb des festgelegten Targetings liegen. |
viewableImpressions |
Gibt an, wie oft die Anzeigenimpressionen als sichtbar eingestuft wurden. Weitere Informationen dazu, was eine Anzeige sichtbar macht und wie die Sichtbarkeit gemessen wird, finden Sie unter https://support.google.com/google-ads/answer/7029393. |
onTargetCoviewReach |
Anzahl der einzelnen Nutzer, die erreicht wurden und genau mit dem Targeting übereinstimmen, einschließlich Co-Viewern. |
totalCoviewReach |
Anzahl der einzelnen Personen, die erreicht wurden, einschließlich Co-Viewern. Dazu gehören auch Nutzer, die eventuell nicht in das angegebene Targeting fallen. |
onTargetCoviewImpressions |
Anzahl der Anzeigenimpressionen, die genau mit dem Targeting übereinstimmen, einschließlich Co-Viewern. |
totalCoviewImpressions |
Gesamtzahl der Anzeigenimpressionen einschließlich Co-Viewern. Dazu gehören Impressionen, die aufgrund unzureichender Informationen über angemeldete Nutzer möglicherweise außerhalb des festgelegten Targetings liegen. |
averageFrequency |
Gibt an, wie oft einem Nutzer eine Anzeige in einer ausgewählten Zeiteinheit präsentiert wird, gemittelt über die Anzahl der Zeiteinheiten der Prognosedauer. Dieses Feld wird nur bei einer Kampagne mit dem Zielvorhaben „Angestrebte Häufigkeit“ ausgefüllt. Weitere Informationen zu Kampagnen mit der Gebotsstrategie „Angestrebte Häufigkeit“ finden Sie unter https://support.google.com/google-ads/answer/12400225. |
views |
Anzahl der prognostizierten Anzeigenaufrufe für das angegebene Produkt und Targeting. Ein Aufruf wird gezählt, wenn ein Nutzer sich über die Impression hinaus einen größeren Teil oder die gesamte Anzeige ansieht. Weitere Informationen zu Datenansichten finden Sie unter https://support.google.com/google-ads/answer/2375431. |