- Ressource: Kampagne
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CampaignGoal
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CampaignGoalType
- CampaignFlight
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CampaignBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ExternalBudgetSource
- PrismaConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PrismaType
- PrismaCpeCode
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- 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. Damit wird gesteuert, ob die Anzeigenaufträge in dieser Kampagne ihr Budget ausgeben und auf Inventar bieten können.
|
updateTime |
Nur Ausgabe. Der Zeitstempel der letzten Aktualisierung der Kampagne. Vom System zugewiesen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
campaignGoal |
Erforderlich. Das Zielvorhaben der Kampagne. |
campaignFlight |
Erforderlich. Geplante Ausgaben und Dauer der Kampagne |
frequencyCap |
Erforderlich. Die Einstellung für das Frequency Capping der Kampagne. |
campaignBudgets[] |
Die Liste der für diese Kampagne verfügbaren Budgets. Ist dieses Feld nicht festgelegt, 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 Zielwert ist in dieser Version nicht angegeben oder unbekannt. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
Mehr App-Installationen oder -Interaktionen |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
Die Bekanntheit einer Marke oder eines Produkts steigern |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
Offline- oder Ladenumsatz steigern |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
Steigern Sie die Anzahl der Onlineaktionen oder -besuche. |
CampaignFlight
Einstellungen, mit denen die geplanten Ausgaben und die Dauer einer Kampagne verfolgt werden.
JSON-Darstellung |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
Felder | |
---|---|
plannedSpendAmountMicros |
Der Betrag, der voraussichtlich für die Kampagne für die angegebene 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 läuft. Sie werden in Abhängigkeit von der Zeitzone des übergeordneten Werbetreibenden aufgelöst.
|
CampaignBudget
Einstellungen, mit denen festgelegt wird, wie das Kampagnenbudget zugewiesen wird.
JSON-Darstellung |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
Felder | |
---|---|
budgetId |
Die eindeutige ID des Kampagnenbudgets. Vom System zugewiesen. Legen Sie keine neuen Budgets fest. Muss beim Aktualisieren oder Hinzufügen von 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 der Währung oder in Impressionen gemessen wird. |
budgetAmountMicros |
Erforderlich. Das ist der Gesamtbetrag, der für die verknüpften Anzeigenauftragssegmente budgetiert 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 haben möglicherweise einen anderen Zeitraum. Sie werden in Abhängigkeit von der Zeitzone des übergeordneten Werbetreibenden aufgelöst. Sowohl |
externalBudgetSource |
Erforderlich. Die externe Quelle des Budgets. |
externalBudgetId |
Nicht veränderbar. Die ID, mit der dieses Budget für die externe Quelle identifiziert wird. Wenn dieses Feld festgelegt ist und die Rechnungsdetailebene des entsprechenden Abrechnungsprofils auf „Auftrag auf Budgetebene“ gesetzt ist, wird diese ID für alle Impressionen, die für dieses Budget erzielt wurden, auf der Rechnung verwendet. Darf innerhalb der Kampagne nur einmal vorkommen. |
invoiceGroupingId |
Nicht veränderbar. Die ID, mit der Budgets in derselben Rechnung gruppiert werden. Wenn dieses Feld festgelegt und die Rechnungsebene des entsprechenden Abrechnungsprofils auf „ID der Budgetrechnungsgruppe“ festgelegt ist, werden alle |
prismaConfig |
Zusätzliche Metadaten zur Verwendung durch das 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 |
Budgetquelle ist Mediaocean. |
PrismaConfig
Spezifische Einstellungen für das Tool „Mediaocean Prisma“.
JSON-Darstellung |
---|
{ "prismaType": enum ( |
Felder | |
---|---|
prismaType |
Erforderlich. Der 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 |
Displaytyp. |
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 |
Der Prisma-Clientcode. |
prismaProductCode |
Der Prisma-Produktcode |
prismaEstimateCode |
Der 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 zugewiesene Targeting-Optionen einer Kampagne für alle Targeting-Typen auf. |
|
Aktualisiert eine bestehende Kampagne. |