- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters
- CallExtensionParameters
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ForecastingSetTargetCpaParameters
- LeadFormAssetParameters
- ApplyRecommendationResult
- Cobalah!
Menerapkan rekomendasi yang diberikan dengan parameter penerapan yang sesuai.
Daftar error yang ditampilkan: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
Permintaan HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:apply
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
customerId |
Wajib. ID pelanggan dengan rekomendasi. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"operations": [
{
object ( |
Kolom | |
---|---|
operations[] |
Wajib. Daftar operasi untuk menerapkan rekomendasi. Jika partialKegagalan=false, semua rekomendasi harus memiliki jenis yang sama. Ada batas 100 operasi per permintaan. |
partialFailure |
Jika true (benar), operasi yang berhasil akan dilakukan dan operasi yang tidak valid akan menampilkan error. Jika salah (false), operasi akan dilakukan sebagai transaksi jika dan hanya jika semuanya valid. Defaultnya adalah false. |
Isi respons
Pesan respons untuk RecommendationService.ApplyRecommendation
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "results": [ { object ( |
Kolom | |
---|---|
results[] |
Hasil operasi untuk menerapkan rekomendasi. |
partialFailureError |
Error yang berkaitan dengan kegagalan operasi dalam mode kegagalan sebagian. Ditampilkan hanya jika partialFailure = true dan semua error terjadi di dalam operasi. Jika terjadi error di luar operasi (misalnya, error autentikasi), kami akan menampilkan error tingkat RPC. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/adwords
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ApplyRecommendationOperation
Informasi tentang operasi untuk menerapkan rekomendasi dan parameter apa pun untuk menyesuaikannya.
Representasi JSON |
---|
{ "resourceName": string, // Union field |
Kolom | |
---|---|
resourceName |
Nama resource rekomendasi yang akan diterapkan. |
Kolom union apply_parameters . Parameter yang akan digunakan saat menerapkan rekomendasi. apply_parameters hanya ada berupa salah satu diantara berikut: |
|
campaignBudget |
Parameter opsional yang digunakan saat menerapkan rekomendasi anggaran kampanye. |
textAd |
Parameter opsional yang akan digunakan saat menerapkan rekomendasi iklan teks. |
keyword |
Parameter opsional yang akan digunakan saat menerapkan rekomendasi kata kunci. |
targetCpaOptIn |
Parameter opsional yang digunakan ketika menerapkan rekomendasi keikutsertaan Target CPA. |
targetRoasOptIn |
Parameter opsional yang digunakan ketika menerapkan rekomendasi keikutsertaan Target ROAS. |
calloutExtension |
Parameter yang akan digunakan saat menerapkan rekomendasi ekstensi info. |
callExtension |
Parameter yang akan digunakan saat menerapkan rekomendasi ekstensi panggilan. |
sitelinkExtension |
Parameter yang akan digunakan saat menerapkan rekomendasi sitelink. |
moveUnusedBudget |
Parameter yang akan digunakan saat menerapkan rekomendasi pindahkan anggaran yang tidak digunakan. |
responsiveSearchAd |
Parameter yang akan digunakan saat menerapkan rekomendasi iklan penelusuran responsif. |
useBroadMatchKeyword |
Parameter yang akan digunakan saat menerapkan rekomendasi kata kunci pencocokan luas. |
responsiveSearchAdAsset |
Parameter yang akan digunakan saat menerapkan rekomendasi aset iklan penelusuran responsif. |
responsiveSearchAdImproveAdStrength |
Parameter yang akan digunakan saat menerapkan rekomendasi untuk meningkatkan daya iklan pada iklan penelusuran responsif. |
raiseTargetCpaBidTooLow |
Parameter yang akan digunakan ketika menerapkan rekomendasi peningkatan bid Target CPA terlalu rendah. Penerapannya bersifat asinkron dan dapat memerlukan waktu beberapa menit bergantung pada jumlah grup iklan yang ada di kampanye terkait. |
forecastingSetTargetRoas |
Parameter yang akan digunakan saat menerapkan rekomendasi target ROAS yang ditetapkan. |
calloutAsset |
Parameter yang akan digunakan saat menerapkan rekomendasi aset info. |
callAsset |
Parameter yang akan digunakan saat menerapkan rekomendasi aset panggilan. |
sitelinkAsset |
Parameter yang akan digunakan saat menerapkan rekomendasi aset sitelink. |
raiseTargetCpa |
Parameter yang akan digunakan saat menerapkan rekomendasi peningkatan Target CPA. |
lowerTargetRoas |
Parameter yang akan digunakan saat menerapkan rekomendasi Target ROAS yang lebih rendah. |
forecastingSetTargetCpa |
Parameter yang akan digunakan saat menerapkan perkiraan, tetapkan rekomendasi target CPA. |
setTargetCpa |
Parameter yang akan digunakan saat menerapkan rekomendasi target CPA yang ditetapkan. |
setTargetRoas |
Parameter yang akan digunakan saat menerapkan rekomendasi target ROAS yang ditetapkan. |
leadFormAsset |
Parameter yang akan digunakan saat menerapkan rekomendasi aset formulir prospek. |
CampaignBudgetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi anggaran kampanye.
Representasi JSON |
---|
{ "newBudgetAmountMicros": string } |
Kolom | |
---|---|
newBudgetAmountMicros |
Jumlah anggaran baru yang harus ditetapkan untuk resource anggaran target. Kolom ini wajib diisi. |
TextAdParameters
Parameter yang akan digunakan saat menerapkan rekomendasi iklan teks.
Representasi JSON |
---|
{
"ad": {
object ( |
Kolom | |
---|---|
ad |
Iklan baru untuk ditambahkan ke grup iklan yang direkomendasikan. Semua kolom yang diperlukan harus ditetapkan dalam pesan ini. Kolom ini wajib diisi. |
KeywordParameters
Parameter yang akan digunakan saat menerapkan rekomendasi kata kunci.
Representasi JSON |
---|
{
"matchType": enum ( |
Kolom | |
---|---|
matchType |
Jenis pencocokan kata kunci. Kolom ini wajib diisi. |
adGroup |
Resource grup iklan yang akan ditambahi kata kunci. Kolom ini wajib diisi. |
cpcBidMicros |
Opsional, bid CPC yang akan ditetapkan untuk kata kunci. Jika tidak ditetapkan, kata kunci akan menggunakan bid berdasarkan strategi bidding yang digunakan oleh grup iklan target. |
TargetCpaOptInParameters
Parameter yang akan digunakan saat menerapkan rekomendasi Target CPA.
Representasi JSON |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
Kolom | |
---|---|
targetCpaMicros |
CPA rata-rata yang akan digunakan untuk strategi bidding Target CPA. Kolom ini wajib diisi. |
newCampaignBudgetAmountMicros |
Atau, jumlah anggaran yang harus ditetapkan untuk kampanye. |
TargetRoasOptInParameters
Parameter yang akan digunakan saat menerapkan rekomendasi keikutsertaan Target ROAS.
Representasi JSON |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
Kolom | |
---|---|
targetRoas |
ROAS (pendapatan per unit pembelanjaan) rata-rata yang dapat digunakan untuk strategi bidding Target ROAS. Nilainya adalah antara 0,01 dan 1000,0, inklusif. Kolom ini wajib diisi, kecuali jika newCampaignBudgetAmountMicros ditetapkan. |
newCampaignBudgetAmountMicros |
Atau, jumlah anggaran yang harus ditetapkan untuk kampanye. |
CalloutExtensionParameters
Parameter yang akan digunakan saat menerapkan rekomendasi ekstensi info.
Representasi JSON |
---|
{
"calloutExtensions": [
{
object ( |
Kolom | |
---|---|
calloutExtensions[] |
Ekstensi info yang akan ditambahkan. Kolom ini wajib diisi. |
CallExtensionParameters
Parameter yang akan digunakan saat menerapkan rekomendasi ekstensi panggilan.
Representasi JSON |
---|
{
"callExtensions": [
{
object ( |
Kolom | |
---|---|
callExtensions[] |
Ekstensi panggilan akan ditambahkan. Kolom ini wajib diisi. |
SitelinkExtensionParameters
Parameter yang akan digunakan saat menerapkan rekomendasi sitelink.
Representasi JSON |
---|
{
"sitelinkExtensions": [
{
object ( |
Kolom | |
---|---|
sitelinkExtensions[] |
Sitelink yang akan ditambahkan. Kolom ini wajib diisi. |
MoveUnusedBudgetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi pindahkan anggaran yang tidak digunakan.
Representasi JSON |
---|
{ "budgetMicrosToMove": string } |
Kolom | |
---|---|
budgetMicrosToMove |
Jumlah anggaran untuk dipindahkan dari kelebihan anggaran ke anggaran terbatas. Kolom ini wajib diisi. |
ResponsiveSearchAdParameters
Parameter yang akan digunakan saat menerapkan rekomendasi iklan penelusuran responsif.
Representasi JSON |
---|
{
"ad": {
object ( |
Kolom | |
---|---|
ad |
Wajib. Iklan baru untuk ditambahkan ke grup iklan yang direkomendasikan. |
UseBroadMatchKeywordParameters
Parameter yang akan digunakan saat menerapkan rekomendasi kata kunci pencocokan luas.
Representasi JSON |
---|
{ "newBudgetAmountMicros": string } |
Kolom | |
---|---|
newBudgetAmountMicros |
Jumlah anggaran baru yang harus ditetapkan untuk resource anggaran target. |
ResponsiveSearchAdAssetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi aset iklan penelusuran responsif.
Representasi JSON |
---|
{
"updatedAd": {
object ( |
Kolom | |
---|---|
updatedAd |
Iklan diperbarui. Konten iklan saat ini akan diganti. |
ResponsiveSearchAdImproveAdStrengthParameters
Parameter yang akan digunakan saat menerapkan rekomendasi untuk meningkatkan daya iklan pada iklan penelusuran responsif.
Representasi JSON |
---|
{
"updatedAd": {
object ( |
Kolom | |
---|---|
updatedAd |
Iklan diperbarui. Konten iklan saat ini akan diganti. |
RaiseTargetCpaBidTooLowParameters
Parameter yang akan digunakan ketika menerapkan rekomendasi peningkatan bid Target CPA terlalu rendah. Penerapannya bersifat asinkron dan dapat memerlukan waktu beberapa menit bergantung pada jumlah grup iklan yang ada di kampanye terkait.
Representasi JSON |
---|
{ "targetMultiplier": number } |
Kolom | |
---|---|
targetMultiplier |
Wajib. Angka yang lebih besar dari 1,0 menunjukkan faktor yang digunakan untuk meningkatkan target CPA. Kolom ini wajib diisi. |
ForecastingSetTargetRoasParameters
Parameter yang akan digunakan saat menerapkan rekomendasi target ROAS yang ditetapkan perkiraan.
Representasi JSON |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
Kolom | |
---|---|
targetRoas |
Target ROAS (pendapatan per unit pembelanjaan) baru yang akan ditetapkan untuk resource kampanye. Nilainya adalah antara 0,01 dan 1000,0, inklusif. |
campaignBudgetAmountMicros |
Jumlah anggaran kampanye baru yang harus ditetapkan untuk resource kampanye. |
CalloutAssetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi aset info.
Representasi JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Kolom | |
---|---|
adAssetApplyParameters |
Wajib. Aset info yang akan ditambahkan. Kolom ini wajib diisi. |
AdAssetApplyParameters
Parameter umum yang digunakan saat menerapkan rekomendasi aset iklan.
Representasi JSON |
---|
{ "newAssets": [ { object ( |
Kolom | |
---|---|
newAssets[] |
Aset untuk dibuat dan dilampirkan ke cakupan. Aset ini dapat digabungkan dengan aset yang ada dalam panggilan yang sama. |
existingAssets[] |
Nama resource dari aset yang ada untuk dilampirkan ke cakupan. Ini dapat digabungkan dengan aset baru dalam panggilan yang sama. |
scope |
Wajib. Cakupan tempat aset akan diterapkan. Aset di tingkat cakupan kampanye akan diterapkan ke kampanye yang terkait dengan rekomendasi. Aset di cakupan pelanggan akan berlaku untuk seluruh akun. Aset pada cakupan kampanye akan menggantikan aset apa pun yang disertakan dalam cakupan pelanggan. |
ApplyScope
Cakupan tempat aset akan diterapkan.
Enum | |
---|---|
UNSPECIFIED |
Cakupan penerapan belum ditentukan. |
UNKNOWN |
Tidak diketahui. |
CUSTOMER |
Terapkan sesuai cakupan pelanggan. |
CAMPAIGN |
Ajukan permohonan sesuai cakupan kampanye. |
CallAssetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi aset panggilan.
Representasi JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Kolom | |
---|---|
adAssetApplyParameters |
Wajib. Aset panggilan yang akan ditambahkan. Kolom ini wajib diisi. |
SitelinkAssetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi aset sitelink.
Representasi JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Kolom | |
---|---|
adAssetApplyParameters |
Wajib. Aset sitelink akan ditambahkan. Kolom ini wajib diisi. |
RaiseTargetCpaParameters
Parameter yang akan digunakan saat menerapkan rekomendasi peningkatan Target CPA.
Representasi JSON |
---|
{ "targetCpaMultiplier": number } |
Kolom | |
---|---|
targetCpaMultiplier |
Wajib. Target untuk menetapkan pengganda CPA. Kolom ini wajib diisi. |
LowerTargetRoasParameters
Parameter yang akan digunakan saat menerapkan rekomendasi Target ROAS yang lebih rendah.
Representasi JSON |
---|
{ "targetRoasMultiplier": number } |
Kolom | |
---|---|
targetRoasMultiplier |
Wajib. Target untuk menetapkan pengganda ROAS. Kolom ini wajib diisi. |
ForecastingSetTargetCpaParameters
Parameter yang akan digunakan ketika menerapkan rekomendasi target CPA yang ditetapkan.
Representasi JSON |
---|
{ "targetCpaMicros": string, "campaignBudgetAmountMicros": string } |
Kolom | |
---|---|
targetCpaMicros |
CPA rata-rata yang akan digunakan untuk strategi bidding Target CPA. |
campaignBudgetAmountMicros |
Jumlah anggaran kampanye baru yang harus ditetapkan untuk resource kampanye. |
LeadFormAssetParameters
Parameter yang akan digunakan saat menerapkan rekomendasi aset formulir prospek.
Representasi JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Kolom | |
---|---|
adAssetApplyParameters |
Wajib. Aset formulir prospek akan ditambahkan. Kolom ini wajib diisi. |
setSubmitLeadFormAssetCampaignGoal |
Jika benar, sasaran "Kirim Formulir Prospek" akan ditetapkan di kampanye target. Akibatnya, iklan akan ditampilkan sebagai iklan materi iklan formulir prospek. Jika salah, sasaran "Kirim Formulir Prospek" tidak akan ditetapkan di kampanye dan iklan akan berisi aset formulir prospek. |
ApplyRecommendationResult
Hasil dari penerapan rekomendasi.
Representasi JSON |
---|
{ "resourceName": string } |
Kolom | |
---|---|
resourceName |
Dikembalikan jika permohonan berhasil. |