- 資源:AdGroupAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- 商標
- AdPolicyCriterionRestriction
- LegalRemoval
- Dmca
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- 仿冒商品
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 縮圖
- VideoPerformanceAd
- DemandGenVideoAd
- CallToAction
- DemandGenImageAd
- DemandGenCarouselAd
- CarouselCard
- DemandGenProductAd
- AdUrl
- AdUrlType
- DcmTrackingInfo
- 方法
資源:AdGroupAd
與廣告群組相關聯的單一廣告。
| JSON 表示法 |
|---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object ( |
| 欄位 | |
|---|---|
name |
僅供輸出。廣告的資源名稱。 |
advertiserId |
僅供輸出。廣告所屬廣告主的專屬 ID。 |
adGroupAdId |
僅供輸出。廣告的專屬 ID。由系統指派。 |
adGroupId |
必填。不可變動。廣告所屬廣告群組的專屬 ID。 |
displayName |
必填。廣告的顯示名稱。 必須採用 UTF-8 編碼,大小上限為 255 個位元組。 |
adPolicy |
僅供輸出。廣告的政策核准狀態。 |
entityStatus |
必填。廣告的實體狀態。 |
adUrls[] |
僅供輸出。廣告使用的網址清單。 |
dcmTrackingInfo |
(選用步驟) DCM 追蹤廣告資訊。僅適用於需求開發廣告。 如要移除 DCM 追蹤廣告資訊,請將這個欄位留空。 |
聯集欄位 ad_details。廣告詳細資料。ad_details 只能是下列其中一項: |
|
displayVideoSourceAd |
僅供輸出。從 Display & Video 360 廣告素材取得的廣告詳細資料。 |
mastheadAd |
僅供輸出。在 YouTube 首頁推薦內容中放送的廣告詳細資料。 |
inStreamAd |
僅供輸出。可略過的串流內廣告詳細資料,用於提升品牌知名度或達成觸及行銷目標。 |
nonSkippableAd |
僅供輸出。不可略過的短串流內影片廣告詳細資料,長度介於 6 到 15 秒,用於觸及行銷目標。 |
bumperAd |
僅供輸出。用於觸及的不可略過的短片廣告詳細資料,長度等於或短於 6 秒。 |
audioAd |
僅供輸出。用於觸及行銷目標的音訊廣告詳細資料。 |
videoDiscoverAd |
僅供輸出。宣傳影片的廣告詳細資料,會顯示在探索位置。 |
videoPerformanceAd |
僅供輸出。影片行動廣告活動中使用的廣告詳細資料,可吸引使用者對商家、服務或產品採取行動。 |
demandGenVideoAd |
需求開發影片廣告的詳細資料。 |
demandGenImageAd |
需求開發圖像廣告的詳細資料。 |
demandGenCarouselAd |
需求開發輪轉廣告的詳細資料。 |
demandGenProductAd |
需求開發產品廣告的詳細資料。 |
AdPolicy
與廣告群組廣告相關聯的單一廣告政策。
| JSON 表示法 |
|---|
{ "adPolicyApprovalStatus": enum ( |
| 欄位 | |
|---|---|
adPolicyApprovalStatus |
廣告的政策核准狀態,指出核准裁決。 |
adPolicyReviewStatus |
廣告的政策審查狀態,指出廣告目前處於審查程序的哪個階段。 |
adPolicyTopicEntry[] |
系統會針對與廣告相關的每個政策主題,每個項目都會列出主題、限制等級,以及如何修正政策問題的指引。 |
AdPolicyApprovalStatus
廣告政策核准的可能狀態。
| 列舉 | |
|---|---|
AD_POLICY_APPROVAL_STATUS_UNKNOWN |
不明或未指定。 |
DISAPPROVED |
不會放送。 |
APPROVED_LIMITED |
會放送廣告,但設有限制。 |
APPROVED |
放送時不受限制。 |
AREA_OF_INTEREST_ONLY |
不會在指定國家/地區放送,但可能會向搜尋指定國家/地區相關資訊的使用者放送。 |
AdPolicyReviewStatus
廣告政策審查的可能狀態。
| 列舉 | |
|---|---|
AD_POLICY_REVIEW_STATUS_UNKNOWN |
不明或未指定。 |
REVIEW_IN_PROGRESS |
目前正在審核中。 |
REVIEWED |
主要審查已完成。其他審查作業可能仍在進行中。 |
UNDER_APPEAL |
重新提交審核或已對政策裁決提出申訴。 |
ELIGIBLE_MAY_SERVE |
系統判定符合資格,且可能正在放送。我們仍可能進行後續審查。 |
AdPolicyTopicEntry
說明廣告如何被判定與廣告政策相關的項目。
| JSON 表示法 |
|---|
{ "policyTopic": string, "policyLabel": string, "policyTopicDescription": string, "policyTopicType": enum ( |
| 欄位 | |
|---|---|
policyTopic |
政策主題。 例如「TRADEMARKS」、「ALCOHOL」等。 |
policyLabel |
政策的本地化標籤文字。 例如「文字中的商標」和「含有酒精」等。 |
policyTopicDescription |
政策主題的簡短摘要說明。 |
policyTopicType |
廣告放送會因與廣告政策主題相關而受到哪些影響。 |
policyDecisionType |
政策裁決的來源。 |
policyEnforcementMeans |
政策審查時採用的政策執行方式。 |
policyTopicEvidences[] |
政策裁決所依據的證據。 |
policyTopicConstraints[] |
與政策裁決相關的放送限制。 |
helpCenterLink |
政策主題的廣告政策說明中心連結。 |
appealInfo |
如何對政策裁決提出申訴。 |
AdPolicyTopicEntryType
廣告政策主題可能對放送造成的影響。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN |
不明或未指定。 |
PROHIBITED |
資源不會放送。 |
FULLY_LIMITED |
資源不會在所有指定國家/地區放送。 |
LIMITED |
資源無法在部分國家/地區放送。 |
DESCRIPTIVE |
資源可提供服務。 |
BROADENING |
資源可以放送,且放送範圍可能超出正常涵蓋範圍。 |
AREA_OF_INTEREST_ONLY |
這項資源會受到所有指定國家/地區的限制,但如果使用者搜尋指定國家/地區的相關資訊,系統仍可能會顯示這項資源。 |
AdPolicyDecisionType
政策裁決的可能來源。
| 列舉 | |
|---|---|
AD_POLICY_DECISION_TYPE_UNKNOWN |
不明或未指定。 |
PURSUANT_TO_NOTICE |
這項決定是根據法律聲明、法院命令或商標內容擁有者申訴等做出。 |
GOOGLE_INVESTIGATION |
這項決定是 Google 自行調查後做出。 |
AdPolicyEnforcementMeans
政策審查中可能採用的政策執行方式。
| 列舉 | |
|---|---|
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN |
不明或未指定。 |
AUTOMATED |
違規處置程序完全自動化。 |
HUMAN_REVIEW |
人工部分或完全參與了違規處置程序。 |
AdPolicyTopicEvidence
用於政策裁決的證據資訊。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位 value。政策裁決的證據。value 只能是下列其中一項: |
|
textList |
廣告文字中發現的證據清單。 |
websiteList |
與廣告連結的網站清單。 |
httpCode |
檢索最終到達網址時傳回的 HTTP 程式碼。 |
languageCode |
系統偵測到廣告使用的語言。 這個欄位使用 IETF 語言代碼,例如「en-US」。 |
destinationTextList |
廣告到達網頁中導致違反政策的文字。 |
destinationMismatch |
廣告到達網頁網址不符。 |
destinationNotWorking |
與廣告到達網頁相關的 HTTP 或 DNS 錯誤資訊。 |
trademark |
導致違反政策的商標字詞。 |
legalRemoval |
因法律相關法規強制執行而違反政策。 |
counterfeit |
因仿冒商品處置措施而違反政策。 |
regionalRequirements |
T&S 主動執行的違規處置,導致違反政策。 |
TextList
違反政策的文字片段清單。
| JSON 表示法 |
|---|
{ "texts": [ string ] } |
| 欄位 | |
|---|---|
texts[] |
導致政策發現結果的資源文字片段。 |
WebsiteList
違反政策的網站清單。
| JSON 表示法 |
|---|
{ "websites": [ string ] } |
| 欄位 | |
|---|---|
websites[] |
導致政策發現項目的網站。 |
DestinationTextList
違反政策的目的地文字清單。
| JSON 表示法 |
|---|
{ "destinationTexts": [ string ] } |
| 欄位 | |
|---|---|
destinationTexts[] |
導致政策發現結果的目的地文字。 |
DestinationMismatch
到達網頁網址類型不符的詳細資料。
| JSON 表示法 |
|---|
{
"uriTypes": [
enum ( |
| 欄位 | |
|---|---|
uriTypes[] |
不相符的網址集。清單可包含單一或多個 URI 類型。 示例 1:[ 範例 2:[ |
AdPolicyTopicEvidenceDestinationMismatchUrlType
可能的網址類型。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN |
未指定或不明。 |
DISPLAY_URL |
顯示網址。 |
FINAL_URL |
最終到達網址。 |
FINAL_MOBILE_URL |
最終行動版網址。 |
TRACKING_URL |
追蹤網址。 |
MOBILE_TRACKING_URL |
行動追蹤網址。 |
DestinationNotWorking
與廣告到達網頁相關的 HTTP 或 DNS 錯誤詳細資料。
| JSON 表示法 |
|---|
{ "expandedUri": string, "device": enum ( |
| 欄位 | |
|---|---|
expandedUri |
無法運作的完整網址。 |
device |
造訪網址時發生錯誤的裝置。 |
lastCheckedTime |
上次瀏覽網址時發生錯誤的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
聯集欄位 reason。HTTP 或 DNS 錯誤。reason 只能是下列其中一項: |
|
dnsErrorType |
DNS 錯誤類型。 |
httpErrorCode |
HTTP 錯誤代碼。 |
AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
可能的 DNS 錯誤類型。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN |
未指定或不明。 |
HOSTNAME_NOT_FOUND |
擷取到達網頁時,系統在 DNS 中找不到主機名稱。 |
GOOGLE_CRAWLER_DNS_ISSUE |
與 DNS 通訊時,Google 無法檢索到達網頁。 |
AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
可能在造訪網址時發生錯誤的裝置。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN |
未指定或不明。 |
DESKTOP |
電腦裝置。 |
ANDROID |
Android 裝置。 |
IOS |
iOS 裝置。 |
商標
導致違反政策的商標字詞。
| JSON 表示法 |
|---|
{
"owner": string,
"term": string,
"countryRestrictions": [
{
object ( |
| 欄位 | |
|---|---|
owner |
商標內容擁有者。 |
term |
商標字詞。 |
countryRestrictions[] |
違反政策行為的相關國家/地區。 |
AdPolicyCriterionRestriction
代表國家/地區限制。
| JSON 表示法 |
|---|
{ "countryCriterionId": string, "countryLabel": string } |
| 欄位 | |
|---|---|
countryCriterionId |
國家/地區條件 ID。 |
countryLabel |
國家/地區的本地化名稱。可以留空。 |
LegalRemoval
執行與法律相關的法規,包括《數位千禧年著作權法》(DMCA) 或當地法律法規。
| JSON 表示法 |
|---|
{ "complaintType": enum ( |
| 欄位 | |
|---|---|
complaintType |
導致依法移除內容的申訴類型。 |
countryRestrictions[] |
因法律移除而受到限制的國家/地區。 |
restrictedUris[] |
因法律移除而受到限制的網址。 |
聯集欄位 type。依法移除的類型詳細資料。type 只能是下列其中一項: |
|
dmca |
詳細瞭解依據《數位千禧年著作權法》(DMCA) 規定移除內容的法律程序。 |
localLegal |
當地法律法規的依法移除詳細資料。 |
數位千禧年著作權法 (DMCA)
數位千禧年著作權法申訴詳細資料。
| JSON 表示法 |
|---|
{ "complainant": string } |
| 欄位 | |
|---|---|
complainant |
提出法律申訴的實體。 |
LocalLegal
當地法律規範詳情。
| JSON 表示法 |
|---|
{ "lawType": string } |
| 欄位 | |
|---|---|
lawType |
法律聲明的法律類型。 |
AdPolicyTopicEvidenceLegalRemovalComplaintType
可提出依法移除要求的申訴類型。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN |
未指定或不明。 |
COPYRIGHT |
版權。 僅適用於《數位千禧年著作權法》。 |
COURT_ORDER |
法院命令。 僅適用於當地法律。 |
LOCAL_LEGAL |
當地法律規定。 僅適用於當地法律。 |
仿冒商品
因仿冒商品強制執行措施而違反政策的詳細資料。
| JSON 表示法 |
|---|
{ "owners": [ string ] } |
| 欄位 | |
|---|---|
owners[] |
提出申訴的內容或產品擁有者。 |
RegionalRequirements
信任與安全 (T&S) 團隊會主動執行政策,以因應區域性要求。這是 Google 主動執行的 T&S 執法行動,因此視為 Google 擁有的調查,而非法規通知。
| JSON 表示法 |
|---|
{
"regionalRequirementsEntries": [
{
object ( |
| 欄位 | |
|---|---|
regionalRequirementsEntries[] |
區域規定清單。 |
RegionalRequirementsEntry
政策層級的區域法律違規詳情。
| JSON 表示法 |
|---|
{
"legalPolicy": string,
"countryRestrictions": [
{
object ( |
| 欄位 | |
|---|---|
legalPolicy |
違反的法律政策。 |
countryRestrictions[] |
因法律政策而受到限制的國家/地區。 |
AdPolicyTopicConstraint
廣告放送限制的詳細資料。
| JSON 表示法 |
|---|
{ "requestCertificateFormLink": string, // Union field |
| 欄位 | |
|---|---|
requestCertificateFormLink |
連結至要求限制憑證的表單。 |
聯集欄位 constraint。放送限制。constraint 只能是下列其中一項: |
|
countryConstraint |
廣告無法放送的國家/地區。 |
resellerConstraint |
經銷商限制。 |
certificateMissingCountryList |
提供服務時必須出示認證的國家/地區。 |
certificateDomainMismatchCountryList |
資源網域未涵蓋在相關聯憑證中的國家/地區。 |
globalCertificateMissing |
如要在任何國家/地區放送,都必須提供認證。 |
globalCertificateDomainMismatch |
廣告必須具備憑證才能在任何國家/地區放送,但現有憑證未涵蓋廣告網域。 |
AdPolicyCountryConstraintList
因政策限制而無法放送廣告的國家/地區清單。
| JSON 表示法 |
|---|
{
"countries": [
{
object ( |
| 欄位 | |
|---|---|
countries[] |
廣告無法放送的國家/地區。 |
AdPolicyResellerConstraint
這個類型沒有任何欄位。
由於網站因轉售目的而遭到拒登,因此政策主題受到限制。
AdPolicyGlobalCertificateMissingConstraint
這個類型沒有任何欄位。
如要在任何國家/地區放送,都必須提供認證。
AdPolicyGlobalCertificateDomainMismatchConstraint
這個類型沒有任何欄位。
廣告必須具備憑證才能在任何國家/地區放送,但現有憑證未涵蓋廣告網域。
AdPolicyTopicAppealInfo
如何對政策裁決提出申訴。
| JSON 表示法 |
|---|
{
"appealType": enum ( |
| 欄位 | |
|---|---|
appealType |
是否可透過自助式申訴或申訴表單提出申訴。 |
appealFormLink |
只有在 |
AdPolicyAppealType
可申訴的類型。
| 列舉 | |
|---|---|
AD_POLICY_APPEAL_TYPE_UNKNOWN |
不明或未指定。 |
SELF_SERVICE_APPEAL |
你可以透過自助式申訴對這項裁決提出申訴。 |
APPEAL_FORM |
如要對這項決定提出申訴,請填寫申訴表單。 |
DisplayVideoSourceAd
廣告素材來自 DV360 廣告素材。
| JSON 表示法 |
|---|
{ "creativeId": string } |
| 欄位 | |
|---|---|
creativeId |
來源廣告素材的 ID。 |
MastheadAd
刊頭廣告的詳細資料。
| JSON 表示法 |
|---|
{ "video": { object ( |
| 欄位 | |
|---|---|
video |
廣告使用的 YouTube 影片。 |
headline |
廣告標題。 |
description |
廣告說明。 |
videoAspectRatio |
刊頭廣告中自動播放的 YouTube 影片長寬比。 |
autoplayVideoStartMillisecond |
影片開始播放的時間 (以毫秒為單位)。 |
autoplayVideoDuration |
影片自動播放的時間長度。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
callToActionButtonLabel |
行動號召按鈕上的文字。 |
callToActionFinalUrl |
行動號召按鈕的到達網頁網址。 |
callToActionTrackingUrl |
行動號召按鈕的追蹤網址。 |
showChannelArt |
是否顯示 YouTube 頁面頂端的背景或橫幅圖片。 |
companionYoutubeVideos[] |
顯示在電腦版刊頭廣告旁邊的影片。最多只能有兩個。 |
YoutubeVideoDetails
YouTube 影片的詳細資料。
| JSON 表示法 |
|---|
{
"id": string,
"unavailableReason": enum ( |
| 欄位 | |
|---|---|
id |
僅供輸出。YouTube 影片 ID,可在 YouTube 網頁上搜尋。 |
unavailableReason |
影片資料無法使用的原因。 |
videoAssetId |
|
VideoAspectRatio
YouTube 影片的可能顯示比例。
| 列舉 | |
|---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
未指定或不明。 |
VIDEO_ASPECT_RATIO_WIDESCREEN |
影片遭到拉伸,頂端和底部遭到裁切。 |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
影片使用固定的 16:9 顯示比例。 |
InStreamAd
串流內廣告的詳細資料。
| JSON 表示法 |
|---|
{
"commonInStreamAttribute": {
object ( |
| 欄位 | |
|---|---|
commonInStreamAttribute |
常見廣告屬性。 |
customParameters |
要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
CommonInStreamAttribute
串流內廣告、不可略過廣告和串場廣告的常見屬性。
| JSON 表示法 |
|---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
| 欄位 | |
|---|---|
displayUrl |
與廣告一起顯示的網頁網址。 |
finalUrl |
使用者點按廣告後到達的網頁網址。 |
trackingUrl |
系統會在背景載入這個網址,以利追蹤。 |
actionButtonLabel |
行動號召按鈕上的文字。 |
actionHeadline |
行動號召橫幅的標題。 |
video |
廣告的 YouTube 影片。 |
companionBanner |
顯示在影片廣告旁的圖片。 |
ImageAsset
圖片素材資源的中繼資料。
| JSON 表示法 |
|---|
{
"mimeType": string,
"fullSize": {
object ( |
| 欄位 | |
|---|---|
mimeType |
僅供輸出。圖片素材資源的 MIME 類型。 |
fullSize |
僅供輸出。這張圖片原始大小的中繼資料。 |
fileSize |
僅供輸出。圖片素材資源的檔案大小 (以位元組為單位)。 |
assetId |
必填。資產的專屬 ID。 |
NonSkippableAd
不可略過廣告的詳細資料。
| JSON 表示法 |
|---|
{
"commonInStreamAttribute": {
object ( |
| 欄位 | |
|---|---|
commonInStreamAttribute |
常見廣告屬性。 |
customParameters |
要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
BumperAd
串場廣告的詳細資料。
| JSON 表示法 |
|---|
{
"commonInStreamAttribute": {
object ( |
| 欄位 | |
|---|---|
commonInStreamAttribute |
常見廣告屬性。 |
AudioAd
音訊廣告的詳細資料。
| JSON 表示法 |
|---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
| 欄位 | |
|---|---|
displayUrl |
與廣告一起顯示的網頁網址。 |
finalUrl |
使用者點按廣告後到達的網頁網址。 |
trackingUrl |
系統會在背景載入這個網址,以利追蹤。 |
video |
廣告的 YouTube 影片。 |
VideoDiscoveryAd
影片探索廣告的詳細資料。
| JSON 表示法 |
|---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
| 欄位 | |
|---|---|
headline |
廣告標題。 |
description1 |
廣告的第一行文字。 |
description2 |
廣告的第二行文字。 |
video |
廣告宣傳的 YouTube 影片。 |
thumbnail |
廣告中使用的縮圖。 |
縮圖
影片探索廣告中可能的縮圖選項。
| 列舉 | |
|---|---|
THUMBNAIL_UNSPECIFIED |
不明或未指定。 |
THUMBNAIL_DEFAULT |
預設縮圖可由系統自動產生,或由使用者上傳。 |
THUMBNAIL_1 |
縮圖 1:從影片生成。 |
THUMBNAIL_2 |
系統根據影片生成的縮圖 2。 |
THUMBNAIL_3 |
縮圖 3,從影片生成。 |
VideoPerformanceAd
影片成效廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
| 欄位 | |
|---|---|
finalUrl |
使用者點按廣告後到達的網頁網址。 |
trackingUrl |
系統會在背景載入這個網址,以利追蹤。 |
actionButtonLabels[] |
行動號召按鈕上顯示的文字素材資源清單。 |
headlines[] |
行動號召橫幅上顯示的廣告標題清單。 |
longHeadlines[] |
行動號召橫幅上顯示的長廣告標題清單。 |
descriptions[] |
行動號召橫幅上顯示的說明清單。 |
displayUrlBreadcrumb1 |
顯示網址中網域後的第一個部分。 |
displayUrlBreadcrumb2 |
顯示網址中網域之後的第二個部分。 |
domain |
顯示網址的網域。 |
videos[] |
這則廣告使用的 YouTube 影片素材資源清單。 |
customParameters |
要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
companionBanners[] |
這個廣告使用的隨播橫幅清單。 |
DemandGenVideoAd
需求開發影片廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": enum ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後到達的網頁網址。 |
trackingUrl |
僅供輸出。系統會在背景載入這個網址,以利追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
callToAction |
必填。廣告中顯示的行動號召按鈕。 支援的值如下:
|
headlines[] |
必填。廣告中顯示的標題清單。 |
longHeadlines[] |
必填。廣告上顯示的長廣告標題清單。 |
descriptions[] |
必填。廣告中顯示的說明清單。 |
displayUrlBreadcrumb1 |
(選用步驟) 顯示網址中網域後的第一個部分。 |
displayUrlBreadcrumb2 |
(選用步驟) 顯示網址中網域之後的第二個部分。 |
videos[] |
必填。這則廣告使用的 YouTube 影片素材資源清單。 |
customParameters |
(選用步驟) 要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
companionBanner |
(選用步驟) 這個廣告使用的隨播橫幅廣告。 |
logo |
必填。這則廣告使用的標誌圖片。 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點選廣告後抵達的網頁網址。 |
finalUrlSuffix |
(選用步驟) 要附加至到達網頁網址的尾碼。 |
businessName |
必填。廣告中顯示的商家名稱。 |
CallToAction
需求開發產品/影片廣告可用的行動號召值。
| 列舉 | |
|---|---|
CALL_TO_ACTION_UNSPECIFIED |
未指定或不明。 |
AUTOMATED |
由系統自動撥打。 |
LEARN_MORE |
瞭解詳情。 |
GET_QUOTE |
取得報價。 |
APPLY_NOW |
立即申請。 |
SIGN_UP |
註冊。 |
CONTACT_US |
與我們聯絡。 |
SUBSCRIBE |
訂閱 |
DOWNLOAD |
。 |
BOOK_NOW |
立即預訂。 |
SHOP_NOW |
立即購買。 |
BUY_NOW |
立即購買。 |
DONATE_NOW |
立即捐款。 |
ORDER_NOW |
立即訂購。 |
PLAY_NOW |
立即播放。 |
SEE_MORE |
查看詳情。 |
START_NOW |
。 |
VISIT_SITE |
造訪網站。 |
WATCH_NOW |
立即觀看。 |
DemandGenImageAd
需求開發圖像廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": string, "headlines": [ string ], "descriptions": [ string ], "customParameters": { string: string, ... }, "finalMobileUrl": string, "finalUrlSuffix": string, "businessName": string, "marketingImages": [ { object ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後到達的網頁網址。 |
trackingUrl |
僅供輸出。系統會在背景載入這個網址,以利追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
callToAction |
必填。廣告中顯示的行動號召按鈕。 |
headlines[] |
必填。廣告中顯示的標題清單。 |
descriptions[] |
必填。廣告中顯示的說明清單。 |
customParameters |
(選用步驟) 要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點選廣告後抵達的網頁網址。 |
finalUrlSuffix |
(選用步驟) 要附加至到達網頁網址的尾碼。 |
businessName |
必填。廣告中顯示的商家名稱。 |
marketingImages[] |
廣告中顯示的行銷圖片清單。 |
squareMarketingImages[] |
廣告中顯示的正方形行銷圖片清單。 |
portraitMarketingImages[] |
廣告中顯示的直向行銷圖片清單。 |
logoImages[] |
廣告中顯示的標誌圖片清單。 |
DemandGenCarouselAd
需求開發輪轉廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "headline": string, "description": string, "cards": [ { object ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後到達的網頁網址。 |
headline |
必填。廣告標題。 |
description |
必填。廣告說明。 |
cards[] |
必填。廣告中顯示的資訊卡清單。 |
finalUrlSuffix |
(選用步驟) 要附加至到達網頁網址的尾碼。 |
trackingUrl |
僅供輸出。系統會在背景載入這個網址,以利追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
businessName |
必填。廣告中顯示的商家名稱。 |
customParameters |
(選用步驟) 要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
logo |
必填。這則廣告使用的標誌圖片。 |
CarouselCard
需求開發廣告輪轉介面資訊卡的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "finalMobileUrl": string, "headline": string, "callToAction": string, "marketingImage": { object ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點選資訊卡後前往的網頁網址。 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點選資訊卡後,所前往網頁的網址。 |
headline |
必填。資訊卡標題。 |
callToAction |
必填。資訊卡上顯示的行動號召按鈕文字。 不得超過 10 個字元。 |
marketingImage |
(選用步驟) 資訊卡上顯示的行銷圖片。 |
squareMarketingImage |
(選用步驟) 資訊卡上顯示的正方形行銷圖片。 |
portraitMarketingImage |
(選用步驟) 資訊卡上顯示的直向行銷圖片。 |
DemandGenProductAd
需求開發產品廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "headline": string, "description": string, "finalUrlSuffix": string, "callToAction": enum ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後到達的網頁網址。 |
headline |
必填。廣告標題。 |
description |
必填。廣告說明。 |
finalUrlSuffix |
(選用步驟) 要附加至到達網頁網址的尾碼。 |
callToAction |
必填。廣告中顯示的行動號召按鈕。 支援的值如下:
|
trackingUrl |
僅供輸出。系統會在背景載入這個網址,以利追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
businessName |
必填。廣告中顯示的商家名稱。 |
customParameters |
(選用步驟) 要加入追蹤網址的自訂參數和相應值。 這個物件中包含 |
logo |
必填。這則廣告使用的標誌圖片。 |
displayUrlBreadcrumb1 |
(選用步驟) 顯示網址中網域後的第一個部分。 |
displayUrlBreadcrumb2 |
(選用步驟) 顯示網址中網域之後的第二個部分。 |
AdUrl
與廣告相關的其他網址,包括信號。
| JSON 表示法 |
|---|
{
"type": enum ( |
| 欄位 | |
|---|---|
type |
廣告網址類型。 |
url |
網址字串值。 |
AdUrlType
可能的廣告網址類型。
| 列舉 | |
|---|---|
AD_URL_TYPE_UNSPECIFIED |
不明或未指定。 |
AD_URL_TYPE_BEACON_IMPRESSION |
廣告素材曝光時,系統會 Ping 1x1 追蹤像素。 |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
可展開式 DCM 曝光信標。在放送時,這項廣告會展開為多個信標。 |
AD_URL_TYPE_BEACON_CLICK |
點擊事件觸發時要 Ping 的追蹤網址。 |
AD_URL_TYPE_BEACON_SKIP |
略過事件觸發時要 Ping 的追蹤網址。 |
DcmTrackingInfo
DCM 追蹤的詳細資料。
| JSON 表示法 |
|---|
{ "placementId": string, "trackingAdId": string, "creativeId": string } |
| 欄位 | |
|---|---|
placementId |
必填。DCM 刊登位置 ID。 |
trackingAdId |
必填。DCM 追蹤廣告 ID。 |
creativeId |
必填。DCM 廣告素材 ID。 |
方法 |
|
|---|---|
|
建立廣告群組廣告。 |
|
刪除廣告群組廣告。 |
|
取得廣告群組廣告。 |
|
列出廣告群組廣告。 |
|
更新廣告群組廣告。 |