Bu sayfa, Cloud Translation API ile çevrilmiştir.

GZT Sorun Giderme

Bu kılavuzda, programatik olarak erişmenize olanak tanıyan GZT sorun giderme kaynakları gerçek zamanlı teklif verme kampanya metriklerini de GZT Dökümü aracı, Authorized Buyers kullanıcı arayüzü. Bunlar arasında bidders.filterSets, bidders.accounts.filterSets ve altındaki tüm kaynakları hiyerarşik olarak düzenler.

GZT sorun giderme kaynaklarındaki metrikleri kullanarak kaçırılan fırsatlar hakkında bilgi edinebilirsiniz gerçek zamanlı teklif kampanyanızı optimize etmenize yardımcı olabilecek gösterimler kazanmak için

API yapısı ve stilinde yapılan düzenlemeler

GZT sorun giderme kaynaklarında, hesabın sahibi olduğunuzu ve bunu net bir şekilde döndüren veriler üzerinde daha ayrıntılı denetime sahip olmanızı ve Google'ın reklamcılık ile kullanımına daha uygun Google API tasarım uygulamaları.

Teklif veren ve hesap düzeyindeki kaynaklar

Kaynaklar hem bidders hem de bidders.accounts altında yapılandırılır. Bunlar, projeniz için API çağrısının teklif vereni (üst hesap olarak da bilinir) hedefleyip hedeflemediğini ve alt hesaplar veya bireysel Authorized Buyers hesapları olabilir. GZT bağlamında Sorun giderme: bidders.filterSets altında yapılandırılan kaynaklar, toplu metrikleri döndürür. teklif verene ve ilişkili tüm alt hesaplara yöneliktir. Öte yandan, bidders.accounts.filterSets, arama sonuçlarından bağımsız olarak yalnızca belirtilen hesaba ait metrikleri döndürür. hem de alt hesap olabilir.

Not: Teklif verme yetkisini başka bir alıcıya veren hesaplar teklif veren hesabı değildir ve ve teklif veren düzeyinde kaynaklara erişemez. Ayrıca teklif veren olmayan hesaplar hesap düzeyindeki impressionMetrics, filteredBidResponses, bidResponseErrors ve bidResponsesWithoutBids kaynaklar.

Kaynak adlarını benzersiz tanımlayıcılar olarak kullanıma sunma

Kaynak adları şu şekilde kullanılır: benzersiz tanımlayıcılar kullanır. Belirli bir öğenin yeni bir örneğini oluştururken bir kaynak türü belirtiyorsanız artık akraba kaynağın URI yolunu ve ardından tercih edilen kaynak kimliğini kullanarak bir kaynak adını belirtin. İlgili içeriği oluşturmak için kullanılan Aşağıda GZT Sorun giderme kaynaklarıyla ilgili ad örnekleri verilmiştir:

Kaynak	Ad örneği
bidders.filterSets	bidders/12345678/filterSets/fset_1
bidders.accounts.filterSets	bidders/12345678/accounts/87654321/filterSets/fset_2

Not: Adda bidders için belirtilen kaynak kimliği, teklif verenin kimliği olmalıdır Authorized Buyers hesap kimliği. accounts için kaynak kimliği, teklif verene veya teklif veren tarafından yönetilen bir alt hesaba. Hangi Authorized Buyers'ı bilmiyorsanız Google Hesabınızla ilişkilendirilmiş hesap varsa, accounts.list yöntemini kullanabilirsiniz.

Filtre grupları

Filtre grubu, kullanılabilen filtreleme seçeneklerini temsil eder ve oluşturulabilir. teklif verenler veya hesap düzeyinde ayarlar. GZT Sorun Giderme liste sonuçlarını filtrelemek için kullanılır kaynaklar arasında yer alır.

Metrikler alınırken uygulanan filtre, belirtilen metrikteki her bir filtrenin kesişimidir. filtre grubu. platforms gibi liste filtreleri, listedeki her öğenin birleşimi olarak yorumlanır.

Teklif veren ve hesap düzeyinde filtre grupları birbirinden farklıdır ve yalnızca bu kümelere oluşturmak için kullanılan hesaptan bağımsız olarak oluşturulur. Teklif veren ve alt hesap paylaşımı hesap düzeyinde oluşturulmuş filtre grupları, ancak yalnızca teklif verenler teklif veren düzeyidir. Aşağıdaki tabloda, teklif verenin ve alt hesapların kaynaklara nasıl erişebileceği özetlenmiştir. iki düzeyde de:

	bidders.filterSets	bidders.accounts.filterSets
Teklif Veren Hesabı	Yalnızca teklif veren düzeyindeki filtre gruplarını etkileyen bir API çağrısı.	Yalnızca hesap düzeyindeki filtre gruplarını etkileyen bir API çağrısı.
Alt Hesap	Bu API çağrısı hata yanıtı döndürür.	Yalnızca hesap düzeyindeki filtre gruplarını etkileyen bir API çağrısı.

Filtre grubu oluştur

Filtre grubu oluştururken zaman aralığını relativeDateRange, absoluteDateRange veya realtimeTimeRange. Metrikleri alırken tüm zaman aralığı boyunca verilerin sağlanması varsayılan davranıştır. Gelecekteki zaman aralığı üzerinde bir zaman serisi dökümü, timeSeriesGranularity belirtebilirsiniz değerini girin.HOURLYDAILY

Yalnızca kısa bir süre için filtre ayarlanmasına ihtiyaç duyarsanız isTransient sorgu parametresini true olarak ayarlayın. Bu, filtre grubunun geçici olduğunu, yani süresiz olarak uygulanmayacağını gösterir. Geçici filtre grupları, oluşturulduktan sonra en az bir saat boyunca kullanılabilir ancak daha sonra silinir. Varsayılan olarak filtre grupları geçici değildir.

Teklif veren düzeyinde örnek

Yeni bir teklif veren düzeyinde filtre grubu oluşturmak için bidders.filterSets kaynak URI'sine aşağıdaki biçimde bir POST isteği gönderin:

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets

Uyarı: Teklif veren düzeyindeki filtre grupları, reklam öğesi veya anlaşma kimliklerine göre filtreleme yapamaz. Teklif veren düzeyinde filtre grubu oluştururken bu filtreleri belirtirseniz hata yanıtı alırsınız.

İstek

Aşağıda, geçici olmayan teklif veren düzeyinde yeni bir filtre grubu oluşturan POST isteği örneğini görebilirsiniz:

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Yanıt

İstek başarılı olursa, sunucu 200 OK durum koduyla yanıt verir. Yanıt gövdesi, oluşturulan filtre grubu kaynağını içerir. Bu kaynak, istekte gönderilen filtre grubuyla aynı olur.

Hesap düzeyinde örnek

Hesap düzeyinde yeni bir filtre grubu oluşturmak için bir POST isteği Şu biçimde olan bidders.accounts.filterSets kaynak URI'si:

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets

Not: accounts için belirtilen kaynak kimliği şunları yapabilir: Teklif verenin erişebildiği herhangi bir Authorized Buyers hesabının hesap kimliği olmalıdır teklif veren hesabının kendisi de dahil olmak üzere URI'de belirtilen hesap.

İstek

Aşağıda, hesap düzeyinde geçici olmayan yeni bir filtre grubu oluşturan POST isteği örneği verilmiştir:

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Yanıt

İstek başarılı olursa, sunucu 200 OK durum koduyla yanıt verir. Yanıt gövdesi, oluşturulan filtre grubu kaynağını dahil edecektir. Bu kaynak, talep ediyor.

Filtre grubu al

Get yöntemi, yalnızca oluşturulduğu düzeydeki bir filtreyi alabilir. Örneğin, teklif veren hesap, hesapta oluşturulan bir filtre grubunu almak için bidders.accounts.filterSets.get öğesini kullanmalıdır düzeyi için bidders.filterSets.get yöntemini kullanmanızı öneririz.

Teklif veren düzeyi

bidders.filterSets kaynak URI'sine aşağıdaki biçimde bir HTTP GET isteği göndererek teklif veren düzeyinde filtre grubu alabilirsiniz:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}

İstek

Aşağıda bununla ilgili bir örnek verilmiştir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs

Yanıt

İstek başarılı olursa sunucu bir 200 OK HTTP durum kodu ve alınan filtre grubuyla yanıt verir:

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Hesap düzeyi

bidders.accounts.filterSets kaynak URI'sine aşağıdaki biçimde bir HTTP GET isteği göndererek hesap düzeyinde filtre grubu alabilirsiniz:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}

İstek

Aşağıda bununla ilgili bir örnek verilmiştir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs

Yanıt

İstek başarılı olursa sunucu bir 200 OK HTTP durum kodu ve alınan filtre grubuyla yanıt verir:

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Filtre gruplarını listele

Liste yöntemi, yalnızca çağrıldığı düzeyden erişilebilen filtre gruplarını döndürür. Örneğin, teklif veren hesabı kendisi için oluşturulan filtre gruplarını bidders.filterSets.list aranıyor. bidders.accounts.filterSets.create

Teklif veren düzeyi

Belirli bir teklif veren için teklif veren düzeyindeki tüm filtre gruplarını HTTP GET göndererek alabilirsiniz bidders.filtersets kaynak URI'sine istek gönderelim. Bu istek aşağıdaki biçimdedir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets

İstek

Aşağıda, hesap kimliği 12345678 olan bir teklif veren için teklif veren düzeyindeki tüm filtre gruplarının listelendiği bir örnek verilmiştir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets

Yanıt

{
  "filterSets": [{
      "filterSetId": "99994",
      "name": "bidders/12345678/filterSets/test-b-1",
      "relativeDateRange": {
        "durationDays": 30
      }
    },
    {
      "realtimeTimeRange": {
        "startTimeStamp": "2017-11-15T12:30:30.072831583Z"
      },
      "filterSetId": "99995",
      "name": "bidders/12345678/filterSets/test-b-2",
      "timeSeriesGranularity": "HOURLY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 12,
          "month": 3,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99996",
      "name": "bidders/12345678/filterSets/bidder-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["TABLET", "MOBILE"],
      "environment": "APP",
      "format": "DISPLAY"
    }
  ]
}

Hesap düzeyi

HTTP GET göndererek belirli bir hesap için hesap düzeyindeki tüm filtre gruplarını alabilirsiniz. bidders.accounts.filtersets kaynak URI'sine istek gönderelim. Bu istek aşağıdaki biçimdedir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets

İstek

Hesap kimliği 87654321 olan bir alt hesap için hesap düzeyindeki tüm filtre gruplarının listelendiği bir örneği burada bulabilirsiniz:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets

Yanıt

{
  "filterSets": [{
        "realtimeTimeRange": {
        "startTimeStamp": "2017-11-19T04:24:43.252893487Z"
      },
      "filterSetId": "99997",
      "name": "bidders/12345678/accounts/87654321/filterSets/test-a-1",
      "timeSeriesGranularity": "DAILY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 3,
          "month": 12,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99998",
      "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["DESKTOP"],
      "environment": "WEB",
      "format": "VIDEO"
    }
  ]
}

Filtre grubunu silme

Geçici olmayan filtre gruplarını kaldırmak için delete yöntemini kullanabilirsiniz gerek yoktur. Yalnızca çağrıldığı düzeyden erişilebilen filtre gruplarını kaldırabilir; Örneğin, bir teklif veren hesabı bidders.accounts.filterSets.create ile oluşturulan bir filtre grubunu silemez bidders.filterSets.delete ile.

Teklif veren düzeyi

HTTP DELETE isteği göndererek belirli bir hesap için teklif veren seviyesindeki filtreyi silebilirsiniz bidders.filtersets kaynak URI'sine ekleyin:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}

İstek

Aşağıda, teklif veren düzeyinde filtre grubunu silmeyle ilgili bir örnek verilmiştir:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/test-b-2

Yanıt

Başarılı olursa isteğin gövdesi boş olur. Belirtilen filtre grubuna artık erişilemiyor.

Hesap düzeyi

HTTP DELETE göndererek belirli bir hesap için hesap düzeyindeki filtre grubunu silebilirsiniz. bidders.accounts.filtersets kaynak URI'sine istek gönderelim. Bu istek aşağıdaki biçimdedir:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}

İstek

Aşağıda, hesap düzeyindeki bir filtre grubunu silmeyle ilgili bir örnek verilmiştir:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/test-a-1

Yanıt

Başarılı olursa isteğin gövdesi boş olur. Belirtilen filtre grubuna artık erişilemiyor.

GZT sorun giderme metriklerini alma

Metrikleri almak için kullanılan tüm GZT sorun giderme kaynakları benzer bir şekilde çalışır. filterSetName yolu ile belirtilen filtre grubuna ait metrikleri listelemek için tek bir yöntem parametresinden sonra bir değer girin. Belirtilen filtre grubu, daha fazla bilgi edindiniz. Bu kaynakların teklif veren düzeyinden çağrılması durumunda toplu metrikler döndürülür teklif veren hesabından ve ilişkili tüm alt hesaplardan, hesap düzeyinden ise yalnızca tek bir hesaba ait metrikleri döndürür.

Teklif Metrikleri

bidMetrics kaynağı, şurada ölçülen metrikleri almak için kullanılır: teklif sayısı. Örneğin, bu değeri bir dönüşüm başına toplam teklif sayınızı belirlemek için kullanabilirsiniz. ve bunlardan kaç tanesinin açık artırmadan filtrelenmediğini, kaç tanesinin bir gösterim kazandığını, Örneğin, metrikleri toplamak için kullanılan diğer tüm GZT sorun giderme kaynakları gibi yalnızca bir list yöntemi vardır.

Teklif veren düzeyinde teklif metriklerini listeleme

HTTP GET göndererek belirli bir filtre grubu için teklif veren düzeyindeki teklif metriklerini listeleyebilirsiniz. bidders.filtersets.bidMetrics kaynak URI'sine istek gönderelim. Bu istek aşağıdaki biçimdedir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}/bidMetrics

İstek

Aşağıda, teklif veren düzeyinde teklif metriklerinin listelendiği bir örnek verilmiştir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs/bidMetrics

Yanıt

İstek başarılı olursa sunucu bir 200 OK durum kodu ve belirtilen boyutlar ile ayrıntı düzeyi için metrik satırlarını içeren bir gövde ile yanıt verir.

{
  "bidMetricsRows": [{
        "bids": {
        "value": "6160"
      },
      "bidsInAuction": {
        "value": "5698"
      },
      "billedImpressions": {
        "value": "1196"
      },
      "impressionsWon": {
        "value": "2920"
      },
      "measurableImpressions": {
        "value": "1160"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-29T08:00:00Z",
          "startTime": "2017-11-28T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "683"
      }
    },
    {
      "bids": {
        "value": "104288"
      },
      "bidsInAuction": {
        "value": "94016"
      },
      "billedImpressions": {
        "value": "99"
      },
      "impressionsWon": {
        "value": "125"
      },
      "measurableImpressions": {
        "value": "94"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-30T08:00:00Z",
          "startTime": "2017-11-29T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "87"
      }
    },
    {
      "bids": {
        "value": "3999"
      },
      "bidsInAuction": {
        "value": "3631"
      },
      "billedImpressions": {
        "value": "618"
      },
      "impressionsWon": {
        "value": "1819"
      },
      "measurableImpressions": {
        "value": "604"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "369"
      }
    },
    {
      "bids": {
        "value": "15"
      },
      "bidsInAuction": {
        "value": "3"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "3"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

Not: Belirli bir metrik için 0 olarak ayarlanan alanlar yanıtta görünmez. Yukarıdaki boş billedImpressions ve measurableImpressions metrikleri hem değerin hem de varyansının 0 olarak ayarlandığını gösterir.

Uyarı: Yanıttaki verilerin dökümü satırları, sıfır olmayan en az bir metrik içermiyorsa dahil edin. Örneğin, timeSeriesGranularity belirtilmişse yanıt, Tüm metriklerin sıfır olduğu, filtre grubunun belirtilen zaman aralığında timeInterval.

Hesap düzeyindeki teklif metriklerini listele

Bir HTTP GET göndererek belirli bir filtre grubu için hesap düzeyindeki teklif metriklerini listeleyebilirsiniz. bidders.accounts.filtersets.bidMetrics kaynak URI'sına isteği. şu biçimdedir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}/bidMetrics

İstek

Aşağıda, hesap düzeyindeki teklif metriklerinin listelendiği bir örnek verilmiştir:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs/bidMetrics

Yanıt

İstek başarılı olursa sunucu bir 200 OK durum kodu ve belirtilen boyutlar ile ayrıntı düzeyi için metrik satırlarını içeren bir gövde ile yanıt verir.

{
  "bidMetricsRows": [{
      "bids": {
        "value": "1748"
      },
      "bidsInAuction": {
        "value": "1421"
      },
      "billedImpressions": {
        "value": "301"
      },
      "impressionsWon": {
        "value": "915"
      },
      "measurableImpressions": {
        "value": "298"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "172"
      }
    },
    {
      "bids": {
        "value": "6"
      },
      "bidsInAuction": {
        "value": "2"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "1"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

Not: Belirli bir metrik için 0 olarak ayarlanan alanlar yanıtta görünmez. İlgili içeriği oluşturmak için kullanılan yukarıdaki boş billedImpressions ve measurableImpressions metrikleri şunu belirtir: hem değeri hem de varyansı 0 olarak ayarlanır.

Uyarı: Yanıtta yer alan tüm veri dökümleri için satırlarını sıfır olmayan en az bir metrik içermiyorsa. Örneğin, timeSeriesGranularity belirtilmişse yanıt, Tüm metriklerin sıfır olduğu, filtre grubunun belirtilen zaman aralığında timeInterval.