REST Resource: customers.ads

FinalAppUrl

URL untuk deep linking ke aplikasi untuk sistem operasi tertentu.

Representasi JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Kolom
osType

enum (AppUrlOperatingSystemType)

Sistem operasi yang ditargetkan oleh URL ini. Wajib.

url

string

URL deep link aplikasi. Deep link menentukan lokasi dalam aplikasi yang sesuai dengan konten yang ingin Anda tampilkan, dan harus berbentuk {skema}://{host_path} Skema mengidentifikasi aplikasi mana yang akan dibuka. Untuk aplikasi, Anda dapat menggunakan skema kustom yang dimulai dengan nama aplikasi. Host dan jalur menentukan lokasi unik dalam aplikasi tempat konten Anda berada. Contoh: "exampleapp://productid_1234". Wajib.

AppUrlOperatingSystemType

Sistem Operasi

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
IOS Sistem operasi IOS Apple.
ANDROID Sistem operasi Android.

CustomParameter

Pemetaan yang dapat digunakan oleh tag parameter kustom di trackingUrlTemplate, finalUrls, atau mobile_final_urls.

Representasi JSON
{
  "key": string,
  "value": string
}
Kolom
key

string

Kunci yang cocok dengan nama tag parameter.

value

string

Nilai yang akan diganti.

AdType

Kemungkinan jenis iklan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

TEXT_AD Iklan tersebut adalah iklan teks.
EXPANDED_TEXT_AD Iklan merupakan iklan teks diperpanjang.
EXPANDED_DYNAMIC_SEARCH_AD Iklan tersebut merupakan iklan Penelusuran Dinamis diperluas.
HOTEL_AD Iklan tersebut adalah iklan hotel.
SHOPPING_SMART_AD Iklan tersebut adalah iklan Shopping Pintar.
SHOPPING_PRODUCT_AD Iklan tersebut adalah iklan Shopping standar.
VIDEO_AD Iklan tersebut adalah iklan video.
IMAGE_AD Iklan ini adalah iklan Gambar.
RESPONSIVE_SEARCH_AD Iklan tersebut merupakan iklan penelusuran responsif.
LEGACY_RESPONSIVE_DISPLAY_AD Iklan tersebut merupakan iklan Display responsif lama.
APP_AD Iklan tersebut merupakan iklan aplikasi.
LEGACY_APP_INSTALL_AD Iklan tersebut merupakan iklan instal aplikasi lama.
RESPONSIVE_DISPLAY_AD Iklan tersebut merupakan iklan Display responsif.
LOCAL_AD Iklan tersebut adalah iklan lokal.
HTML5_UPLOAD_AD Iklan tersebut merupakan iklan upload Display dengan jenis produk HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Iklan tersebut merupakan iklan upload display dengan salah satu jenis produk DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Iklan merupakan iklan engagement aplikasi.
SHOPPING_COMPARISON_LISTING_AD Iklan tersebut adalah iklan Listingan Perbandingan Belanja.
VIDEO_BUMPER_AD Iklan bumper video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Iklan in-stream yang tidak dapat dilewati Video.
VIDEO_OUTSTREAM_AD Iklan outstream video.
VIDEO_TRUEVIEW_IN_STREAM_AD Iklan video TrueView in-stream.
VIDEO_RESPONSIVE_AD Iklan responsif video.
SMART_CAMPAIGN_AD Iklan kampanye pintar.
CALL_AD Iklan panggilan telepon.
APP_PRE_REGISTRATION_AD Iklan prapendaftaran aplikasi universal.
IN_FEED_VIDEO_AD Iklan video Dalam Feed.
DISCOVERY_MULTI_ASSET_AD Iklan multi-aset Discovery.
TRAVEL_AD Iklan perjalanan.
DISCOVERY_VIDEO_RESPONSIVE_AD Iklan responsif video Discovery.

Perangkat

Menjelaskan perangkat Google Ads yang tersedia untuk penargetan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
MOBILE Perangkat seluler dengan browser lengkap.
TABLET Tablet dengan browser lengkap.
DESKTOP Komputer.
CONNECTED_TV Smart TV dan konsol game.
OTHER Jenis perangkat lainnya.

UrlCollection

Kumpulan URL yang diberi tag dengan ID unik.

Representasi JSON
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Kolom
finalUrls[]

string

Daftar kemungkinan URL final.

finalMobileUrls[]

string

Daftar kemungkinan URL final seluler.

urlCollectionId

string

ID unik untuk instance UrlCollection ini.

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan.

SystemManagedResourceSource

Enum yang mencantumkan kemungkinan sumber entity yang dikelola sistem.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_VARIATIONS Iklan eksperimen variasi iklan yang dihasilkan.

TextAdInfo

Iklan teks.

Representasi JSON
{
  "headline": string,
  "description1": string,
  "description2": string
}
Kolom
headline

string

Judul iklan.

description1

string

Baris pertama deskripsi iklan.

description2

string

Baris kedua deskripsi iklan.

ExpandedTextAdInfo

Iklan teks diperpanjang.

Representasi JSON
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Kolom
headlinePart1

string

Bagian pertama judul iklan.

headlinePart2

string

Bagian kedua judul iklan.

headlinePart3

string

Bagian ketiga judul iklan.

description

string

Deskripsi iklan.

description2

string

Deskripsi kedua iklan.

path1

string

Teks yang dapat muncul di samping URL iklan yang ditampilkan.

path2

string

Teks tambahan yang dapat muncul di samping URL iklan yang ditampilkan.

CallAdInfo

Iklan panggilan telepon.

Representasi JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Kolom
countryCode

string

Kode negara dalam iklan.

phoneNumber

string

Nomor telepon di iklan.

businessName

string

Nama bisnis dalam iklan.

headline1

string

Judul pertama dalam iklan.

headline2

string

Judul kedua dalam iklan.

description1

string

Baris pertama deskripsi iklan.

description2

string

Baris kedua deskripsi iklan.

callTracked

boolean

Apakah akan mengaktifkan pelacakan panggilan untuk materi iklan. Mengaktifkan tracking panggilan juga akan mengaktifkan konversi panggilan.

disableCallConversion

boolean

Apakah ingin menonaktifkan konversi panggilan untuk materi iklan. Jika ditetapkan ke true, konversi panggilan akan dinonaktifkan meskipun callTracked adalah true. Jika callTracked adalah false, kolom ini akan diabaikan.

phoneNumberVerificationUrl

string

URL yang akan digunakan untuk verifikasi nomor telepon.

conversionAction

string

Tindakan konversi yang akan dikaitkan dengan konversi panggilan. Jika tidak ditetapkan, tindakan konversi default akan digunakan. Kolom ini hanya berpengaruh jika callTracked ditetapkan ke true. Jika tidak, kolom ini akan diabaikan.

conversionReportingState

enum (CallConversionReportingState)

Perilaku konversi panggilan dari iklan panggilan telepon ini. Kampanye dapat menggunakan setelan konversi panggilannya sendiri, mewarisi setelan tingkat akun, atau dinonaktifkan.

path1

string

Bagian pertama teks yang dapat ditambahkan ke URL di iklan. Opsional.

path2

string

Bagian kedua teks yang dapat ditambahkan ke URL di iklan. Kolom ini hanya dapat ditetapkan jika path1 juga ditetapkan. Opsional.

CallConversionReportingState

Kemungkinan jenis data untuk status tindakan konversi panggilan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
DISABLED Tindakan konversi panggilan dinonaktifkan.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Tindakan konversi panggilan akan menggunakan jenis konversi panggilan yang ditetapkan di tingkat akun.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Tindakan konversi panggilan akan menggunakan jenis konversi panggilan yang ditetapkan di tingkat resource (iklan khusus panggilan telepon/ekstensi panggilan).

ExpandedDynamicSearchAdInfo

Iklan Penelusuran Dinamis diperluas.

Representasi JSON
{
  "description": string,
  "description2": string
}
Kolom
description

string

Deskripsi iklan.

description2

string

Deskripsi kedua iklan.

HotelAdInfo

Jenis ini tidak memiliki kolom.

Iklan Hotel.

ShoppingSmartAdInfo

Jenis ini tidak memiliki kolom.

Iklan Shopping Pintar.

ShoppingProductAdInfo

Jenis ini tidak memiliki kolom.

Iklan Shopping standar.

ImageAdInfo

Iklan gambar.

Representasi JSON
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Kolom
mimeType

enum (MimeType)

Jenis mime gambar.

pixelWidth

string (int64 format)

Lebar dalam piksel gambar ukuran penuh.

pixelHeight

string (int64 format)

Tinggi dalam piksel dari gambar ukuran penuh.

imageUrl

string

URL gambar ukuran penuh.

previewPixelWidth

string (int64 format)

Lebar gambar ukuran pratinjau dalam piksel.

previewPixelHeight

string (int64 format)

Tinggi gambar ukuran pratinjau dalam piksel.

previewImageUrl

string

URL gambar ukuran pratinjau.

name

string

Nama gambar. Jika gambar dibuat dari MediaFile, ini adalah nama MediaFile. Jika gambar dibuat dari byte, berarti gambar ini kosong.

Kolom union image. Gambar yang digunakan untuk membuat Iklan Gambar. Nilai ini dapat ditentukan dengan salah satu dari dua cara berikut. 1. Resource MediaFile yang ada. 2. Data gambar mentah sebagai byte. image hanya ada berupa salah satu diantara berikut:
mediaFile

string

Resource MediaFile yang akan digunakan untuk gambar.

data

string (bytes format)

Data gambar mentah sebagai byte.

String berenkode base64.

adIdToCopyImageFrom

string (int64 format)

ID iklan untuk menyalin gambar.

MimeType

Jenis mime

Enum
UNSPECIFIED Jenis mime belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

IMAGE_JPEG Jenis MIME gambar/jpeg.
IMAGE_GIF Jenis MIME gambar/gif.
IMAGE_PNG Jenis MIME gambar/png.
FLASH Jenis MIME application/x-shockwave-flash.
TEXT_HTML Jenis MIME text/html.
PDF Jenis MIME application/pdf.
MSWORD Jenis MIME dari application/msword.
MSEXCEL Jenis MIME dari application/vnd.ms-excel.
RTF Jenis MIME application/rtf.
AUDIO_WAV Jenis MIME audio/wav.
AUDIO_MP3 Jenis MIME audio/mp3.
HTML5_AD_ZIP Jenis MIME application/x-html5-ad-zip.

VideoAdInfo

Iklan video.

Representasi JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Kolom
video

object (AdVideoAsset)

Aset video YouTube yang digunakan untuk iklan.

Kolom union format. Skema spesifik per format untuk berbagai format video. format hanya ada berupa salah satu diantara berikut:
inStream

object (VideoTrueViewInStreamAdInfo)

Video TrueView in-stream ad format.

bumper

object (VideoBumperInStreamAdInfo)

Format iklan in-stream bumper video.

outStream

object (VideoOutstreamAdInfo)

Format iklan out-stream video.

nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Format iklan in-stream yang tidak dapat dilewati Video.

inFeed

object (InFeedVideoAdInfo)

Format iklan video Dalam Feed.

AdVideoAsset

Aset video yang digunakan di dalam iklan.

Representasi JSON
{
  "asset": string
}
Kolom
asset

string

Nama resource Aset video ini.

VideoTrueViewInStreamAdInfo

Representasi format iklan TrueView in-stream video (iklan yang ditampilkan selama pemutaran video, sering kali di awal, yang menampilkan tombol lewati beberapa detik pada video).

Representasi JSON
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Kolom
actionButtonLabel

string

Label di tombol CTA (pesan ajakan) yang mengarahkan pengguna ke URL final iklan video. Diperlukan untuk kampanye TrueView for action, opsional jika tidak.

actionHeadline

string

Teks tambahan yang ditampilkan dengan tombol CTA (pesan ajakan) untuk memberikan konteks dan mendorong pengguna untuk mengklik tombol tersebut.

companionBanner

object (AdImageAsset)

Aset gambar banner pengiring yang digunakan dengan iklan.

AdImageAsset

Aset gambar yang digunakan di dalam iklan.

Representasi JSON
{
  "asset": string
}
Kolom
asset

string

Nama resource Aset gambar ini.

VideoBumperInStreamAdInfo

Representasi format iklan video bumper in-stream (iklan video in-stream yang tidak dapat dilewati yang sangat singkat).

Representasi JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Kolom
companionBanner

object (AdImageAsset)

Aset gambar banner pengiring yang digunakan dengan iklan.

actionButtonLabel

string

Label pada tombol "Pesan Ajakan (CTA)" mengarahkan pengguna ke URL final iklan video.

actionHeadline

string

Teks tambahan yang ditampilkan dengan tombol CTA (pesan ajakan) untuk memberikan konteks dan mendorong pengguna untuk mengklik tombol tersebut.

VideoOutstreamAdInfo

Representasi format iklan out-stream video (iklan ditampilkan di samping feed dengan pemutaran otomatis, tanpa suara).

Representasi JSON
{
  "headline": string,
  "description": string
}
Kolom
headline

string

Judul iklan.

description

string

Baris deskripsi.

VideoNonSkippableInStreamAdInfo

Representasi format iklan video in-stream yang tidak dapat dilewati (iklan video in-stream yang tidak dapat dilewati berdurasi 15 detik).

Representasi JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Kolom
companionBanner

object (AdImageAsset)

Aset gambar banner pengiring yang digunakan dengan iklan.

actionButtonLabel

string

Label pada tombol "Pesan Ajakan (CTA)" mengarahkan pengguna ke URL final iklan video.

actionHeadline

string

Teks tambahan yang ditampilkan dengan tombol "Pesan Ajakan (CTA)" untuk memberikan konteks dan mendorong pengguna untuk mengklik tombol tersebut.

InFeedVideoAdInfo

Representasi format iklan video Dalam Feed.

Representasi JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Kolom
headline

string

Judul iklan.

description1

string

Baris teks pertama untuk iklan.

description2

string

Baris teks kedua untuk iklan.

thumbnail

enum (VideoThumbnail)

Gambar thumbnail video yang akan digunakan.

VideoThumbnail

Enum yang mencantumkan kemungkinan jenis thumbnail video.

Enum
UNSPECIFIED Jenis belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini. Nilai ini hanya berupa respons.
DEFAULT_THUMBNAIL Thumbnail default. Dapat dibuat secara otomatis atau diupload pengguna.
THUMBNAIL_1 Thumbnail 1, dibuat dari video.
THUMBNAIL_2 Thumbnail 2, dibuat dari video.
THUMBNAIL_3 Thumbnail 3, dibuat dari video.

VideoResponsiveAdInfo

Iklan responsif video.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk judul pendek. Saat ini, hanya satu nilai untuk judul singkat yang didukung.

longHeadlines[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk judul panjang. Saat ini, hanya satu nilai untuk judul panjang yang didukung.

descriptions[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk deskripsi. Saat ini, hanya satu nilai untuk deskripsi yang didukung.

callToActions[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk tombol, misalnya, tombol "Pesan Ajakan (CTA)". Saat ini, hanya satu nilai untuk tombol yang didukung.

videos[]

object (AdVideoAsset)

Daftar aset video YouTube yang digunakan untuk iklan. Saat ini, hanya satu nilai yang didukung untuk aset video YouTube.

companionBanners[]

object (AdImageAsset)

Daftar aset gambar yang digunakan untuk banner pengiring. Saat ini, aset banner pengiring hanya memiliki satu nilai yang didukung.

breadcrumb1

string

Bagian pertama teks yang muncul dalam iklan dengan URL yang ditampilkan.

breadcrumb2

string

Bagian kedua teks yang muncul di iklan dengan URL yang ditampilkan.

AdTextAsset

Aset teks yang digunakan di dalam iklan.

Representasi JSON
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Kolom
pinnedField

enum (ServedAssetFieldType)

Kolom aset yang disematkan. Tindakan ini akan membatasi aset untuk hanya ditayangkan dalam kolom ini. Beberapa aset dapat disematkan ke kolom yang sama. Aset yang dilepas pinnya atau disematkan ke kolom lain tidak akan ditayangkan di kolom tempat aset lain disematkan.

assetPerformanceLabel

enum (AssetPerformanceLabel)

Label performa aset teks ini.

policySummaryInfo

object (AdAssetPolicySummary)

Ringkasan kebijakan aset teks ini.

text

string

Teks aset.

ServedAssetFieldType

Kemungkinan jenis kolom aset.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

HEADLINE_1 Aset ini digunakan di judul 1.
HEADLINE_2 Aset ini digunakan di judul 2.
HEADLINE_3 Aset ini digunakan di judul 3.
DESCRIPTION_1 Aset ini digunakan dalam deskripsi 1.
DESCRIPTION_2 Aset ini digunakan dalam deskripsi 2.
CALL Aset ini digunakan sebagai panggilan.
MOBILE_APP Aset ini digunakan sebagai aplikasi seluler.
CALLOUT Aset ini digunakan sebagai info.
STRUCTURED_SNIPPET Aset ini digunakan sebagai ringkasan terstruktur.
PRICE Aset ini digunakan sebagai harga.
PROMOTION Aset ini digunakan sebagai promosi.
AD_IMAGE Aset ini digunakan sebagai gambar.
LEAD_FORM Aset digunakan sebagai formulir prospek.

AssetPerformanceLabel

Enum yang menjelaskan kemungkinan label performa aset, biasanya dihitung dalam konteks penautan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
PENDING Aset ini belum memiliki informasi performa. Hal ini mungkin terjadi karena video masih dalam peninjauan.
LEARNING Aset mulai mendapatkan tayangan, tetapi statistiknya tidak cukup signifikan secara statistik untuk mendapatkan label performa aset.
LOW Aset berperforma terburuk.
GOOD Aset berperforma baik.
BEST Aset berperforma terbaik.

AdAssetPolicySummary

Berisi informasi kebijakan untuk aset di dalam iklan.

Representasi JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Kolom
policyTopicEntries[]

object (PolicyTopicEntry)

Daftar temuan kebijakan untuk aset ini.

reviewStatus

enum (PolicyReviewStatus)

Lokasi aset ini dalam proses peninjauan.

approvalStatus

enum (PolicyApprovalStatus)

Status persetujuan keseluruhan aset ini, yang dihitung berdasarkan status entri topik kebijakan masing-masing.

PolicyTopicEntry

Temuan kebijakan yang disertakan ke referensi (misalnya, kebijakan alkohol yang terkait dengan situs yang menjual alkohol).

Setiap PolicyTopicEntry memiliki topik yang menunjukkan kebijakan iklan tertentu yang berkaitan dengan entri dan jenis untuk menunjukkan efek entri yang akan terjadi pada penayangan. Hasil ini mungkin memiliki satu atau beberapa bukti yang menunjukkan alasan temuan tersebut. Secara opsional, halaman ini juga mungkin memiliki satu atau beberapa batasan yang memberikan detail tentang cara penayangan dibatasi.

Representasi JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Kolom
type

enum (PolicyTopicEntryType)

Menjelaskan dampak negatif atau positif kebijakan ini terhadap penayangan.

evidences[]

object (PolicyTopicEvidence)

Informasi tambahan yang menjelaskan temuan kebijakan (misalnya, nama merek untuk temuan merek dagang).

constraints[]

object (PolicyTopicConstraint)

Menunjukkan bagaimana penayangan resource ini dapat terpengaruh (misalnya, tidak ditayangkan di suatu negara).

topic

string

Topik kebijakan yang dirujuk oleh temuan ini. Misalnya, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", atau "DESTINATION_NOT_WORKING". Rangkaian topik kebijakan yang memungkinkan tidak bersifat tetap untuk versi API tertentu dan dapat berubah kapan saja.

PolicyTopicEntryType

Kemungkinan jenis entri topik kebijakan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

PROHIBITED Resource tersebut tidak akan ditayangkan.
LIMITED Resource tersebut tidak akan ditayangkan dalam kondisi tertentu.
FULLY_LIMITED Resource tidak dapat ditayangkan sama sekali karena kriteria penargetan saat ini.
DESCRIPTIVE Mungkin menarik, tetapi tidak membatasi bagaimana resource ditayangkan.
BROADENING Dapat meningkatkan cakupan di luar batas normal.
AREA_OF_INTEREST_ONLY Dibatasi untuk semua negara target, tetapi dapat ditayangkan di negara lain melalui area minat.

PolicyTopicEvidence

Informasi tambahan yang menjelaskan temuan kebijakan.

Representasi JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Kolom
Kolom union value. Informasi bukti yang spesifik tergantung pada jenis buktinya. value hanya ada berupa salah satu diantara berikut:
websiteList

object (WebsiteList)

Daftar situs yang ditautkan dengan resource ini.

textList

object (TextList)

Daftar bukti yang ditemukan dalam teks referensi.

languageCode

string

Bahasa yang terdeteksi sebagai bahasa penulisan resource. Ini adalah tag bahasa IETF seperti "en-US".

destinationTextList

object (DestinationTextList)

Teks di tujuan resource yang menyebabkan temuan kebijakan.

destinationMismatch

object (DestinationMismatch)

Ketidakcocokan antar-tujuan URL resource.

destinationNotWorking

object (DestinationNotWorking)

Detail kapan tujuan menampilkan kode error HTTP atau tidak berfungsi di semua lokasi untuk perangkat yang umum digunakan.

WebsiteList

Daftar situs yang menyebabkan temuan kebijakan. Digunakan untuk misalnya, topik kebijakan ONE_WEBSITE_PER_AD_GROUP. Jika ada lebih dari lima situs, hanya lima situs teratas (yang paling sering muncul di resource) yang akan dicantumkan di sini.

Representasi JSON
{
  "websites": [
    string
  ]
}
Kolom
websites[]

string

Situs web yang menyebabkan penemuan kebijakan.

TextList

Daftar fragmen teks yang melanggar kebijakan.

Representasi JSON
{
  "texts": [
    string
  ]
}
Kolom
texts[]

string

Fragmen teks dari resource yang menyebabkan penemuan kebijakan.

DestinationTextList

Daftar string yang ditemukan di halaman tujuan yang menyebabkan temuan kebijakan.

Representasi JSON
{
  "destinationTexts": [
    string
  ]
}
Kolom
destinationTexts[]

string

Daftar teks yang ada di halaman tujuan resource.

DestinationMismatch

Bukti ketidakcocokan antara URL resource.

Representasi JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Kolom
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Kumpulan URL yang tidak cocok satu sama lain.

PolicyTopicEvidenceDestinationMismatchUrlType

Kemungkinan jenis URL tujuan iklan topik kebijakan tidak cocok.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

DISPLAY_URL URL yang ditampilkan.
FINAL_URL URL final.
FINAL_MOBILE_URL URL final seluler.
TRACKING_URL Template URL pelacakan, dengan URL desktop yang diganti.
MOBILE_TRACKING_URL Kerangka URL pelacakan, dengan URL seluler pengganti.

DestinationNotWorking

Detail bukti saat tujuan menampilkan kode error HTTP atau tidak berfungsi di semua lokasi untuk perangkat yang umum digunakan.

Representasi JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Kolom
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Jenis perangkat yang gagal memuat URL.

expandedUrl

string

URL lengkap yang tidak berfungsi.

lastCheckedDateTime

string

Waktu saat URL terakhir diperiksa. Formatnya adalah "YYYY-MM-DD HH:MM:SS". Contoh: "2018-03-05 09:15:00" atau "2018-02-01 14:34:30"

Kolom union reason. Menunjukkan alasan penemuan kebijakan ProGuard_NOT_WORKING. reason hanya ada berupa salah satu diantara berikut:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Jenis error DNS.

httpErrorCode

string (int64 format)

Kode error HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

Kemungkinan tujuan bukti topik kebijakan tidak berfungsi di perangkat.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

DESKTOP Halaman landing tidak berfungsi di perangkat desktop.
ANDROID Halaman landing tidak berfungsi di perangkat Android.
IOS Halaman landing tidak berfungsi di perangkat iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Tujuan bukti topik kebijakan yang mungkin tidak berfungsi jenis error DNS.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

HOSTNAME_NOT_FOUND Nama host tidak ditemukan di DNS saat mengambil halaman landing.
GOOGLE_CRAWLER_DNS_ISSUE Masalah crawler internal Google saat berkomunikasi dengan DNS. Error ini tidak berarti halaman landing tidak berfungsi. Google akan meng-crawl ulang halaman landing.

PolicyTopicConstraint

Menjelaskan pengaruh entri topik kebijakan terhadap penayangan.

Representasi JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Kolom
Kolom union value. Informasi spesifik tentang batasan. value hanya ada berupa salah satu diantara berikut:
countryConstraintList

object (CountryConstraintList)

Negara tempat resource tidak dapat ditayangkan.

resellerConstraint

object (ResellerConstraint)

Batasan reseller.

certificateMissingInCountryList

object (CountryConstraintList)

Negara yang mewajibkan sertifikat untuk menayangkan iklan.

certificateDomainMismatchInCountryList

object (CountryConstraintList)

Negara tempat domain resource tidak tercakup oleh sertifikat yang terkait dengannya.

CountryConstraintList

Daftar negara tempat penayangan resource dibatasi.

Representasi JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Kolom
countries[]

object (CountryConstraint)

Negara tempat penayangan dibatasi.

totalTargetedCountries

integer

Jumlah total negara yang ditargetkan oleh sumber daya.

CountryConstraint

Menunjukkan bahwa kemampuan resource untuk melayani di negara tertentu terbatas.

Representasi JSON
{
  "countryCriterion": string
}
Kolom
countryCriterion

string

Nama resource konstanta target geografis negara tempat penayangan dibatasi.

ResellerConstraint

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa topik kebijakan dibatasi karena penolakan situs untuk tujuan reseller.

PolicyReviewStatus

Kemungkinan status pemeriksaan kebijakan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

REVIEW_IN_PROGRESS Sedang dalam peninjauan.
REVIEWED Peninjauan utama selesai. Peninjauan lainnya mungkin berlanjut.
UNDER_APPEAL Referensi telah dikirim ulang untuk mendapatkan persetujuan atau keputusan kebijakannya telah diajukan banding.
ELIGIBLE_MAY_SERVE Sumber daya memenuhi syarat dan mungkin ditayangkan, tetapi masih dapat menjalani peninjauan lebih lanjut.

PolicyApprovalStatus

Status persetujuan kebijakan yang mungkin. Jika ada beberapa status persetujuan yang tersedia, status paling parah akan digunakan. Urutan tingkat keparahan TIDAK DISETUJUI, AREA_OF_MIN_ONLY, APPROVED_LIMITED, dan DISETUJUI.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.

DISAPPROVED Tidak akan ditayangkan.
APPROVED_LIMITED Ditayangkan dengan pembatasan.
APPROVED Ditayangkan tanpa batasan.
AREA_OF_INTEREST_ONLY Tidak akan ditayangkan di negara target, tetapi dapat ditayangkan kepada pengguna yang menelusuri informasi tentang negara target.

ResponsiveSearchAdInfo

Iklan penelusuran responsif.

Iklan penelusuran responsif memungkinkan Anda membuat iklan yang disesuaikan agar menampilkan lebih banyak teks dan pesan yang lebih relevan kepada pelanggan. Masukkan beberapa judul dan deskripsi ketika membuat iklan penelusuran responsif dan, seiring waktu, Google Ads akan otomatis menguji kombinasi yang berbeda-beda dan mempelajari kombinasi mana yang memiliki performa terbaik. Iklan penelusuran responsif dapat meningkatkan performa kampanye Anda dengan menyesuaikan konten iklan agar lebih cocok dengan istilah penelusuran calon pelanggan.

Informasi selengkapnya di https://support.google.com/google-ads/answer/7684791

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini.

path1

string

Bagian pertama teks yang dapat ditambahkan ke URL di iklan.

path2

string

Bagian kedua teks yang dapat ditambahkan ke URL di iklan. Kolom ini hanya dapat ditetapkan jika path1 juga ditetapkan.

LegacyResponsiveDisplayAdInfo

Iklan Display responsif lama. Iklan jenis ini diberi label 'Iklan responsif' pada UI Google Ads.

Representasi JSON
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Kolom
formatSetting

enum (DisplayAdFormatSetting)

Menentukan format iklan yang akan ditayangkan. Defaultnya adalah ALL_FORMATS.

shortHeadline

string

Versi singkat judul iklan.

longHeadline

string

Versi panjang judul iklan.

description

string

Deskripsi iklan.

businessName

string

Nama bisnis dalam iklan.

allowFlexibleColor

boolean

Persetujuan pengiklan untuk mengizinkan warna fleksibel. Jika benar, iklan dapat ditayangkan dengan warna berbeda jika diperlukan. Jika nilainya adalah salah, iklan akan ditayangkan dengan warna tertentu atau warna netral. Nilai default-nya adalah true. Harus bernilai benar jika mainColor dan accentColor tidak ditetapkan.

accentColor

string

Warna aksen iklan dalam heksadesimal, misalnya, #ffffff untuk putih. Jika salah satu dari mainColor dan accentColor ditetapkan, yang lain juga diperlukan.

mainColor

string

Warna utama iklan dalam heksadesimal, misalnya, #ffffff untuk putih. Jika salah satu dari mainColor dan accentColor ditetapkan, yang lain juga diperlukan.

callToActionText

string

Teks pesan ajakan (CTA) untuk iklan.

logoImage

string

Nama resource MediaFile dari gambar logo yang digunakan dalam iklan.

squareLogoImage

string

Nama resource MediaFile dari gambar logo persegi yang digunakan dalam iklan.

marketingImage

string

Nama resource MediaFile dari gambar pemasaran yang digunakan dalam iklan.

squareMarketingImage

string

Nama resource MediaFile dari gambar pemasaran persegi yang digunakan dalam iklan.

pricePrefix

string

Awali sebelum harga. Misalnya, 'serendah'.

promoText

string

Teks promosi yang digunakan untuk format dinamis pada iklan responsif. Misalnya 'Gratis ongkir, 2 hari sampai'.

DisplayAdFormatSetting

Menghitung setelan format iklan Display.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
ALL_FORMATS Format native, gambar, dan teks.
NON_NATIVE Format teks dan gambar.
NATIVE Format native, misalnya, rendering format dikontrol oleh penayang, bukan oleh Google.

AppAdInfo

Iklan aplikasi.

Representasi JSON
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Kolom
mandatoryAdText

object (AdTextAsset)

Teks iklan wajib.

headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini.

images[]

object (AdImageAsset)

Daftar aset gambar yang mungkin ditampilkan bersama iklan.

youtubeVideos[]

object (AdVideoAsset)

Daftar aset video YouTube yang dapat ditampilkan bersama iklan.

html5MediaBundles[]

object (AdMediaBundleAsset)

Daftar aset paket media yang dapat digunakan dengan iklan.

AdMediaBundleAsset

Aset paket media yang digunakan di dalam iklan.

Representasi JSON
{
  "asset": string
}
Kolom
asset

string

Nama resource Aset paket media ini.

LegacyAppInstallAdInfo

Iklan instal aplikasi lama yang hanya dapat digunakan oleh beberapa pelanggan tertentu.

Representasi JSON
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Kolom
appStore

enum (LegacyAppInstallAdAppStore)

App store tempat aplikasi seluler tersedia.

appId

string

ID aplikasi seluler.

headline

string

Judul iklan.

description1

string

Baris deskripsi pertama iklan.

description2

string

Baris deskripsi kedua iklan.

LegacyAppInstallAdAppStore

Jenis app store di iklan instal aplikasi lama.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Windows Phone Store.
CN_APP_STORE Aplikasi dihosting di app store China.

ResponsiveDisplayAdInfo

Iklan Display responsif.

Representasi JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Kolom
marketingImages[]

object (AdImageAsset)

Gambar pemasaran yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 600x314 dan rasio aspek harus 1,91:1 (+-1%). Diperlukan setidaknya satu marketingImage. Jika digabungkan dengan squareMarketingImages, jumlah maksimumnya adalah 15.

squareMarketingImages[]

object (AdImageAsset)

Gambar pemasaran persegi untuk digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 300x300 dan rasio aspek harus 1:1 (+-1%). Setidaknya satu marketingImage persegi diperlukan. Jika digabungkan dengan marketingImages, jumlah maksimumnya adalah 15.

logoImages[]

object (AdImageAsset)

Gambar logo yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 512x128 dan rasio aspek harus 4:1 (+-1%). Jika digabungkan dengan squareLogoImages, jumlah maksimumnya adalah 5.

squareLogoImages[]

object (AdImageAsset)

Gambar logo persegi yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 128x128 dan rasio aspek harus 1:1 (+-1%). Jika digabungkan dengan logoImages, jumlah maksimumnya adalah 5.

headlines[]

object (AdTextAsset)

Judul format pendek untuk iklan. Panjang maksimum adalah 30 karakter. Minimal 1 dan maksimal 5 judul dapat ditentukan.

longHeadline

object (AdTextAsset)

Judul format panjang yang diperlukan. Panjang maksimum adalah 90 karakter.

descriptions[]

object (AdTextAsset)

Teks deskriptif untuk iklan. Panjang maksimum adalah 90 karakter. Minimal 1 dan maksimal 5 judul dapat ditentukan.

youtubeVideos[]

object (AdVideoAsset)

Video YouTube opsional untuk iklan. Anda dapat menentukan maksimum 5 video.

formatSetting

enum (DisplayAdFormatSetting)

Menentukan format iklan yang akan ditayangkan. Defaultnya adalah ALL_FORMATS.

controlSpec

object (ResponsiveDisplayAdControlSpec)

Spesifikasi untuk berbagai kontrol materi iklan.

businessName

string

Nama pengiklan/merek. Lebar tampilan maksimum adalah 25.

mainColor

string

Warna utama iklan dalam heksadesimal, misalnya, #ffffff untuk putih. Jika salah satu dari mainColor dan accentColor ditetapkan, yang lain juga diperlukan.

accentColor

string

Warna aksen iklan dalam heksadesimal, misalnya, #ffffff untuk putih. Jika salah satu dari mainColor dan accentColor ditetapkan, yang lain juga diperlukan.

allowFlexibleColor

boolean

Persetujuan pengiklan untuk mengizinkan warna fleksibel. Jika benar, iklan dapat ditayangkan dengan warna berbeda jika diperlukan. Jika nilainya adalah salah, iklan akan ditayangkan dengan warna tertentu atau warna netral. Nilai default-nya adalah true. Harus bernilai benar jika mainColor dan accentColor tidak ditetapkan.

callToActionText

string

Teks pesan ajakan (CTA) untuk iklan. Lebar tampilan maksimum adalah 30.

pricePrefix

string

Awali sebelum harga. Misalnya, 'serendah'.

promoText

string

Teks promosi yang digunakan untuk format dinamis pada iklan responsif. Misalnya 'Gratis ongkir, 2 hari sampai'.

ResponsiveDisplayAdControlSpec

Spesifikasi untuk berbagai kontrol materi iklan untuk iklan Display responsif.

Representasi JSON
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Kolom
enableAssetEnhancements

boolean

Apakah pengiklan telah memilih ikut serta dalam fitur penyempurnaan aset.

enableAutogenVideo

boolean

Apakah pengiklan telah memilih untuk menggunakan fitur video pembuatan otomatis.

LocalAdInfo

Iklan lokal.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini. Minimal 1 dan maksimal 5 judul harus ditentukan.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini. Minimal 1 dan maksimal 5 deskripsi harus ditentukan.

callToActions[]

object (AdTextAsset)

Daftar aset teks untuk pesan ajakan (CTA). Saat iklan menayangkan pesan ajakan (CTA) akan dipilih dari daftar ini. Minimal 1 dan maksimal 5 pesan ajakan (CTA) harus ditentukan.

marketingImages[]

object (AdImageAsset)

Daftar aset gambar pemasaran yang mungkin ditampilkan bersama iklan. Gambar harus berukuran 314x600 piksel atau 320x320 piksel. Minimal 1 dan maksimal 20 aset gambar harus ditentukan.

logoImages[]

object (AdImageAsset)

Daftar aset gambar logo yang mungkin ditampilkan bersama iklan. Gambar harus berukuran 128x128 piksel dan tidak lebih dari 120 KB. Minimal 1 dan maksimal 5 aset gambar harus ditentukan.

videos[]

object (AdVideoAsset)

Daftar aset video YouTube yang dapat ditampilkan bersama iklan. Minimal 1 dan maksimal 20 aset video harus ditentukan.

path1

string

Bagian pertama dari teks opsional yang dapat ditambahkan ke URL di iklan.

path2

string

Bagian kedua dari teks opsional yang dapat ditambahkan ke URL di iklan. Kolom ini hanya dapat ditetapkan jika path1 juga ditetapkan.

DisplayUploadAdInfo

Jenis iklan Display umum. Format iklan yang tepat dikontrol oleh kolom displayUploadProductType, yang menentukan jenis data yang perlu disertakan dengan iklan.

Representasi JSON
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Kolom
displayUploadProductType

enum (DisplayUploadProductType)

Jenis produk iklan ini. Lihat komentar di enum untuk mengetahui detailnya.

Kolom union media_asset. Data aset yang membentuk iklan. media_asset hanya ada berupa salah satu diantara berikut:
mediaBundle

object (AdMediaBundleAsset)

Aset paket media yang akan digunakan dalam iklan. Untuk informasi tentang paket media untuk HTML5_UPLOAD_AD, lihat https://support.google.com/google-ads/answer/1722096 Paket media yang merupakan bagian dari jenis produk dinamis menggunakan format khusus yang perlu dibuat melalui Google Web Designer. Lihat https://support.google.com/webdesigner/answer/7543898 untuk informasi selengkapnya.

DisplayUploadProductType

Menghitung jenis produk upload tampilan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
HTML5_UPLOAD_AD Iklan upload HTML5. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan.
DYNAMIC_HTML5_EDUCATION_AD Iklan edukasi HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan dalam kampanye pendidikan.
DYNAMIC_HTML5_FLIGHT_AD Iklan penerbangan HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye penerbangan.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Iklan hotel dan rental akomodasi HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye Hotel.
DYNAMIC_HTML5_JOB_AD Iklan lowongan HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan dalam kampanye lowongan.
DYNAMIC_HTML5_LOCAL_AD Iklan lokal HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye Lokal.
DYNAMIC_HTML5_REAL_ESTATE_AD Iklan real estate HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye properti.
DYNAMIC_HTML5_CUSTOM_AD Iklan kustom HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye kustom.
DYNAMIC_HTML5_TRAVEL_AD Iklan perjalanan HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye Perjalanan.
DYNAMIC_HTML5_HOTEL_AD Iklan hotel HTML5 dinamis. Jenis produk ini mengharuskan kolom upload_media_bundle di DisplayUploadAdInfo ditetapkan. Hanya dapat digunakan di kampanye Hotel.

AppEngagementAdInfo

Iklan engagement aplikasi memungkinkan Anda menulis teks yang mendorong tindakan tertentu di aplikasi, seperti check in, melakukan pembelian, atau memesan tiket pesawat. Iklan memungkinkan Anda mengarahkan pengguna ke bagian tertentu aplikasi tempat mereka dapat menemukan hal yang mereka cari dengan lebih mudah dan lebih cepat.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini.

images[]

object (AdImageAsset)

Daftar aset gambar yang mungkin ditampilkan bersama iklan.

videos[]

object (AdVideoAsset)

Daftar aset video yang dapat ditampilkan bersama iklan.

ShoppingComparisonListingAdInfo

Iklan Listingan Perbandingan Belanja.

Representasi JSON
{
  "headline": string
}
Kolom
headline

string

Judul iklan. Kolom ini wajib diisi. Panjang yang diizinkan adalah antara 25 dan 45 karakter.

SmartCampaignAdInfo

Iklan kampanye Pintar.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks, yang masing-masing sesuai dengan judul saat iklan ditayangkan. Daftar ini terdiri dari minimal 3 dan maksimal 15 aset teks.

descriptions[]

object (AdTextAsset)

Daftar aset teks, yang masing-masing sesuai dengan deskripsi saat iklan ditayangkan. Daftar ini terdiri dari minimal 2 dan maksimal 4 aset teks.

AppPreRegistrationAdInfo

Iklan prapendaftaran aplikasi tertaut ke listingan aplikasi atau game Anda di Google Play, dan dapat berjalan di Google Play, di YouTube (hanya in-stream), serta dalam aplikasi dan situs seluler lain di Jaringan Display. Hal ini akan membantu mengetahui minat orang terhadap aplikasi atau game Anda dan menghasilkan basis penginstalan awal untuk aplikasi atau game Anda sebelum peluncuran.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini.

images[]

object (AdImageAsset)

Daftar ID aset gambar yang gambarnya mungkin ditampilkan bersama iklan.

youtubeVideos[]

object (AdVideoAsset)

Daftar ID aset video YouTube yang videonya dapat ditampilkan dengan iklan.

DiscoveryMultiAssetAdInfo

Iklan multi-aset Discovery.

Representasi JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Kolom
marketingImages[]

object (AdImageAsset)

Aset gambar pemasaran yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 600x314 dan rasio aspek harus 1,91:1 (+-1%). Wajib jika squareMarketingImages tidak ada. Jika digabungkan dengan squareMarketingImages dan portraitMarketingImages, jumlah maksimumnya adalah 20.

squareMarketingImages[]

object (AdImageAsset)

Aset gambar pemasaran persegi yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 300x300 dan rasio aspek harus 1:1 (+-1%). Wajib jika marketingImages tidak ada. Jika digabungkan dengan marketingImages dan portraitMarketingImages, jumlah maksimumnya adalah 20.

portraitMarketingImages[]

object (AdImageAsset)

Aset gambar pemasaran potret yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 480x600 dan rasio aspek harus 4:5 (+-1%). Jika digabungkan dengan marketingImages dan squareMarketingImages, jumlah maksimumnya adalah 20.

logoImages[]

object (AdImageAsset)

Aset gambar logo yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 128x128 dan rasio aspek harus 1:1 (+-1%). Anda dapat menentukan minimal 1 dan maksimal 5 gambar logo.

headlines[]

object (AdTextAsset)

Aset teks judul iklan. Lebar tampilan maksimum adalah 30. Minimal 1 dan maksimal 5 judul dapat ditentukan.

descriptions[]

object (AdTextAsset)

Teks deskriptif pada iklan. Lebar tampilan maksimum adalah 90. Anda dapat menentukan minimal 1 dan maksimal 5 deskripsi.

businessName

string

Nama pengiklan/merek. Lebar tampilan maksimum adalah 25. Wajib.

callToActionText

string

Teks pesan ajakan (CTA).

leadFormOnly

boolean

Opsi boolean yang menunjukkan apakah iklan ini harus ditayangkan dengan formulir prospek.

DiscoveryCarouselAdInfo

Iklan carousel discovery.

Representasi JSON
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Kolom
businessName

string

Wajib. Nama pengiklan/merek.

logoImage

object (AdImageAsset)

Wajib. Gambar logo yang akan digunakan dalam iklan. Ukuran minimum adalah 128x128 dan rasio aspek harus 1:1 (+-1%).

headline

object (AdTextAsset)

Wajib. Judul iklan.

description

object (AdTextAsset)

Wajib. Teks deskriptif pada iklan.

callToActionText

string

Teks pesan ajakan (CTA).

carouselCards[]

object (AdDiscoveryCarouselCardAsset)

Wajib. Kartu carousel yang akan ditampilkan dengan iklan. Min 2 maks 10.

AdDiscoveryCarouselCardAsset

Aset kartu carousel discovery yang digunakan di dalam iklan.

Representasi JSON
{
  "asset": string
}
Kolom
asset

string

Nama resource Aset kartu carousel discovery ini.

DiscoveryVideoResponsiveAdInfo

Iklan responsif video Discovery.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk judul pendek.

longHeadlines[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk judul panjang.

descriptions[]

object (AdTextAsset)

Daftar aset teks yang digunakan untuk deskripsi.

videos[]

object (AdVideoAsset)

Daftar aset video YouTube yang digunakan untuk iklan.

logoImages[]

object (AdImageAsset)

Gambar logo yang akan digunakan dalam iklan. Jenis gambar yang valid adalah GIF, JPEG, dan PNG. Ukuran minimum adalah 128x128 dan rasio aspek harus 1:1 (+-1%).

breadcrumb1

string

Bagian pertama teks yang muncul dalam iklan dengan URL yang ditampilkan.

breadcrumb2

string

Bagian kedua teks yang muncul di iklan dengan URL yang ditampilkan.

businessName

object (AdTextAsset)

Wajib. Nama pengiklan/merek.

callToActions[]

object (AdCallToActionAsset)

Aset jenis CallToActionAsset yang digunakan untuk tombol "Pesan Ajakan (CTA)".

AdCallToActionAsset

Aset pesan ajakan (CTA) yang digunakan di dalam iklan.

Representasi JSON
{
  "asset": string
}
Kolom
asset

string

Nama resource Aset aset pesan ajakan (CTA) ini.

TravelAdInfo

Jenis ini tidak memiliki kolom.

Iklan perjalanan.

Metode

get

Menampilkan iklan yang diminta secara detail.

mutate

Memperbarui iklan.