- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- 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
- Deneyin.
Verilen önerileri karşılık gelen uygulama parametreleriyle uygular.
Atılan hataların listesi: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
HTTP isteği
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:apply
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Öneriyi içeren müşterinin kimliği. |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"operations": [
{
object ( |
Alanlar | |
---|---|
operations[] |
Zorunlu. Önerilerin uygulanacağı işlemlerin listesi. kısmiFailure=false tüm öneriler aynı türde olmalıdır. İstek başına 100 işlem sınırı vardır. |
partialFailure |
Doğru değerine ayarlanırsa başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış değerine ayarlanırsa işlemler, yalnızca hepsinin geçerli olması durumunda işlem olarak gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir. |
Yanıt gövdesi
RecommendationService.ApplyRecommendation
için yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "results": [ { object ( |
Alanlar | |
---|---|
results[] |
Önerileri uygulamak için yapılan işlemlerin sonuçları. |
partialFailureError |
Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve tüm hatalar işlemler içinde ortaya çıktığında döndürülür. İşlemler dışında herhangi bir hata oluşursa (örneğin, kimlik doğrulama hataları) RPC düzeyinde hatayı döndürürüz. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/adwords
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
ApplyRecommendationOperation
Bir öneriyi uygulama işlemi ve öneriyi özelleştirmek için kullanılan parametreler hakkında bilgiler.
JSON gösterimi |
---|
{ "resourceName": string, // Union field |
Alanlar | |
---|---|
resourceName |
Uygulanacak önerinin kaynak adı. |
Birleştirme alanı apply_parameters . Öneri uygulanırken kullanılacak parametreler. apply_parameters şunlardan yalnızca biri olabilir: |
|
campaignBudget |
Kampanya bütçe önerisini uygularken kullanılacak isteğe bağlı parametreler. |
textAd |
Metin reklam önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
keyword |
Anahtar kelime önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
targetCpaOptIn |
Hedef EBM etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
targetRoasOptIn |
Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
calloutExtension |
Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler. |
callExtension |
Telefon uzantısı önerisi uygulanırken kullanılacak parametreler. |
sitelinkExtension |
Site bağlantısı önerisi uygulanırken kullanılacak parametreler. |
moveUnusedBudget |
Kullanılmayan bütçe taşıma önerisi uygulanırken kullanılacak parametreler. |
responsiveSearchAd |
Duyarlı arama ağı reklamı önerisi uygularken kullanılacak parametreler. |
useBroadMatchKeyword |
Geniş eşlemeli anahtar kelime önerisini uygularken kullanılacak parametreler. |
responsiveSearchAdAsset |
Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler. |
responsiveSearchAdImproveAdStrength |
Duyarlı arama ağı reklamı uygulanırken kullanılacak parametreler, reklam gücü önerisini iyileştirir. |
raiseTargetCpaBidTooLow |
Hedef EBM teklifini artırmanız çok düşük bir öneri olarak uygulanırken kullanılacak parametreler. Uygulama eşzamansızdır ve ilgili kampanyadaki reklam gruplarının sayısına bağlı olarak birkaç dakika sürebilir. |
forecastingSetTargetRoas |
Öngörme grubu hedef ROAS önerisini uygularken kullanılacak parametreler. |
calloutAsset |
Açıklama metni öğesi önerisi uygulanırken kullanılacak parametreler. |
callAsset |
Telefon öğesi önerisi uygulanırken kullanılacak parametreler. |
sitelinkAsset |
Site bağlantısı öğesi önerisi uygulanırken kullanılacak parametreler. |
raiseTargetCpa |
Hedef EBM'yi artırma önerisi uygulanırken kullanılacak parametreler. |
lowerTargetRoas |
Daha düşük Hedef ROAS önerisi uygulanırken kullanılacak parametreler. |
forecastingSetTargetCpa |
Tahmin uygulanırken kullanılacak parametreler hedef EBM önerisini ayarladı. |
setTargetCpa |
Ayarlanan hedef EBM önerisini uygularken kullanılacak parametreler. |
setTargetRoas |
Ayarlanan hedef ROAS önerisini uygularken kullanılacak parametreler. |
leadFormAsset |
Potansiyel müşteri formu öğesi önerisi uygulanırken kullanılacak parametreler. |
CampaignBudgetParameters
Kampanya bütçe önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{ "newBudgetAmountMicros": string } |
Alanlar | |
---|---|
newBudgetAmountMicros |
Hedef bütçe kaynağı için belirlenecek yeni bütçe tutarı. Bu alanının doldurulması zorunludur. |
TextAdParameters
Metin reklam önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{
"ad": {
object ( |
Alanlar | |
---|---|
ad |
Önerilen reklam grubuna eklenecek yeni reklam. Bu mesajda tüm gerekli alanların ayarlanması gerekir. Bu alanının doldurulması zorunludur. |
KeywordParameters
Anahtar kelime önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"matchType": enum ( |
Alanlar | |
---|---|
matchType |
Anahtar kelimenin eşleme türü. Bu alanının doldurulması zorunludur. |
adGroup |
Anahtar kelimenin ekleneceği reklam grubu kaynağı. Bu alanının doldurulması zorunludur. |
cpcBidMicros |
İsteğe bağlı, anahtar kelime için ayarlanacak TBM teklifi. Ayarlanmazsa anahtar kelime, hedef reklam grubu tarafından kullanılan teklif stratejisine dayalı teklifi kullanır. |
TargetCpaOptInParameters
Hedef EBM önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetCpaMicros |
Hedef EBM teklif stratejisi için kullanılacak ortalama EBM. Bu alanının doldurulması zorunludur. |
newCampaignBudgetAmountMicros |
İsteğe bağlı, kampanya için belirlenecek bütçe tutarı. |
TargetRoasOptInParameters
Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetRoas |
Hedef ROAS teklif stratejisi için kullanılacak ortalama ROAS (harcama birimi başına gelir). Değer 0,01 ile 1000,0 arasındadır (0,01 dahil). newCampaignBudgetAmountMicros ayarlanmadığı sürece bu zorunlu bir alandır. |
newCampaignBudgetAmountMicros |
İsteğe bağlı, kampanya için belirlenecek bütçe tutarı. |
CalloutExtensionParameters
Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"calloutExtensions": [
{
object ( |
Alanlar | |
---|---|
calloutExtensions[] |
Ek bilgi uzantıları eklenecek. Bu alanının doldurulması zorunludur. |
CallExtensionParameters
Telefon uzantısı önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"callExtensions": [
{
object ( |
Alanlar | |
---|---|
callExtensions[] |
Eklenecek telefon uzantıları. Bu alanının doldurulması zorunludur. |
SitelinkExtensionParameters
Site bağlantısı önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"sitelinkExtensions": [
{
object ( |
Alanlar | |
---|---|
sitelinkExtensions[] |
Eklenecek site bağlantıları. Bu alanının doldurulması zorunludur. |
MoveUnusedBudgetParameters
Kullanılmayan bütçe taşıma önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "budgetMicrosToMove": string } |
Alanlar | |
---|---|
budgetMicrosToMove |
Fazla bütçeden kısıtlanmış bütçeye aktarılacak bütçe tutarı. Bu alanının doldurulması zorunludur. |
ResponsiveSearchAdParameters
Duyarlı arama ağı reklamı önerisi uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{
"ad": {
object ( |
Alanlar | |
---|---|
ad |
Zorunlu. Önerilen reklam grubuna eklenecek yeni reklam. |
UseBroadMatchKeywordParameters
Geniş eşlemeli anahtar kelime önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{ "newBudgetAmountMicros": string } |
Alanlar | |
---|---|
newBudgetAmountMicros |
Hedef bütçe kaynağı için belirlenecek yeni bütçe tutarı. |
ResponsiveSearchAdAssetParameters
Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{
"updatedAd": {
object ( |
Alanlar | |
---|---|
updatedAd |
Reklam güncellendi. Geçerli reklamın içeriği değiştirilecek. |
ResponsiveSearchAdImproveAdStrengthParameters
Duyarlı arama ağı reklamı uygulanırken kullanılacak parametreler, reklam gücü önerisini iyileştirir.
JSON gösterimi |
---|
{
"updatedAd": {
object ( |
Alanlar | |
---|---|
updatedAd |
Reklam güncellendi. Geçerli reklamın içeriği değiştirilecek. |
RaiseTargetCpaBidTooLowParameters
Hedef EBM teklifini artırmanız çok düşük bir öneri olarak uygulanırken kullanılacak parametreler. Uygulama eşzamansızdır ve ilgili kampanyadaki reklam gruplarının sayısına bağlı olarak birkaç dakika sürebilir.
JSON gösterimi |
---|
{ "targetMultiplier": number } |
Alanlar | |
---|---|
targetMultiplier |
Zorunlu. Hedef EBM'nin artırılacağı faktörü belirten 1,0'dan büyük bir sayı. Bu alanının doldurulması zorunludur. |
ForecastingSetTargetRoasParameters
Öngörme grubu hedef ROAS önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetRoas |
Bir kampanya kaynağı için ayarlanacak yeni hedef ROAS (harcama birimi başına gelir). Değer 0,01 ile 1000,0 arasındadır (0,01 dahil). |
campaignBudgetAmountMicros |
Bir kampanya kaynağı için ayarlanacak yeni kampanya bütçesi tutarı. |
CalloutAssetParameters
Açıklama metni öğesi önerileri uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"adAssetApplyParameters": {
object ( |
Alanlar | |
---|---|
adAssetApplyParameters |
Zorunlu. Eklenecek açıklama metni öğeleri. Bu alanının doldurulması zorunludur. |
AdAssetApplyParameters
Reklam öğesi önerileri uygulanırken kullanılan genel parametreler.
JSON gösterimi |
---|
{ "newAssets": [ { object ( |
Alanlar | |
---|---|
newAssets[] |
Oluşturulacak ve bir kapsama eklenecek öğeler. Bu öğe, aynı çağrıdaki mevcutÖğeler ile birleştirilebilir. |
existingAssets[] |
Bir kapsama eklenecek mevcut öğelerin kaynak adları. Bu öğe, aynı çağrıdaki yeni öğelerle birleştirilebilir. |
scope |
Zorunlu. Öğelerin uygulanacağı kapsam. Kampanya kapsamı düzeyindeki öğeler, öneriyle ilişkili kampanyaya uygulanır. Müşteri kapsamındaki öğeler hesabın tamamı için geçerli olur. Kampanya kapsamındaki öğeler, müşteri kapsamında eklenenleri geçersiz kılar. |
ApplyScope
Öğelerin uygulanacağı kapsam.
Sıralamalar | |
---|---|
UNSPECIFIED |
Uygulama kapsamı belirtilmedi. |
UNKNOWN |
Bilinmiyor. |
CUSTOMER |
Müşteri kapsamında uygulayın. |
CAMPAIGN |
Kampanya kapsamında uygulayın. |
CallAssetParameters
Telefon öğesi önerileri uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"adAssetApplyParameters": {
object ( |
Alanlar | |
---|---|
adAssetApplyParameters |
Zorunlu. Eklenecek telefon öğeleri. Bu alanının doldurulması zorunludur. |
SitelinkAssetParameters
Site bağlantısı öğesi önerileri uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"adAssetApplyParameters": {
object ( |
Alanlar | |
---|---|
adAssetApplyParameters |
Zorunlu. Eklenecek site bağlantısı öğeleri. Bu alanının doldurulması zorunludur. |
RaiseTargetCpaParameters
Hedef EBM önerilerini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetCpaMultiplier": number } |
Alanlar | |
---|---|
targetCpaMultiplier |
Zorunlu. EBM çarpanının ayarlanacağı hedef. Bu alanının doldurulması zorunludur. |
LowerTargetRoasParameters
Daha düşük Hedef ROAS önerileri uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetRoasMultiplier": number } |
Alanlar | |
---|---|
targetRoasMultiplier |
Zorunlu. ROAS çarpanının ayarlanacağı hedef. Bu alanının doldurulması zorunludur. |
ForecastingSetTargetCpaParameters
Belirli bir hedef EBM önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetCpaMicros": string, "campaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetCpaMicros |
Hedef EBM teklif stratejisi için kullanılacak ortalama EBM. |
campaignBudgetAmountMicros |
Bir kampanya kaynağı için ayarlanacak yeni kampanya bütçesi tutarı. |
LeadFormAssetParameters
Potansiyel müşteri formu öğesi önerisini uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{
"adAssetApplyParameters": {
object ( |
Alanlar | |
---|---|
adAssetApplyParameters |
Zorunlu. Eklenecek potansiyel müşteri formu öğeleri. Bu alanının doldurulması zorunludur. |
setSubmitLeadFormAssetCampaignGoal |
Doğru değerine ayarlanırsa hedef kampanyada "Potansiyel Müşteri Formu Gönderme" hedefi ayarlanır. Bu nedenle, reklamlar potansiyel müşteri formu reklam öğesi reklamları olarak gösterilir. Yanlış değerine ayarlanırsa kampanyada "Potansiyel Müşteri Formu Gönderme" hedefi ayarlanmaz ve reklamlar potansiyel müşteri formu öğeleri içerir. |
ApplyRecommendationResult
Bir öneriyi uygulamanın sonucu.
JSON gösterimi |
---|
{ "resourceName": string } |
Alanlar | |
---|---|
resourceName |
Başarılı başvurular için iade edildi. |