- Ressource: Kampagne
- CampaignGoal
- CampaignGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Methoden
Ressource: Kampagne
Eine einzelne Kampagne.
JSON-Darstellung |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe Der Ressourcenname der Kampagne. |
advertiserId |
Nur Ausgabe Die eindeutige ID des Werbetreibenden, zu dem die Kampagne gehört. |
campaignId |
Nur Ausgabe Die eindeutige ID der Kampagne. Vom System zugewiesen. |
displayName |
Erforderlich. Der Anzeigename der Kampagne. Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. |
entityStatus |
Erforderlich. Steuert, ob die Anzeigenaufträge in dieser Kampagne ihr Budget ausgeben und auf Inventar bieten können.
|
updateTime |
Nur Ausgabe Der Zeitstempel des Zeitpunkts, zu dem die Kampagne zuletzt aktualisiert wurde Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
campaignGoal |
Erforderlich. Das Zielvorhaben der Kampagne. |
campaignFlight |
Erforderlich. Die geplanten Ausgaben und die geplante Dauer der Kampagne. |
frequencyCap |
Erforderlich. Die Einstellung für das Frequency Capping der Kampagne. |
campaignBudgets[] |
Die Liste der Budgets, die für diese Kampagne verfügbar sind. Wenn dieses Feld nicht festgelegt ist, wird für die Kampagne ein unbegrenztes Budget verwendet. |
CampaignGoal
Einstellungen, mit denen das Zielvorhaben einer Kampagne festgelegt wird.
JSON-Darstellung |
---|
{ "campaignGoalType": enum ( |
Felder | |
---|---|
campaignGoalType |
Erforderlich. Der Typ des Zielvorhabens der Kampagne. |
performanceGoal |
Erforderlich. Das Leistungsziel der Kampagne. Zulässige Werte für
|
CampaignGoalType
Mögliche Arten von Zielvorhaben der Kampagne.
Enums | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
Der Zielvorhabenwert ist in dieser Version nicht angegeben oder unbekannt. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
Mehr App-Installationen oder -Interaktionen erzielen |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
Bekanntheit einer Marke oder eines Produkts steigern |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
Offline- oder Offlineumsätze steigern |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
Sie möchten mehr Onlineaktionen oder Besuche im Internet erzielen. |
CampaignFlight
Einstellungen, mit denen die geplanten Ausgaben und die Dauer einer Kampagne erfasst werden.
JSON-Darstellung |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
Felder | |
---|---|
plannedSpendAmountMicros |
Der Betrag, den die Kampagne voraussichtlich für den angegebenen Der Betrag wird in Mikros angegeben. muss größer oder gleich 0 sein. Beispiel: 500000000 steht für 500 Standardeinheiten der Währung. |
plannedDates |
Erforderlich. Der Zeitraum, in dem die Kampagne voraussichtlich laufen wird. Sie werden relativ zur Zeitzone des übergeordneten Werbetreibenden aufgelöst.
|
CampaignBudget
Einstellungen für die Zuweisung des Kampagnenbudgets.
JSON-Darstellung |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
Felder | |
---|---|
budgetId |
Die eindeutige ID des Kampagnenbudgets. Vom System zugewiesen. Legen Sie ihn nicht für neue Budgets fest. Muss enthalten sein, wenn Budgets zu „ |
displayName |
Erforderlich. Der Anzeigename des Budgets. Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. |
budgetUnit |
Erforderlich. Nicht veränderbar. Gibt an, ob das Budget in einer Währung oder in Impressionen gemessen wird. |
budgetAmountMicros |
Erforderlich. Der Gesamtbetrag, der für die verknüpften Segmente des Anzeigenauftrags ein Budget zugewiesen werden kann. Der Betrag wird in Mikros angegeben. Muss größer als 0 sein. Beispiel: 500000000 steht für 500 Standardeinheiten der Währung. |
dateRange |
Erforderlich. Der Zeitraum für das Kampagnenbudget. Verknüpfte Budgetsegmente können einen anderen Zeitraum haben. Sie werden relativ zur Zeitzone des übergeordneten Werbetreibenden aufgelöst. Sowohl |
externalBudgetSource |
Erforderlich. Die externe Quelle des Budgets. |
externalBudgetId |
Nicht veränderbar. Die ID, mit der dieses Budget der externen Quelle zugeordnet wird. Wenn dieses Feld ausgefüllt und die Rechnungsdetailebene des entsprechenden Abrechnungsprofils auf „Bestellung auf Budgetebene“ festgelegt ist, wird diese ID bei allen Impressionen, die für dieses Budget erzielt werden, auf der Rechnung aufgeführt. Muss innerhalb der Kampagne eindeutig sein. |
invoiceGroupingId |
Nicht veränderbar. Die ID zur Gruppierung von Budgets, die in derselben Rechnung enthalten sein sollen. Wenn dieses Feld ausgefüllt und die Rechnungsebene des entsprechenden Abrechnungsprofils auf „ID der Rechnungsgruppierung für Budget“ festgelegt ist, werden alle |
prismaConfig |
Zusätzliche Metadaten zur Verwendung mit dem Tool Mediaocean Prisma. Erforderlich für Mediaocean-Budgets. Gilt nur für |
ExternalBudgetSource
Externe Quelle für ein Kampagnenbudgetsegment.
Enums | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
Der Wert der externen Budgetquelle ist in dieser Version nicht angegeben oder unbekannt. |
EXTERNAL_BUDGET_SOURCE_NONE |
Das Budget hat keine externe Quelle. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
Die Budgetquelle ist Mediaocean. |
PrismaConfig
Spezifische Einstellungen für das Mediaocean Prisma-Tool.
JSON-Darstellung |
---|
{ "prismaType": enum ( |
Felder | |
---|---|
prismaType |
Erforderlich. Prisma-Typ. |
prismaCpeCode |
Erforderlich. Relevante Kunden-, Produkt- und Schätzungscodes aus dem Mediaocean Prisma-Tool. |
supplier |
Erforderlich. Die Entität, die dieses Budget zugewiesen hat (DSP, Website usw.). |
PrismaType
Mögliche Typen für ein Prisma-Budget.
Enums | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
Der Typ ist in dieser Version nicht angegeben oder unbekannt. |
PRISMA_TYPE_DISPLAY |
Anzeigetyp. |
PRISMA_TYPE_SEARCH |
Suchtyp. |
PRISMA_TYPE_VIDEO |
Videotyp. |
PRISMA_TYPE_AUDIO |
Audiotyp. |
PRISMA_TYPE_SOCIAL |
Typ der sozialen Interaktion. |
PRISMA_TYPE_FEE |
Gebührentyp. |
PrismaCpeCode
Das Google-Zahlungscenter unterstützt das Suchen und Filtern der Komponentenfelder dieses Codes.
JSON-Darstellung |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
Felder | |
---|---|
prismaClientCode |
Prisma-Clientcode |
prismaProductCode |
Prisma-Produktcode |
prismaEstimateCode |
Prisma-Schätzungscode. |
Methoden |
|
---|---|
|
Erstellt eine neue Kampagne. |
|
Löscht eine Kampagne endgültig. |
|
Ruft eine Kampagne ab. |
|
Listet die Kampagnen eines Werbetreibenden auf. |
|
Listet die zugewiesenen Targeting-Optionen einer Kampagne für verschiedene Targeting-Typen auf. |
|
Damit wird eine bestehende Kampagne aktualisiert. |