檢舉常見問題

新版 Search Ads 360 Reporting API 現已上線。新版 API 提供 更有彈性，可用來建立自訂報表，以及將資料整合至報表應用程式 和處理程序進一步瞭解如何遷移至及使用新版 Search Ads 360 報表 API。

我的報表範圍應該是甚麼？

我們建議為大多數的報表 Reports.reportScope敬上 附加至特定引擎帳戶或廣告客戶超大型適用 例如關鍵字報表、轉換報表 區隔報表，建議您將範圍限制在 特定引擎帳戶如果報表大於 1,000 萬列。

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

您需要 取得更新 OAuth 權杖。

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

如果您還沒有已取得的代理商和廣告主 ID 可以查看、要求 advertiser敬上 包含「agencyId」和「advertiserId」欄的報表 但不要指定 reportScope。 Search Ads 360 會傳回一份清單，其中包含所有代理商和廣告主 ID Google 帳戶有檢視權限。

以下是要求範例：

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.pysa360Api.py --login 授權)。
5. 叫用 sa360Api.py，如下所示：
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   在上述指令中，將 CREDENTIALS 替換成您在先前步驟中組合的字串。
   請將 API-method 的方塊替換成下方方塊中的 POST 方法名稱。

   例如：
   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。其他報表範圍限定為 廣告客戶或下層廣告客戶，您可以請求 以其他貨幣傳回報表。

報表資料的即時程度

有些指標的資料會更新。詳情請參閱報表資料的即時程度 的功能？

為確保報表包含所有可用的指標，建議您等候約 4 小時 (引擎帳戶時區) 過後一小時過後，再要求系統提供昨天的報表 metrics;建議等待conversion報表 午夜 12 小時 (Campaign Manager 廣告主時區)。如果您使用 API 上傳轉換資料，請參閱 insert.operation ，進一步瞭解上傳資料的供應情形。

即使經過幾天後，指標仍可能因為引擎垃圾內容篩選器或離線狀態而改變 透過 API 上傳轉換資料如要逐步下載 變更、要求報表 針對自上次下載後發生變化的資料如果您下載的是 變更期間，建議您每隔一段時間就要求取得完整報表。例如： 建議每隔幾天下載一次增量變更，然後索取完整報表一次 一個月。

屬性異動何時會顯示在報表中？

使用者在 Search Ads 360 中進行的屬性變更大約需要 1 分鐘的時間，才會顯示在 Google Search Ads 360 中 透過 API 下載的報表直接在外部引擎上所做的變更 (非 您必須先使用傳入同步作業，將這項功能匯入 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？

在極少數情況下，如果匯總指標與 Search Ads 360 中的原始事件有異議，請信任 匯總指標計算指標匯總時，Search Ads 360 會嘗試清理資料 找出可能重複的轉換，藉此排除這些來源。

如果這裡沒有解答，該怎麼辦？

如果閱讀本網站上的資源後發現問題無法解決， 與支援團隊聯絡，並 下列資訊都準備好了：

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

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

• 您用來存取 API 的 Google 帳戶使用者名稱。
  這是指已授予的帳戶 存取 Search Ads 360 的權限 (也就是您用來存取 Search Ads 360 的帳戶) 請設定授權。

• 要求的程式碼片段

• JSON 回應
  如果回應有誤，請務必附上錯誤訊息，而不只是 以數字組成的錯誤代碼