檢舉常見問題

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能，協助您建立自訂報表，並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API。

我的報表範圍為何？

針對大多數報表，建議您將 Reports.reportScope 設為特定引擎帳戶或廣告客戶。如果是非常大型的報表 (例如關鍵字報表、轉換報表或設有精細區隔的報表)，建議您將範圍限制在特定引擎帳戶。如果報表列數超過 1,000 萬列，API 可能會傳回錯誤。

為什麼我會收到禁止 (403) 錯誤？

大多數情況下，您需要取得更新 OAuth 權杖。

如何找出代理商和廣告主的 ID？

如果還沒有您有權查看的代理商和廣告客戶 ID，請索取含有 agencyId 和 advertiserId 欄的 advertiser 報表，但不要指定 reportScope。Search Ads 360 會傳回您的 Google 帳戶有權查看的所有代理商和廣告客戶 ID 清單。

要求範例如下：

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

使用 Search Ads 360 公用程式指令碼傳送這項要求

如要傳送原始 JSON POST 要求，您可以使用 sa360Api.py 指令碼，如下所示：

1. 將 JSON 物件範例 (與兩個大括號之間的所有內容) 複製到名為 request.txt 的新文字檔。
2. 將 JSON 程式碼中的代理商 ID 變更為您自己的代理商 ID。
3. 移除任何留言，例如 // The date column segments the report by individual days.
4. 將 OAuth 2.0 憑證組合成一個以逗號分隔的字串，如下所示：
   client-ID,client-secret,refresh-token
   
   (這與執行 sa360Api.py --login 時 sa360Api.py 輸出的字串相同，如設定授權一節所述)。
5. 按照下列方式叫用 sa360Api.py：
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   在上述指令中，替換您在前一個步驟中為 CREDENTIALS 組合的字串。
   將以下方塊中的 POST 方法名稱換成 API-method。

   例如：
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt

注意：

由於 statisticsCurrency 是必填欄位，因此請在這個要求中指定 usd。在範圍限定在某個廣告客戶或以下層級的報表中，您可以要求以其他貨幣傳回報表。

報表資料的即時程度為何？

部分指標較其他指標更新。詳情請參閱 Search Ads 360 中報表資料的即時程度。

為確保報表包含所有可用的指標，建議您在午夜 (引擎帳戶時區) 過後約 4 小時，再要求取得昨天的指標報表。如果是 conversion 報表，建議您在午夜 (Campaign Manager 廣告客戶時區) 過後 12 個小時。如果您使用 API 上傳轉換資料，請參閱「insert.operation」一文，進一步瞭解已上傳資料的可用情形。

即使過了數天，指標仍可能因為引擎垃圾內容篩選器，或透過 API 上傳離線轉換而有所變動。如要逐步下載這些變更，請要求取得自上次下載後已變更資料的報表。如果您下載的是漸進式變更，建議您每隔一段時間索取一次完整報表。例如，您可以每隔幾天下載增量變更，然後每月索取一次完整報表。

屬性變更何時會在報表中顯示？

使用者在 Search Ads 360 中變更屬性後，大約需要一分鐘的時間，才會顯示在透過 API 下載的報表中。如果是直接在外部引擎 (而非透過 Search Ads 360) 所做的變更， 必須先使用傳入同步作業將變更匯入 Search Ads 360。

建議您僅傳回已變更的資料，以判斷哪些實體有屬性變更。

什麼是未歸因的廣告和關鍵字？

有時候，Search Ads 360 無法將指標歸給特定廣告。舉例來說，如果廣告採用不支援的格式，或是含有錯誤的 Clickserver 網址，Search Ads 360 就無法將指標歸因於廣告。Search Ads 360 會針對各個廣告群組，將未歸因的任何指標回報為屬於「未歸因的廣告」。如要在報表中要求這些指標，請將 includeRemovedEntities 設為 true。為輕鬆查看哪些廣告未歸因，請在要求中加入 isUnattributedAd 欄。

同樣地，Search Ads 360 有時無法將指標歸給特定關鍵字。報表出現差異時就會發生這種情況。在這種情況下，未歸因關鍵字的「keywordId」欄會設為 0。

報表是否納入按比例調整的轉換？

在某些情況下，系統無法評估轉換，例如因為瀏覽器設定等因素，導致用來儲存廣告點擊相關資訊的網站 Cookie 無法使用。在這類情況下，Floodlight 會使用調整比例來計算無法直接評估的轉換資料。換句話說，Floodlight 會將機器學習技術套用到歷來資料，針對無法評估的轉換次數和轉換收益金額建立模式。接著，Floodlight 可以將估算結果加到轉換指標中，讓您全面瞭解廣告如何促成轉換。

Floodlight 一律會將調整比例套用至下列報表欄：

• dfaActions
• dfaRevenue
• dfaTransactions
• dfaWeightedActions
• 回報 Floodlight 活動的已儲存的資料欄

conversion報表不會納入按比例調整的轉換。只會顯示直接評估的轉換。conversion 報表中的轉換次數和收益金額，應與上述資料欄中顯示的轉換次數和收益不相符。

為什麼原始轉換次數不會加總為匯總指標「X」X？

在極少數情況下，如果匯總指標與 Search Ads 360 中的原始事件不一致，請信任匯總指標。計算指標匯總時，Search Ads 360 會嘗試移除疑似重複的轉換，以清理資料來源。

如果這裡沒有解答我的問題，該怎麼辦？

如果閱讀本網站上的資源後仍無法解決問題，請與支援團隊聯絡，並提供以下資訊：

• 您嘗試存取的 Search Ads 360 代理商 ID 和廣告客戶 ID

• Google API 控制台中的專案編號

• 您用來存取 API 的 Google 帳戶使用者名稱。
  這個帳戶已獲得 Search Ads 360 的存取權限，您就是用來設定授權的帳戶。

• 要求的程式碼片段

• JSON 回應
  如果回應發生錯誤，請務必附上錯誤訊息，而不只是數字錯誤代碼。