REST Resource: advertisers.campaigns

Zasób: kampania

Pojedyncza kampania.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu kampanii.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy kampania.
campaignId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator kampanii. Przypisana przez system.
displayName

string

Wymagane. Wyświetlana nazwa kampanii.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.
entityStatus

enum (EntityStatus)

Wymagane. Określa, czy zamówienia reklamowe w ramach tej kampanii mogą wydawać budżety i ustalać stawki za zasoby reklamowe.

  • Akceptowane wartości to ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED i ENTITY_STATUS_PAUSED.
  • W metodzie campaigns.create wartość ENTITY_STATUS_ARCHIVED jest niedozwolona.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji kampanii. Przypisana przez system.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
campaignGoal

object (CampaignGoal)

Wymagane. Cel kampanii.
campaignFlight

object (CampaignFlight)

Wymagane. Planowane wydatki i czas trwania kampanii.
frequencyCap

object (FrequencyCap)

Wymagane. Ustawienie limitu wyświetleń na użytkownika w kampanii.
campaignBudgets[]

object (CampaignBudget)

Lista budżetów dostępnych w tej kampanii.

Jeśli to pole nie jest skonfigurowane, kampania używa nieograniczonego budżetu.

CampaignGoal

Ustawienia, które pozwalają określić cel kampanii.

Zapis JSON 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
Pola
campaignGoalType

enum (CampaignGoalType)

Wymagane. Typ celu kampanii.
performanceGoal

object (PerformanceGoal)

Wymagane. Docelowa skuteczność kampanii.

Akceptowane wartości w polu performanceGoalType:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

Możliwe typy celów kampanii.

Wartości w polu enum
CAMPAIGN_GOAL_TYPE_UNSPECIFIED Wartość celu nie jest określona lub nieznana w tej wersji.
CAMPAIGN_GOAL_TYPE_APP_INSTALL Zwiększanie liczby instalacji aplikacji lub zaangażowania.
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS Zwiększenie świadomości marki lub produktu.
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION Zwiększenie sprzedaży offline lub sprzedaży w sklepie stacjonarnym.
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION Zwiększenie liczby działań online lub wizyt.

PerformanceGoal

Ustawienia, które kontrolują docelową skuteczność kampanii.

Zapis JSON 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
Pola
performanceGoalType

enum (PerformanceGoalType)

Wymagane. Typ celu dotyczącego skuteczności.
Pole sumy performance_goal_value. Wymagane. Wartość docelowej skuteczności odpowiadającej danej wartości performance_goal_type. performance_goal_value może mieć tylko jedną z tych wartości:
performanceGoalAmountMicros

string (int64 format)

Kwota docelowa w milionowych częściach waluty reklamodawcy.

Ma zastosowanie, gdy performanceGoalType należy do jednej z tych kategorii:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

Na przykład 1500000 oznacza 1,5 standardowej jednostki waluty.
performanceGoalPercentageMicros

string (int64 format)

Wartość dziesiętna określająca odsetek celu w mikro.

Ma zastosowanie, gdy performanceGoalType należy do jednej z tych kategorii:

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

Na przykład 70 000 oznacza 7% (0, 07 w formacie dziesiętnym).
performanceGoalString

string

Ciąg tekstowy kluczowego wskaźnika wydajności (KPI), który może być pusty. Musi być zakodowany w formacie UTF-8 i nie może być dłuższy niż 100 znaków.

Ma zastosowanie, gdy zasada performanceGoalType ma wartość PERFORMANCE_GOAL_TYPE_OTHER.

PerformanceGoalType

Możliwe typy celów związanych ze skutecznością.

Wartości w polu enum
PERFORMANCE_GOAL_TYPE_UNSPECIFIED Typ celu dotyczącego skuteczności nie został określony lub jest nieznany w tej wersji.
PERFORMANCE_GOAL_TYPE_CPM Docelową skuteczność określa się jako CPM (koszt tysiąca wyświetleń).
PERFORMANCE_GOAL_TYPE_CPC Docelową skuteczność określa się według kosztu kliknięcia (CPC).
PERFORMANCE_GOAL_TYPE_CPA Cel dotyczący skuteczności jest określany jako CPA (koszt działania).
PERFORMANCE_GOAL_TYPE_CTR Docelową skuteczność określa się jako wartość procentową CTR (współczynnika klikalności).
PERFORMANCE_GOAL_TYPE_VIEWABILITY Docelową skuteczność określa się jako wartość procentową widoczności.
PERFORMANCE_GOAL_TYPE_CPIAVC Cel dotyczący skuteczności jest ustawiony jako CPIAVC (koszt wyświetlenia z włączonym dźwiękiem i widocznym w momencie zakończenia).
PERFORMANCE_GOAL_TYPE_CPE Cel dotyczący skuteczności jest określany w CPE (koszt zaangażowania).
PERFORMANCE_GOAL_TYPE_CLICK_CVR Cel dotyczący skuteczności jest podawany w procentach współczynnika konwersji po kliknięciu (konwersji na kliknięcie).
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR Cel dotyczący skuteczności jest określany jako procent współczynnika konwersji wyświetleń (konwersji na wyświetlenie).
PERFORMANCE_GOAL_TYPE_VCPM Docelową skuteczność określa się w modelu VCPM (koszt tysiąca widocznych wyświetleń).
PERFORMANCE_GOAL_TYPE_VTR Docelową skuteczność określa się jako wartość procentową współczynnika obejrzeń w YouTube (wyświetleń w YouTube na wyświetlenie).
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE Cel dotyczący skuteczności jest określany jako wartość procentowa współczynnika pełnych odtworzeń dźwięku (pełnych odsłuchań na wyświetlenie).
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE Docelową skuteczność określa się jako wartość procentową współczynnika pełnych obejrzeń (pełnego obejrzenia filmu na wyświetlenie).
PERFORMANCE_GOAL_TYPE_OTHER Cel skuteczności to Inne.

CampaignFlight

Ustawienia do śledzenia planowanych wydatków i czasu trwania kampanii.

Zapis JSON 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
Pola
plannedSpendAmountMicros

string (int64 format)

Kwota, jaką kampania ma wydać w przypadku określonych plannedDates. Nie ograniczy to wyświetlania, ale będzie służyć do śledzenia wydatków w interfejsie DV360.

Ilość jest wyrażona w mikro. Wartość nie może być mniejsza niż 0. Na przykład 500000000 oznacza 500 standardowych jednostek waluty.
plannedDates

object (DateRange)

Wymagane. Przewidywane daty trwania kampanii. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego.

  • Podane tu daty nie wpłyną na wyświetlanie reklam. Służą do generowania alertów i ostrzeżeń. Jeśli na przykład data wyświetlania jakiegokolwiek podrzędnego zamówienia reklamowego wykracza poza zakres tych dat, w interfejsie pojawi się ostrzeżenie.
  • Pole startDate jest wymagane i musi być bieżącą lub późniejszą datą.
  • Pole endDate jest opcjonalne. Jeśli została określona, musi to być startDate lub nowsza.
  • Każda podana data musi przypadać przed rokiem 2037.

CampaignBudget

Ustawienia, które określają sposób przydzielania budżetu kampanii.

Zapis JSON 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
Pola
budgetId

string (int64 format)

Unikalny identyfikator budżetu kampanii. Przypisana przez system. Nie ustawiaj dla nowych budżetów.

Trzeba go uwzględnić przy aktualizowaniu lub dodawaniu budżetów do kampanii campaignBudgets. W przeciwnym razie zostanie wygenerowany i przypisany nowy identyfikator.
displayName

string

Wymagane. Wyświetlana nazwa budżetu.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.
budgetUnit

enum (BudgetUnit)

Wymagane. Stały. Określa, czy budżet jest mierzony w walucie czy w wyświetleniach.
budgetAmountMicros

string (int64 format)

Wymagane. Łączna kwota, jaką mogą budżetować powiązane segmenty zamówienia reklamowego.

Ilość jest wyrażona w mikro. Musi być większy niż 0. Na przykład 500000000 oznacza 500 standardowych jednostek waluty.
dateRange

object (DateRange)

Wymagane. Zakres dat dla budżetu kampanii. Połączone segmenty budżetu mogą mieć inny zakres dat. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego.

Zarówno startDate, jak i endDate muszą przypadać przed rokiem 2037.
externalBudgetSource

enum (ExternalBudgetSource)

Wymagane. Zewnętrzne źródło budżetu.
externalBudgetId

string

Stały. Identyfikator określający ten budżet dla źródła zewnętrznego.

Jeśli to pole jest określone, a poziom szczegółów faktury w odpowiednim profilu płatności jest ustawiony na „Zamówienie na poziomie budżetu”, wszystkie wyświetlenia realizowane w ramach tego budżetu będą zawierały ten identyfikator na fakturze.

Nie może się powtarzać w ramach kampanii.
invoiceGroupingId

string

Stały. Identyfikator służący do grupowania budżetów, które mają być uwzględnione na tej samej fakturze.

Jeśli to pole jest skonfigurowane, a poziom faktury w odpowiednim profilu płatności jest ustawiony na „Identyfikator grupowania faktur na poziomie budżetu”, wszystkie identyfikatory externalBudgetId korzystające z tego samego elementu invoiceGroupingId zostaną zgrupowane na tej samej fakturze.
prismaConfig

object (PrismaConfig)

Dodatkowe metadane do wykorzystania przez narzędzie Mediaocean Prisma.

Wymagany w przypadku budżetów Mediaocean.

Dotyczy tylko reklamodawców prismaEnabled.

ExternalBudgetSource

Zewnętrzne źródło segmentu budżetu kampanii.

Wartości w polu enum
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED Wartość zewnętrznego źródła budżetu nie jest określona lub nieznana w tej wersji.
EXTERNAL_BUDGET_SOURCE_NONE Budżet nie ma zewnętrznego źródła.
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN Źródło budżetu to Mediaocean.

PrismaConfig

Ustawienia właściwe dla narzędzia Mediaocean Prisma.

Zapis JSON 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
Pola
prismaType

enum (PrismaType)

Wymagane. Typ Prisma.
prismaCpeCode

object (PrismaCpeCode)

Wymagane. Odpowiednie kody dotyczące klientów, usług i szacunków z narzędzia Mediaocean Prisma.
supplier

string

Wymagane. Podmiot przeznaczył ten budżet (DSP, witryna itp.).

PrismaType

Możliwe typy budżetu Prisma.

Wartości w polu enum
PRISMA_TYPE_UNSPECIFIED W tej wersji typ nie jest określony lub nieznany.
PRISMA_TYPE_DISPLAY Typ wyświetlania.
PRISMA_TYPE_VIDEO Typ filmu.
PRISMA_TYPE_AUDIO Typ audio.
PRISMA_TYPE_SOCIAL Typ społecznościowy.
PRISMA_TYPE_FEE Typ opłaty.

PrismaCpeCode

Centrum płatności Google obsługuje wyszukiwanie i filtrowanie pól składowych tego kodu.

Zapis JSON 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
Pola
prismaClientCode

string

Kod klienta aplikacji Prisma.
prismaProductCode

string

Kod produktu Prisma.
prismaEstimateCode

string

Szacowany kod aplikacji Prisma.

Metody

create

 Tworzy nową kampanię.

delete

 powoduje trwałe usunięcie kampanii,

get

 Pobiera kampanię.

list

 Wyświetla listę kampanii reklamodawcy.

listAssignedTargetingOptions

 Wyświetla listę przypisanych opcji kierowania kampanii z różnymi typami kierowania.

patch

 Aktualizuje istniejącą kampanię.