SearchAds360Row

クエリから返された行。

JSON 表現
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
フィールド
adGroup

object (AdGroup)

クエリで参照されている広告グループ。

adGroupAd

object (AdGroupAd)

クエリで参照されている広告。

adGroupAdLabel

object (AdGroupAdLabel)

クエリで参照される広告グループの広告ラベル。

adGroupAsset

object (AdGroupAsset)

クエリで参照される広告グループのアセット。

adGroupAssetSet

object (AdGroupAssetSet)

クエリで参照されている広告グループのアセットセット。

adGroupAudienceView

object (AdGroupAudienceView)

クエリで参照されている広告グループのオーディエンス ビュー。

adGroupBidModifier

object (AdGroupBidModifier)

クエリで参照されている入札単価調整比。

adGroupCriterion

object (AdGroupCriterion)

クエリで参照されている条件。

adGroupCriterionLabel

object (AdGroupCriterionLabel)

クエリで参照される広告グループの条件ラベル。

adGroupLabel

object (AdGroupLabel)

クエリで参照される広告グループのラベル。

ageRangeView

object (AgeRangeView)

クエリで参照される年齢層ビュー。

asset

object (Asset)

クエリで参照されるアセット。

assetGroupAsset

object (AssetGroupAsset)

クエリで参照されるアセット グループのアセット。

assetGroupSignal

object (AssetGroupSignal)

クエリで参照されるアセット グループのシグナル。

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

クエリで参照されるアセット グループのリスティング グループのフィルタ。

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

クエリで参照されているアセット グループの上位の組み合わせのビュー。

assetGroup

object (AssetGroup)

クエリで参照されるアセット グループ。

assetSetAsset

object (AssetSetAsset)

クエリで参照されるアセットセットのアセット。

assetSet

object (AssetSet)

クエリで参照されるアセットセット。

biddingStrategy

object (BiddingStrategy)

クエリで参照されている入札戦略。

campaignBudget

object (CampaignBudget)

クエリで参照されるキャンペーン予算。

campaign

object (Campaign)

クエリで参照されているキャンペーン。

campaignAsset

object (CampaignAsset)

クエリで参照されるキャンペーン アセット。

campaignAssetSet

object (CampaignAssetSet)

クエリで参照されているキャンペーンのアセットセット。

campaignAudienceView

object (CampaignAudienceView)

クエリで参照されているキャンペーンのオーディエンス ビュー。

campaignCriterion

object (CampaignCriterion)

クエリで参照されているキャンペーンの条件。

campaignLabel

object (CampaignLabel)

クエリで参照されるキャンペーン ラベル。

cartDataSalesView

object (CartDataSalesView)

クエリで参照されるカートデータのセールスビュー。

audience

object (Audience)

クエリで参照されているオーディエンス。

conversionAction

object (ConversionAction)

クエリで参照されるコンバージョン アクション。

conversionCustomVariable

object (ConversionCustomVariable)

クエリで参照されるコンバージョン カスタム変数。

customer

object (Customer)

クエリで参照されている顧客。

customerAsset

object (CustomerAsset)

クエリで参照される顧客アセット。

customerAssetSet

object (CustomerAssetSet)

クエリで参照される顧客アセットセット。

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

クエリで参照されているアクセス可能な入札戦略。

customerClient

object (CustomerClient)

クエリで参照される CustomerClient。

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

クエリで参照されている動的検索広告の検索語句ビュー。

genderView

object (GenderView)

クエリで参照される性別ビュー。

geoTargetConstant

object (GeoTargetConstant)

クエリで参照されている地域ターゲティングの定数。

keywordView

object (KeywordView)

クエリで参照されているキーワード ビュー。

label

object (Label)

クエリで参照されるラベル。

languageConstant

object (LanguageConstant)

クエリで参照される言語定数。

locationView

object (LocationView)

クエリで参照されるロケーション ビュー。

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

クエリで参照されている商品の入札カテゴリ。

productGroupView

object (ProductGroupView)

クエリで参照される商品グループのビュー。

shoppingPerformanceView

object (ShoppingPerformanceView)

クエリで参照されるショッピングのパフォーマンス ビュー。

userList

object (UserList)

クエリで参照されるユーザーリスト。

webpageView

object (WebpageView)

クエリで参照されるウェブページ ビュー。

visit

object (Visit)

クエリで参照されるイベントレベルの訪問。

conversion

object (Conversion)

クエリで参照されるイベント単位のコンバージョン。

metrics

object (Metrics)

指標。

segments

object (Segments)

セグメント。

customColumns[]

object (Value)

カスタム列。

AdGroup

広告グループ。

JSON 表現
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
フィールド
resourceName

string

広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

広告グループのステータス。

type

enum (AdGroupType)

広告グループのタイプ。

adRotationMode

enum (AdGroupAdRotationMode)

広告グループの広告のローテーション モード。

creationTime

string

この広告グループが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

targetingSetting

object (TargetingSetting)

ターゲティング関連機能の設定。

labels[]

string

この広告グループに適用されているラベルのリソース名。

engineId

string

外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウント(Yahoo、Microsoft、Baidu など)専用です。Google 広告エンティティの場合は、代わりに「adGroup.id」を使用します。

startDate

string

この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14

endDate

string

広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14

languageCode

string

広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

id

string (int64 format)

広告グループの ID。

name

string

広告グループの名前です。

新しい広告グループを作成する場合は、このフィールドは必須です。空にすることはできません。

含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。

null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。

cpcBidMicros

string (int64 format)

最大 CPC(クリック単価)入札。

engineStatus

enum (AdGroupEngineStatus)

広告グループのエンジン ステータス。

AdGroupStatus

広告グループのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED 広告グループは有効です。
PAUSED 広告グループは一時停止されています。
REMOVED 広告グループが削除されている。

AdGroupType

広告グループのタイプを列挙する列挙型。

列挙型
UNSPECIFIED タイプが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

SEARCH_STANDARD 検索キャンペーンのデフォルトの広告グループタイプです。
DISPLAY_STANDARD ディスプレイ キャンペーンのデフォルトの広告グループタイプです。
SHOPPING_PRODUCT_ADS 標準の商品広告を配信するショッピング キャンペーンの広告グループタイプです。
SHOPPING_SHOWCASE_ADS ショッピングの検索結果に表示されるショーケース広告または販売者広告の配信に限定されている広告グループのタイプです。
HOTEL_ADS ホテル キャンペーンのデフォルトの広告グループタイプです。
SHOPPING_SMART_ADS スマート ショッピング キャンペーンの広告グループのタイプ。
VIDEO_BUMPER スキップ不可の短いインストリーム動画広告です。
VIDEO_TRUE_VIEW_IN_STREAM TrueView(スキップ可能)インストリーム動画広告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView インディスプレイ動画広告
VIDEO_NON_SKIPPABLE_IN_STREAM スキップ不可のインストリーム動画広告です。
VIDEO_OUTSTREAM アウトストリーム動画広告。
SEARCH_DYNAMIC_ADS 動的検索広告の広告グループの広告グループのタイプです。
SHOPPING_COMPARISON_LISTING_ADS ショッピング比較キャンペーンの広告グループのタイプ。
PROMOTED_HOTEL_ADS プロモート ホテルの広告グループの広告グループタイプ。
VIDEO_RESPONSIVE 動画レスポンシブ広告グループ
VIDEO_EFFICIENT_REACH 動画による効率的なリーチの広告グループ
SMART_CAMPAIGN_ADS スマート アシスト キャンペーンの広告グループの種類です。
TRAVEL_ADS 旅行キャンペーンの広告グループの種類です。

AdGroupAdRotationMode

広告グループの広告ローテーション モードです。

列挙型
UNSPECIFIED 広告のローテーション モードが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

OPTIMIZE クリック数またはコンバージョン数に基づいて広告グループの広告を最適化する。
ROTATE_FOREVER 均等にローテーションします。

AdGroupEngineStatus

広告グループ エンジンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_ELIGIBLE

非推奨です。使用しないでください。

AD_GROUP_EXPIRED 終了日を過ぎているため、この広告グループでは広告が掲載されていません。
AD_GROUP_REMOVED 広告グループは削除されています。
AD_GROUP_DRAFT この広告グループは下書きのままであるため、この広告グループでは広告が掲載されていません。
AD_GROUP_PAUSED 広告グループは一時停止されています。
AD_GROUP_SERVING 広告グループは有効で、現在広告が配信されている。
AD_GROUP_SUBMITTED 広告グループが送信されました(Microsoft Bing Ads の以前のステータス)。
CAMPAIGN_PAUSED キャンペーンが一時停止されているため、この広告グループでは広告が掲載されていません。
ACCOUNT_PAUSED アカウントが一時停止されているため、この広告グループでは広告が掲載されていません。

TargetingSetting

ターゲティング関連機能の設定(キャンペーン単位、広告グループ単位)。ターゲット設定について詳しくは、https://support.google.com/google-ads/answer/7365594 をご覧ください。

JSON 表現
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
フィールド
targetRestrictions[]

object (TargetRestriction)

ターゲティング ディメンションごとに、キャンペーンまたは広告グループのリーチを制限する設定。

TargetRestriction

ターゲティング ディメンションごとのターゲット設定のリスト。

JSON 表現
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
フィールド
targetingDimension

enum (TargetingDimension)

これらの設定が適用されるターゲティング ディメンション。

bidOnly

boolean

この targetDimension で選択した条件でのみ広告を表示するか、このターゲティングディメンションのすべての値をターゲティングして、他の TargetDimensions のターゲティングに基づいて広告を表示するかを指定します。値が true の場合、入札単価調整比のみが適用され、ターゲティングには影響しません。値を false にすると、その条件によってターゲティングと入札単価調整比の適用が制限されます。

TargetingDimension

ターゲティング可能なディメンションを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
KEYWORD キーワード条件(「mars cruise」など)。カスタム入札単価ディメンションとして「キーワード」を使用できる。キーワードは常にターゲティング ディメンションであるため、TargetRestriction でターゲットの「すべて」ディメンションとして設定することはできません。
AUDIENCE オーディエンスの条件(ユーザーリスト、ユーザーの興味や関心、カスタム アフィニティ、購買意向の強いオーディエンスなど)。
TOPIC コンテンツのターゲティング カテゴリを指定するトピック条件(例: 「category::動物>ペット」。ディスプレイや動画のターゲティングに使用します)。
GENDER 性別のターゲティング条件。
AGE_RANGE 年齢層のターゲティング条件。
PLACEMENT プレースメントの条件には、「www.flowers4sale.com」などのウェブサイト、モバイルアプリ、モバイルアプリのカテゴリ、YouTube 動画、YouTube チャンネルなどがあります。
PARENTAL_STATUS 子供の有無によるターゲティングの条件です。
INCOME_RANGE 収入の範囲ターゲティングの条件。

AdGroupAd

広告グループの広告。

JSON 表現
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
フィールド
resourceName

string

広告のリソース名。広告グループの広告リソース名の形式は次のとおりです。

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

広告のステータス。

ad

object (Ad)

広告。

creationTime

string

この adGroupAd が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

labels[]

string

この広告グループの広告に適用されているラベルのリソース名。

engineId

string

外部エンジン アカウントの広告の ID。このフィールドは、検索広告 360 アカウント(Yahoo、Microsoft、Baidu など)専用です。検索広告 360 以外のエンティティの場合は、代わりに「adGroupAd.ad.id」を使用します。

engineStatus

enum (AdGroupAdEngineStatus)

外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。

lastModifiedTime

string

この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

AdGroupAdStatus

AdGroupAd のステータスです。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED 広告グループの広告が有効になっている。
PAUSED 広告グループの広告は一時停止されています。
REMOVED 広告グループの広告は削除されます。

AdType

使用可能な広告の種類。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

TEXT_AD テキスト広告である。
EXPANDED_TEXT_AD 広告が拡張テキスト広告である。
CALL_ONLY_AD 電話専用広告である。
EXPANDED_DYNAMIC_SEARCH_AD 広告が拡張動的検索広告である。
HOTEL_AD 広告がホテル広告である。
SHOPPING_SMART_AD スマート ショッピング広告である。
SHOPPING_PRODUCT_AD 通常のショッピング広告である。
VIDEO_AD 広告が動画広告である。
GMAIL_AD この広告は Gmail 広告です。
IMAGE_AD この広告はイメージ広告です。
RESPONSIVE_SEARCH_AD 広告がレスポンシブ検索広告である。
LEGACY_RESPONSIVE_DISPLAY_AD 広告が以前のレスポンシブ ディスプレイ広告である。
APP_AD アプリ広告である。
LEGACY_APP_INSTALL_AD 広告が以前のアプリ インストール広告です。
RESPONSIVE_DISPLAY_AD 広告がレスポンシブ ディスプレイ広告である。
LOCAL_AD 広告がローカル広告である。
HTML5_UPLOAD_AD この広告は、商品カテゴリが HTML5_UPLOAD_AD のディスプレイ アップロード広告です。
DYNAMIC_HTML5_AD この広告は、いずれかの DYNAMIC_HTML5_* 商品カテゴリのディスプレイ アップロード広告です。
APP_ENGAGEMENT_AD アプリ エンゲージメント広告である。
SHOPPING_COMPARISON_LISTING_AD ショッピング比較広告である。
VIDEO_BUMPER_AD 動画のバンパー広告。
VIDEO_NON_SKIPPABLE_IN_STREAM_AD スキップ不可の動画インストリーム広告です。
VIDEO_OUTSTREAM_AD アウトストリーム動画広告です。
VIDEO_TRUEVIEW_DISCOVERY_AD 動画 TrueView インディスプレイ広告。
VIDEO_TRUEVIEW_IN_STREAM_AD 動画 TrueView インストリーム広告。
VIDEO_RESPONSIVE_AD 動画レスポンシブ広告。
SMART_CAMPAIGN_AD スマート アシスト キャンペーン広告です。
APP_PRE_REGISTRATION_AD ユニバーサル アプリ事前登録広告です。
DISCOVERY_MULTI_ASSET_AD ファインド マルチアセット広告です。
TRAVEL_AD 旅行の広告。
DISCOVERY_VIDEO_RESPONSIVE_AD ファインド動画レスポンシブ広告です。

SearchAds360TextAdInfo

検索広告 360 のテキスト広告。

JSON 表現
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
フィールド
headline

string

広告の見出し。

description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

displayUrl

string

広告の表示 URL。

displayMobileUrl

string

広告が表示されたモバイル URL。

adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ExpandedTextAdInfo

検索広告 360 の拡張テキスト広告。

JSON 表現
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
フィールド
headline

string

広告の見出し。

headline2

string

広告の 2 番目の見出し。

headline3

string

広告の 3 番目の見出し。

description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

path1

string

自動生成された表示 URL に区切り文字が追加されたテキスト。

path2

string

path1 に区切り文字で追加されたテキスト。

adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ResponsiveSearchAdInfo

検索広告 360 のレスポンシブ検索広告。

JSON 表現
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
フィールド
path1

string

自動生成された表示 URL に区切り文字が追加されたテキスト。

path2

string

path1 に区切り文字で追加されたテキスト。

adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ProductAdInfo

この型にはフィールドがありません。

検索広告 360 の商品広告。

SearchAds360ExpandedDynamicSearchAdInfo

拡張動的検索広告。

JSON 表現
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
フィールド
description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

adTrackingId

string (int64 format)

広告のトラッキング ID。

AdGroupAdEngineStatus

AdGroupAd のエンジン ステータスを列挙します。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_AD_ELIGIBLE

非推奨です。使用しないでください。

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: クリエイティブは承認されませんでした。
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW バイドゥ: モバイル URL が審査中です。
AD_GROUP_AD_PARTIALLY_INVALID バイドゥ: クリエイティブはモバイル デバイスでは無効ですが、パソコンでは有効です。
AD_GROUP_AD_TO_BE_ACTIVATED バイドゥ: クリエイティブを有効にする準備が整いました。
AD_GROUP_AD_NOT_REVIEWED Baidu: クリエイティブが審査されていません。
AD_GROUP_AD_ON_HOLD

非推奨です。使用しない。以前は Gemini で使用

AD_GROUP_AD_PAUSED クリエイティブは一時停止しました。
AD_GROUP_AD_REMOVED クリエイティブを削除しました。
AD_GROUP_AD_PENDING_REVIEW クリエイティブは審査待ちです。
AD_GROUP_AD_UNDER_REVIEW クリエイティブは審査中です。
AD_GROUP_AD_APPROVED クリエイティブが承認されました。
AD_GROUP_AD_DISAPPROVED クリエイティブが不承認となりました。
AD_GROUP_AD_SERVING クリエイティブを配信しています。
AD_GROUP_AD_ACCOUNT_PAUSED アカウントが一時停止されているため、クリエイティブは一時停止されています。
AD_GROUP_AD_CAMPAIGN_PAUSED キャンペーンが一時停止されているため、クリエイティブは一時停止されています。
AD_GROUP_AD_AD_GROUP_PAUSED 広告グループが一時停止されているため、クリエイティブは一時停止されています。

AdGroupAdLabel

広告グループの広告とラベルの関係。

JSON 表現
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
フィールド
resourceName

string

広告グループ広告ラベルのリソース名です。広告グループの広告ラベルのリソース名の形式は customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id} です。

adGroupAd

string

ラベルが添付される広告グループ広告。

label

string

広告グループ広告に割り当てられるラベル。

AdGroupAsset

広告グループとアセット間のリンク。

JSON 表現
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

必須。アセットがリンクされている広告グループ。

asset

string

必須。広告グループにリンクされているアセットです。

status

enum (AssetLinkStatus)

広告グループ アセットのステータスです。

AssetLinkStatus

アセットリンクのステータスを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED アセットのリンクが有効になっています。
REMOVED アセットのリンクを削除しました。
PAUSED アセットのリンクは一時停止されています。

AdGroupAssetSet

AdGroupAssetSet は、広告グループとアセットセット間のリンクです。AdGroupAssetSet を作成すると、アセットセットが広告グループにリンクされます。

JSON 表現
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

広告グループのアセットセットのリソース名。広告グループのアセットセットのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

このアセットセットがリンクされている広告グループ。

assetSet

string

広告グループにリンクされているアセットセット。

status

enum (AssetSetLinkStatus)

広告グループのアセットセットのステータス。読み取り専用です。

AssetSetLinkStatus

アセットセットとそのコンテナ間のリンクの考えられるステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットセットとそのコンテナのリンクが有効になっています。
REMOVED アセットセットとそのコンテナ間のリンクが解除されます。

AdGroupAudienceView

広告グループのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)に関する掲載結果データ(オーディエンス単位で集計)が含まれます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

広告グループのオーディエンス ビューのリソース名。広告グループのオーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

広告グループの入札単価調整比を表します。

JSON 表現
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1~10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0~6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。

共用体フィールド criterion。この広告グループの入札単価調整比の条件です。

V5 以降の作成オペレーションでは必須です。criterion は次のいずれかになります。

device

object (DeviceInfo)

デバイスの条件。

DeviceInfo

デバイスの条件。

JSON 表現
{
  "type": enum (Device)
}
フィールド
type

enum (Device)

デバイスのタイプ。

デバイス

ターゲティングに使用できる Google 広告のデバイスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
MOBILE フル インターネット ブラウザ搭載のモバイル デバイス。
TABLET フル インターネット ブラウザ搭載のタブレット。
DESKTOP パソコン。
CONNECTED_TV スマートテレビとゲーム機。
OTHER その他のデバイスタイプ。

AdGroupCriterion

広告グループの条件。adGroupCriterion レポートでは、広告グループに明示的に追加された条件のみが返されます。

JSON 表現
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

status

enum (AdGroupCriterionStatus)

条件のステータス。

これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。

qualityInfo

object (QualityInfo)

基準の品質に関する情報。

type

enum (CriterionType)

条件のタイプ。

labels[]

string

この広告グループの条件に適用されているラベルのリソース名。

positionEstimates

object (PositionEstimates)

さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。

finalUrls[]

string

広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。

engineId

string

外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウント(Yahoo、Microsoft、Baidu など)専用です。Google 広告エンティティの場合は、代わりに「adGroupCriterion.criterion_id」を使用します。

lastModifiedTime

string

この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

criterionId

string (int64 format)

条件の ID。

adGroup

string

条件が属する広告グループです。

negative

boolean

条件をターゲットに設定するか(false)、除外するか(true)を指定します。

このフィールドは変更できません。条件を正から負に変更するには、その条件を削除してから再度追加します。

bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1~10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。

cpcBidMicros

string (int64 format)

クリック単価(CPC)。

effectiveCpcBidMicros

string (int64 format)

有効な CPC(クリック単価)入札。

engineStatus

enum (AdGroupCriterionEngineStatus)

広告グループのエンジン ステータスの条件。

finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。

trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。

共用体フィールド criterion。広告グループの条件。

1 つのみ設定する必要があります。criterion は次のいずれかになります。

keyword

object (KeywordInfo)

キーワード。

listingGroup

object (ListingGroupInfo)

リスティング グループ。

ageRange

object (AgeRangeInfo)

年齢層。

gender

object (GenderInfo)

性別。

userList

object (UserListInfo)

ユーザーリスト。

webpage

object (WebpageInfo)

ウェブページ

location

object (LocationInfo)

位置情報] をタップします。

AdGroupCriterionStatus

AdGroupCriterion のステータスです。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED 広告グループの条件が有効になっています。
PAUSED 広告グループの条件は一時停止されています。
REMOVED 広告グループの条件が削除されます。

QualityInfo

広告グループの条件の品質情報のコンテナです。

JSON 表現
{
  "qualityScore": integer
}
フィールド
qualityScore

integer

品質スコア。

Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。

CriterionType

指定可能な条件タイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
KEYWORD キーワード(例: 「火星 クルーズ」)。
PLACEMENT プレースメント。ウェブサイトとも呼ばれます。例: www.flowers4sale.com
MOBILE_APP_CATEGORY ターゲットとするモバイルアプリ カテゴリ。
MOBILE_APPLICATION ターゲットとするモバイルアプリ。
DEVICE ターゲットに設定するデバイス。
LOCATION ターゲットに設定する地域です。
LISTING_GROUP ターゲットとするリスティング グループ。
AD_SCHEDULE 広告のスケジュール。
AGE_RANGE 年齢層。
GENDER 性別。
INCOME_RANGE 収入の範囲。
PARENTAL_STATUS 子供の有無。
YOUTUBE_VIDEO YouTube 動画。
YOUTUBE_CHANNEL YouTube チャンネル。
USER_LIST ユーザーリスト。
PROXIMITY 近接。
TOPIC ディスプレイ ネットワークのトピック ターゲット(「ペット、動物」など)。
LISTING_SCOPE 対象とするリスティング スコープ。
LANGUAGE 学びました。
IP_BLOCK IpBlock です。
CONTENT_LABEL カテゴリを除外するためのコンテンツ ラベル。
CARRIER 携帯通信会社] に移動します。
USER_INTEREST ユーザーが関心を持っているカテゴリ。
WEBPAGE 動的検索広告のウェブページの条件。
OPERATING_SYSTEM_VERSION OSの種類です
APP_PAYMENT_MODEL アプリの支払いモデル。
MOBILE_DEVICE モバイル デバイス。
CUSTOM_AFFINITY カスタム アフィニティ。
CUSTOM_INTENT カスタム インテント。
LOCATION_GROUP ビジネス グループ。
CUSTOM_AUDIENCE 作成
COMBINED_AUDIENCE 組み合わせオーディエンス
KEYWORD_THEME スマート アシスト キャンペーンのキーワードのテーマ
AUDIENCE 対象読者
LOCAL_SERVICE_ID ローカル サービス広告のサービス ID。
BRAND ブランド
BRAND_LIST ブランドリスト
LIFE_EVENT ライフイベント

PositionEstimates

さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。

JSON 表現
{
  "topOfPageCpcMicros": string
}
フィールド
topOfPageCpcMicros

string (int64 format)

検索結果の最初のページの上部に広告を表示するために必要なクリック単価の見積もり額です。

AdGroupCriterionEngineStatus

AdGroupCriterion のエンジン ステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_CRITERION_ELIGIBLE

非推奨です。使用しないでください。

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: 入札単価または品質が低すぎるため表示できません。
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME バイドゥ: 検索ボリュームが少ないため、バイドゥによって一時停止されています。
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW バイドゥ: モバイル URL が審査中です。
AD_GROUP_CRITERION_PARTIALLY_INVALID バイドゥ: 一方のデバイスのランディング ページは無効だが、もう一方のデバイスのランディング ページは有効です。
AD_GROUP_CRITERION_TO_BE_ACTIVATED バイドゥ: キーワードはバイドゥ アカウント管理によって作成および一時停止され、有効化できるようになりました。
AD_GROUP_CRITERION_UNDER_REVIEW バイドゥ: バイドゥで審査中。Gemini: 条件は審査中です。
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: 審査対象の条件。
AD_GROUP_CRITERION_ON_HOLD

非推奨です。使用しない。以前は Gemini で使用

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : 条件の審査待ち
AD_GROUP_CRITERION_PAUSED 条件が一時停止されました。
AD_GROUP_CRITERION_REMOVED 条件が削除されました。
AD_GROUP_CRITERION_APPROVED 条件が承認されました。
AD_GROUP_CRITERION_DISAPPROVED 条件は承認されませんでした。
AD_GROUP_CRITERION_SERVING 条件は有効で、配信中です。
AD_GROUP_CRITERION_ACCOUNT_PAUSED アカウントが一時停止されたため、条件も一時停止されています。

KeywordInfo

キーワードの条件。

JSON 表現
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
フィールド
matchType

enum (KeywordMatchType)

キーワードのマッチタイプ。

text

string

キーワードのテキスト(最大 80 文字、10 単語)。

KeywordMatchType

キーワードのマッチタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXACT 完全一致。
PHRASE フレーズ一致です。
BROAD 部分一致。

ListingGroupInfo

リスティング グループの条件。

JSON 表現
{
  "type": enum (ListingGroupType)
}
フィールド
type

enum (ListingGroupType)

リスティング グループのタイプ。

ListingGroupType

リスティング グループのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SUBDIVISION リスティング ディメンションに沿った商品の区分。これらのノードは、ターゲット リスティング エントリを提供するために使用されるのではなく、ツリーの構造を定義することのみを目的としています。
UNIT 入札単価を定義するリスティング グループのユニット。

AgeRangeInfo

年齢層の基準です。

JSON 表現
{
  "type": enum (AgeRangeType)
}
フィールド
type

enum (AgeRangeType)

年齢層のタイプ。

AgeRangeType

ユーザー属性の年齢層の種類(18 ~ 24 歳など)。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AGE_RANGE_18_24 18 ~ 24 歳。
AGE_RANGE_25_34 25 ~ 34 歳。
AGE_RANGE_35_44 35 ~ 44 歳。
AGE_RANGE_45_54 45 ~ 54 歳。
AGE_RANGE_55_64 55 ~ 64 歳。
AGE_RANGE_65_UP 65 歳以上。
AGE_RANGE_UNDETERMINED 年齢層不明。

GenderInfo

性別の条件。

JSON 表現
{
  "type": enum (GenderType)
}
フィールド
type

enum (GenderType)

性別のタイプ。

GenderType

ユーザー属性のタイプ(女性など)。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
MALE 男性。
FEMALE 女性。
UNDETERMINED 性別が指定されていません。

UserListInfo

ユーザーリストの条件。ターゲットに設定する広告主が定義したユーザーリストを表します。

JSON 表現
{
  "userList": string
}
フィールド
userList

string

ユーザーリストのリソース名。

WebpageInfo

広告主のウェブサイトのウェブページをターゲットに設定するための条件を表します。

JSON 表現
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
フィールド
conditions[]

object (WebpageConditionInfo)

ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

coveragePercentage

number

ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。このフィールドは読み取り専用です。

criterionName

string

このパラメータで定義されている条件の名前。name の値は、このタイプのパラメータの条件を識別、並べ替え、フィルタするために使用されます。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

WebpageConditionInfo

広告主のウェブサイトのウェブページをターゲットに設定するための論理式。

JSON 表現
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
フィールド
operand

enum (WebpageConditionOperand)

ウェブページのターゲティング条件のオペランド。

operator

enum (WebpageConditionOperator)

ウェブページ ターゲティング条件の演算子。

argument

string

ウェブページのターゲティング条件の引数。

WebpageConditionOperand

ウェブページの条件内のウェブページの条件オペランド。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
URL ウェブページ URL のターゲティング条件を示すオペランド。
CATEGORY ウェブページ カテゴリ ターゲティング条件を示すオペランド。
PAGE_TITLE ウェブページ タイトルのターゲティング条件を示すオペランド。
PAGE_CONTENT ウェブページ コンテンツ ターゲティング条件を示すオペランド。
CUSTOM_LABEL ウェブページのカスタムラベルのターゲティング条件を示すオペランド。

WebpageConditionOperator

ウェブページの条件で使用するウェブページ条件演算子です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EQUALS 引数のウェブ条件が、比較対象のウェブ条件と同じである。
CONTAINS web condition 引数は、比較対象のウェブ条件の一部です。

LocationInfo

地域の条件。

JSON 表現
{
  "geoTargetConstant": string
}
フィールド
geoTargetConstant

string

地域ターゲティングの定数リソース名。

AdGroupCriterionLabel

広告グループの条件とラベルの関係。

JSON 表現
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
フィールド
resourceName

string

広告グループの条件ラベルのリソース名。広告グループの条件ラベルのリソース名の形式は、customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id} のようになります。

adGroupCriterion

string

ラベルが添付される広告グループ条件。

label

string

広告グループの条件に割り当てられたラベル。

AdGroupLabel

広告グループとラベルの関係。

JSON 表現
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
フィールド
resourceName

string

広告グループラベルのリソース名。広告グループラベルのリソース名の形式は customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id} です。

adGroup

string

ラベルが添付される広告グループ。

label

string

広告グループに割り当てられたラベル。

AgeRangeView

年齢層のビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

アセット

アセットは広告の一部で、複数の広告で共有できます。画像(ImageAsset)や動画(YouTubeVideoAsset)などを使用できます。アセットは変更できず、削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティからアセットを削除します。

JSON 表現
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
フィールド
resourceName

string

アセットのリソース名。アセットのリソース名の形式は次のとおりです。

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

アセットのタイプ。

finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。

status

enum (AssetStatus)

アセットのステータス。

creationTime

string

この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

lastModifiedTime

string

このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

id

string (int64 format)

アセットの ID。

name

string

アセットの名前(省略可)。

trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。

engineStatus

enum (AssetEngineStatus)

アセットのエンジン ステータス。

共用体フィールド asset_data。アセットの特定のタイプ。asset_data は次のいずれかになります。
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 動画アセット。

imageAsset

object (ImageAsset)

画像アセット。

textAsset

object (TextAsset)

テキスト アセット。

calloutAsset

object (UnifiedCalloutAsset)

統合されたコールアウト アセット。

pageFeedAsset

object (UnifiedPageFeedAsset)

統合されたページフィード アセット。

mobileAppAsset

object (MobileAppAsset)

モバイルアプリのアセット。

callAsset

object (UnifiedCallAsset)

統合された電話番号アセット。

callToActionAsset

object (CallToActionAsset)

行動を促すフレーズのアセット。

locationAsset

object (UnifiedLocationAsset)

統合された住所アセット。

AssetType

使用可能なアセットタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
YOUTUBE_VIDEO YouTube 動画アセット。
MEDIA_BUNDLE メディア バンドル アセット。
IMAGE 画像アセット。
TEXT テキスト アセット。
LEAD_FORM リードフォーム アセット。
BOOK_ON_GOOGLE 「Google で予約」アセット。
PROMOTION プロモーション アセット。
CALLOUT コールアウト アセット。
STRUCTURED_SNIPPET 構造化スニペット アセット。
PAGE_FEED ページフィード アセット。
DYNAMIC_EDUCATION 動的な教育アセット。
MOBILE_APP モバイルアプリ アセット。
HOTEL_CALLOUT ホテル コールアウト アセット。
CALL 電話番号アセット。
PRICE 価格アセット。
CALL_TO_ACTION 行動を促すフレーズのアセット。
DYNAMIC_REAL_ESTATE 動的な不動産アセット。
DYNAMIC_CUSTOM 動的なカスタム アセット。
DYNAMIC_HOTELS_AND_RENTALS ホテルと賃貸物件の動的なアセット。
DYNAMIC_FLIGHTS 動的なフライト アセット。
DYNAMIC_TRAVEL 動的な旅行アセット。
DYNAMIC_LOCAL 動的なローカル アセット。
DYNAMIC_JOBS 動的な求人アセット。
LOCATION 住所アセット。
HOTEL_PROPERTY ホテル物件のアセット。

AssetStatus

アセットのステータスです。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットは有効になっています。
REMOVED アセットが削除されます。
ARCHIVED アセットはアーカイブされています。
PENDING_SYSTEM_GENERATED システムによって生成され、ユーザーの確認待ちのアセットです。

AssetEngineStatus

次の ID = 11

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SERVING アセットは有効です。
SERVING_LIMITED アセットは有効(制限付き)です。
DISAPPROVED アセットは不承認(無効)です。
DISABLED アセットは無効(保留中)です。
REMOVED アセットが削除されました。

YoutubeVideoAsset

YouTube アセット。

JSON 表現
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
フィールド
youtubeVideoTitle

string

YouTube 動画のタイトル。

youtubeVideoId

string

YouTube 動画 ID。YouTube 動画の URL で使用される 11 文字の文字列値です。

ImageAsset

画像アセット。

JSON 表現
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
フィールド
mimeType

enum (MimeType)

画像アセットの MIME タイプ。

fullSize

object (ImageDimension)

元のサイズでこの画像のメタデータ。

fileSize

string (int64 format)

画像アセットのファイルサイズ(バイト単位)。

MimeType

MIME タイプ

列挙型
UNSPECIFIED MIME タイプが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

IMAGE_JPEG image/jpeg の MIME タイプ。
IMAGE_GIF 画像/GIF の MIME タイプ。
IMAGE_PNG image/png の MIME タイプ。
FLASH application/x-shockwave-flash の MIME タイプ。
TEXT_HTML text/html の MIME タイプ。
PDF application/pdf の MIME タイプ。
MSWORD application/msword の MIME タイプ。
MSEXCEL application/vnd.ms-excel の MIME タイプ。
RTF application/rtf の MIME タイプ。
AUDIO_WAV 音声/wav の MIME タイプ。
AUDIO_MP3 Audio/mp3 の MIME タイプ。
HTML5_AD_ZIP application/x-html5-ad-zip の MIME タイプ。

ImageDimension

特定のサイズ(元のサイズまたはサイズ変更された画像)の画像のメタデータ。

JSON 表現
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
フィールド
heightPixels

string (int64 format)

画像の高さ。

widthPixels

string (int64 format)

画像の幅。

url

string

この高さと幅の画像を返す URL。

TextAsset

テキスト アセット。

JSON 表現
{
  "text": string
}
フィールド
text

string

テキスト アセットのテキスト コンテンツ。

UnifiedCalloutAsset

統合されたコールアウト アセット。

JSON 表現
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
フィールド
calloutText

string

コールアウトのテキスト。この文字列の長さは 1~25 で指定します。

startDate

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

endDate

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

adScheduleTargets[]

object (AdScheduleInfo)

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

useSearcherTimeZone

boolean

検索ユーザーのタイムゾーンでアセットを表示するかどうかを指定します。Microsoft 広告に適用されます。

AdScheduleInfo

AdSchedule 条件を表します。

AdSchedule は、広告を表示する曜日と時間帯として指定します。

同じ日に追加できる AdSchedules は 6 つまでです。

JSON 表現
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
フィールド
startMinute

enum (MinuteOfHour)

このスケジュールが開始される開始時間の数分後。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

endMinute

enum (MinuteOfHour)

終了時刻の後の分。このスケジュールが終了します。スケジュールに終了分は含まれません。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

dayOfWeek

enum (DayOfWeek)

スケジュールを適用する曜日。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

startHour

integer

開始時刻(24 時間制)。このフィールドは 0 ~ 23 の範囲で指定する必要があります。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

endHour

integer

24 時間制の終了時刻。24 は一日の終わりを表します。このフィールドは 0 ~ 24 の範囲で指定する必要があります。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

MinuteOfHour

15 分の 1 時間の列挙です。例: 「FIFTEEN」

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
ZERO 正時 0 分を過ぎています。
FIFTEEN 正時 15 分。
THIRTY 正時 30 分後。
FORTY_FIVE 正時 45 分後。

DayOfWeek

曜日を列挙します(例: 「月曜日」)。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY 水曜日
THURSDAY 木曜日
FRIDAY 金曜日です。
SATURDAY 指定します。
SUNDAY Sunday

UnifiedSitelinkAsset

統合されたサイトリンク アセット。

JSON 表現
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
フィールド
description1

string

サイトリンクの説明の 1 行目。設定する場合は、長さを 1~35 の範囲で設定し、description2 も設定する必要があります。

description2

string

サイトリンクの説明の 2 行目。設定する場合、長さは 1~35 の範囲で指定する必要があります。また、description1 も設定する必要があります。

startDate

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

endDate

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

adScheduleTargets[]

object (AdScheduleInfo)

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

trackingId

string (int64 format)

サイトリンク アセットのクリックをトラッキングするために使用される ID。これは Yahoo!日本のみのフィールドです。

useSearcherTimeZone

boolean

検索ユーザーのタイムゾーンでサイトリンク アセットを表示するかどうか。Microsoft 広告に適用されます。

mobilePreferred

boolean

サイトリンク アセットをモバイル デバイスで表示するための設定かどうかを指定します。Microsoft 広告に適用されます。

UnifiedPageFeedAsset

統合されたページフィード アセット。

JSON 表現
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
フィールド
pageUrl

string

広告主がターゲットとするウェブページ。

labels[]

string

ページ URL のグループ化に使用されるラベル。

MobileAppAsset

モバイルアプリを表すアセット。

JSON 表現
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
フィールド
appId

string

必須。モバイルアプリを一意に識別する文字列です。Android の場合は「com.android.ebay」、iOS の場合は「12345689」のように、プラットフォームのネイティブ ID のみを含める必要があります。

appStore

enum (MobileAppVendor)

必須。この特定のアプリを配信するアプリケーション ストア。

MobileAppVendor

モバイルアプリ ベンダーのタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
APPLE_APP_STORE Apple App Store のモバイルアプリ ベンダー。
GOOGLE_APP_STORE Google App Store のモバイルアプリ ベンダー。

UnifiedCallAsset

統合された電話番号アセット。

JSON 表現
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
フィールド
countryCode

string

電話番号の 2 文字の国コード。例: 「US」、「us」。

phoneNumber

string

広告主の未加工の電話番号。例: 「1234567890」、「(123)456-7890」

callConversionReportingState

enum (CallConversionReportingState)

この CallAsset では、独自の通話コンバージョン設定を使用するか、アカウント単位の設定を使用するか、通話コンバージョンを無効にするかを示します。

callConversionAction

string

通話コンバージョンを関連付けるコンバージョン アクション。設定しない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callConversionReportingState が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効になります。

adScheduleTargets[]

object (AdScheduleInfo)

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

callOnly

boolean

ウェブサイトへのリンクのない電話番号のみが通話に表示されるかどうか。Microsoft 広告に適用されます。

callTrackingEnabled

boolean

コール トラッキングで通話を有効にするかどうか。Microsoft 広告に適用されます。

useSearcherTimeZone

boolean

検索ユーザーのタイムゾーンで電話番号表示オプションを表示するかどうかを指定します。Microsoft 広告に適用されます。

startDate

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

endDate

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

CallConversionReportingState

通話コンバージョン アクションの状態で使用可能なデータタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DISABLED 通話コンバージョン アクションが無効になっています。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、アカウント単位で設定された通話コンバージョンの種類が使用されます。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、リソース(電話専用広告または電話番号表示オプション)単位で設定された通話コンバージョンの種類が使用されます。

CallToActionAsset

行動を促すフレーズのアセット。

JSON 表現
{
  "callToAction": enum (CallToActionType)
}
フィールド
callToAction

enum (CallToActionType)

お気軽にお問い合わせください。

CallToActionType

行動を促すフレーズのタイプを説明する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEARN_MORE カスタム外部リンクの種類は詳細です。
GET_QUOTE 行動を促すフレーズのタイプは「見積もりを依頼」です。
APPLY_NOW 行動を促すフレーズのタイプを適用しました。
SIGN_UP カスタム外部リンクの種類は登録です。
CONTACT_US 行動を促すフレーズの種類は「お問い合わせ」です。
SUBSCRIBE 行動を促すフレーズのタイプは、チャンネル登録です。
DOWNLOAD 行動を促すフレーズのタイプは「ダウンロード」です。
BOOK_NOW 行動を促すフレーズのタイプは「今すぐ予約」です。
SHOP_NOW 行動を促すフレーズのタイプは「今すぐ購入」です。
BUY_NOW 行動を促すフレーズのタイプは「今すぐ購入」です。
DONATE_NOW 行動を促すフレーズの種類は「今すぐ寄付する」です。
ORDER_NOW 行動を促すフレーズのタイプは「order」です。
PLAY_NOW 行動を促すフレーズのタイプは「今すぐ再生」です。
SEE_MORE 行動を促すフレーズのタイプは詳細です。
START_NOW 行動を促すフレーズのタイプは「今すぐ開始」です。
VISIT_SITE 行動を促すフレーズのタイプは「サイトにアクセス」です。
WATCH_NOW 行動を促すフレーズのタイプは「今すぐ見る」です。

UnifiedLocationAsset

統合された住所アセット。

JSON 表現
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
フィールド
placeId

string

プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、特定のお客様 ID とアセットタイプに対して一意です。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。

businessProfileLocations[]

object (BusinessProfileLocation)

顧客のビジネス拠点のリスト。ビジネス プロフィール アカウントから住所アセットを同期している場合にのみ返されます。同じアカウントで、同じ場所 ID を参照する複数のビジネス プロフィールのリスティングを作成できます。

locationOwnershipType

enum (LocationOwnershipType)

ビジネスのオーナー権限のタイプ。タイプが BUSINESS_OWNER の場合は、住所表示オプションとして表示されます。タイプが AFFILIATE の場合は、アフィリエイト住所として使用されます。

BusinessProfileLocation

リンクされたビジネス プロフィール アカウントから同期された、ビジネス プロフィールのビジネス情報。

JSON 表現
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
フィールド
labels[]

string

広告主様がビジネス プロフィール アカウントでビジネス情報に対して指定したラベル。これはビジネス プロフィール アカウントから同期されます。

storeCode

string

このビジネス拠点のビジネス プロフィールの店舗コード。これはビジネス プロフィール アカウントから同期されます。

listingId

string (int64 format)

このビジネス プロフィールのビジネス情報のリスティング ID。これは、リンクされているビジネス プロフィール アカウントから同期されます。

LocationOwnershipType

ビジネスのオーナー権限の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BUSINESS_OWNER ビジネス拠点のビジネス オーナー(従来版の住所表示オプション - LE)。
AFFILIATE アフィリエイト住所(第三者の住所表示オプション - ALE)。

AssetGroupAsset

AssetGroupAsset は、アセットとアセット グループ間のリンクです。AssetGroupAsset を追加すると、アセットがアセット グループとリンクされます。

JSON 表現
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

アセット グループのアセットのリソース名。アセット グループのアセット リソース名の形式:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

このアセット グループのアセットがリンクしているアセット グループ。

asset

string

このアセット グループのアセットがリンクしているアセット。

fieldType

enum (AssetFieldType)

アセット グループ内のアセットのプレースメントの説明。例: HEADLINE、YOUTUBE_VIDEO など

status

enum (AssetLinkStatus)

アセットとアセット グループ間のリンクのステータス。

AssetFieldType

アセットのプレースメントを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
HEADLINE 広告見出しとして使用するためにアセットがリンクされています。
DESCRIPTION アセットは説明として使用するためにリンクされています。
MANDATORY_AD_TEXT 必須の広告文として使用できるよう、アセットがリンクされている。
MARKETING_IMAGE アセットは、マーケティング画像として使用するためにリンクされています。
MEDIA_BUNDLE アセットがメディア バンドルとして使用するためにリンクされています。
YOUTUBE_VIDEO YouTube 動画として使用するためにアセットがリンクされています。
BOOK_ON_GOOGLE アセットがリンクされ、ホテル キャンペーンで「Google で予約」が有効になっていることを示す。
LEAD_FORM リードフォーム表示オプションとして使用するためにアセットがリンクされています。
PROMOTION プロモーション表示オプションとして使用するためにアセットがリンクされています。
CALLOUT コールアウト表示オプションとして使用するために、アセットがリンクされています。
STRUCTURED_SNIPPET 構造化スニペット表示オプションとして使用するために、アセットがリンクされています。
MOBILE_APP モバイル アプリリンク表示オプションとして使用するためにアセットがリンクされています。
HOTEL_CALLOUT ホテルのコールアウト表示オプションとして使用するためにアセットがリンクされています。
CALL 電話番号表示オプションとして使用するようにアセットがリンクされています。
PRICE 価格表示オプションとして使用するためにアセットがリンクされています。
LONG_HEADLINE 長い広告見出しとして使用できるよう、アセットがリンクされています。
BUSINESS_NAME ビジネス名として使用するためにアセットがリンクされています。
SQUARE_MARKETING_IMAGE アセットは、スクエアのマーケティング画像として使用するためにリンクされています。
PORTRAIT_MARKETING_IMAGE 縦向きのマーケティング画像として使用するためにアセットがリンクされています。
VIDEO アセットが YouTube 以外のロゴとして使用するためにリンクされています。
CALL_TO_ACTION_SELECTION 行動を促すフレーズの選択に使用するためにアセットがリンクされています。
AD_IMAGE 広告画像を選択するためにアセットがリンクされています。
HOTEL_PROPERTY 旅行関連の目標達成のための P-MAX キャンペーンで、ホテル物件として使用するためにアセットがリンクされています。

AssetGroupSignal

AssetGroupSignal は、アセット グループ内のシグナルを表します。シグナルがあれば、コンバージョンに至る見込みが特に高い P-MAX キャンペーンがわかります。P-MAX ではシグナルを使用して、検索、ディスプレイ、動画などのさまざまなチャネルでコンバージョンを見つけるため、購買意向が似ているユーザーやより強い新しいユーザーを探します。

JSON 表現
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
フィールド
resourceName

string

アセット グループ シグナルのリソース名。アセット グループのシグナルのリソース名の形式:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

このアセット グループのシグナルが属するアセット グループ。

共用体フィールド signal。アセット グループのシグナル。signal は次のいずれかになります。
audience

object (AudienceInfo)

P-MAX キャンペーンで使用されるオーディエンス シグナル。

AudienceInfo

オーディエンスの条件です。

JSON 表現
{
  "audience": string
}
フィールド
audience

string

オーディエンス リソース名。

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタツリー ノードを表します。

JSON 表現
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
フィールド
resourceName

string

アセット グループのリスティング グループ フィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

このアセット グループのリスティング グループ フィルタが属しているアセット グループ。

id

string (int64 format)

ListingGroupFilter の ID。

type

enum (ListingGroupFilterType)

リスティング グループのフィルタノードの種類。

vertical

enum (ListingGroupFilterVertical)

現在のノードツリーが表す垂直。同じツリー内のすべてのノードは同じカテゴリに属している必要があります。

caseValue

object (ListingGroupFilterDimension)

このリスティング グループが親を絞り込むために使用するディメンション値。ルートグループに対して未定義です。

parentListingGroupFilter

string

親のリスティング グループの区分のリソース名。ルート リスティング グループのフィルタノードの場合は null。

path

object (ListingGroupFilterDimensionPath)

このリスティング グループ フィルタを定義するディメンションのパス。

ListingGroupFilterType

リスティング グループのフィルタのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SUBDIVISION 一部のリスティング ディメンションに基づく商品の区分。
UNIT_INCLUDED 含まれるリスティング グループのフィルタリーフノード。
UNIT_EXCLUDED 除外リスティング グループのフィルタリーフノード。

ListingGroupFilterVertical

リスティング グループのフィルタ カテゴリのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SHOPPING ショッピングのカテゴリを表します。このカテゴリは、小売向け P-MAX キャンペーンでのみ使用できます。

ListingGroupFilterDimension

アセット グループのリスティング グループ フィルタのリスティング ディメンション。

JSON 表現
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
フィールド
共用体フィールド dimension。次のいずれかのタイプのディメンションが常に存在します。dimension は次のいずれかになります。
productBiddingCategory

object (ProductBiddingCategory)

商品情報の入札カテゴリ。

productBrand

object (ProductBrand)

商品のブランド。

productChannel

object (ProductChannel)

商品の地域区分。

productCondition

object (ProductCondition)

商品情報の状態。

productCustomAttribute

object (ProductCustomAttribute)

商品のカスタム属性。

productItemId

object (ProductItemId)

商品の商品アイテム ID。

productType

object (ProductType)

商品情報のタイプ。

ProductBiddingCategory

特定のレベルの入札カテゴリの 1 つの要素。最上位のカテゴリはレベル 1、その子はレベル 2 というように続きます。現在、最大 5 つのレベルがサポートされています。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じ区分のすべてのケースは、同じディメンション タイプ(カテゴリレベル)である必要があります。

JSON 表現
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
フィールド
level

enum (ListingGroupFilterBiddingCategoryLevel)

分類におけるカテゴリのレベルを示します。

id

string (int64 format)

商品入札カテゴリの ID。

この ID は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。

ListingGroupFilterBiddingCategoryLevel

リスティング グループのフィルタ入札カテゴリのレベル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3
LEVEL4 レベル 4
LEVEL5 レベル 5

ProductBrand

商品のブランド。

JSON 表現
{
  "value": string
}
フィールド
value

string

商品ブランドの文字列値。

ProductChannel

商品の地域区分。

JSON 表現
{
  "channel": enum (ListingGroupFilterProductChannel)
}
フィールド
channel

enum (ListingGroupFilterProductChannel)

地域区分の値。

ListingGroupFilterProductChannel

商品の地域区分を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONLINE この商品はオンラインで販売されています。
LOCAL この商品は実店舗で販売されています。

ProductCondition

商品情報の状態。

JSON 表現
{
  "condition": enum (ListingGroupFilterProductCondition)
}
フィールド
condition

enum (ListingGroupFilterProductCondition)

条件の値。

ListingGroupFilterProductCondition

商品情報の状態を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NEW 商品の状態が新品である。
REFURBISHED 商品の状態は再生品です。
USED 商品の状態が使用されます。

ProductCustomAttribute

商品のカスタム属性。

JSON 表現
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
フィールド
index

enum (ListingGroupFilterCustomAttributeIndex)

カスタム属性のインデックスを示します。

value

string

商品のカスタム属性の文字列値。

ListingGroupFilterCustomAttributeIndex

顧客属性のインデックス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
INDEX0 最初のリスティング グループのフィルタのカスタム属性。
INDEX1 2 番目のリスティング グループのフィルタのカスタム属性。
INDEX2 3 番目のリスティング グループ フィルタのカスタム属性。
INDEX3 4 番目のリスティング グループ フィルタのカスタム属性。
INDEX4 5 番目のリスティング グループ フィルタのカスタム属性。

ProductItemId

商品の商品アイテム ID。

JSON 表現
{
  "value": string
}
フィールド
value

string

ID の値。

ProductType

商品情報のタイプ。

JSON 表現
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
フィールド
level

enum (ListingGroupFilterProductTypeLevel)

タイプのレベル。

value

string

型の値。

ListingGroupFilterProductTypeLevel

商品情報のタイプのレベルを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3
LEVEL4 レベル 4
LEVEL5 レベル 5

ListingGroupFilterDimensionPath

リスティング グループのフィルタを定義する項目のパス。

JSON 表現
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
フィールド
dimensions[]

object (ListingGroupFilterDimension)

リスティング グループのフィルタ階層(ルートノードを除く)を通過するディメンションの、このリスティング グループ フィルタへの完全なパス。

AssetGroupTopCombinationView

広告グループの広告アセットの組み合わせの使用状況に関するビュー。

JSON 表現
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
フィールド
resourceName

string

アセット グループの上位の組み合わせビューのリソース名。AssetGroup の上位の組み合わせビューのリソース名の形式は、"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" です。

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

同時に配信されたアセットの上位の組み合わせ。

AssetGroupAssetCombinationData

アセット グループのアセットの組み合わせデータ

JSON 表現
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
フィールド
assetCombinationServedAssets[]

object (AssetUsage)

配信されたアセット。

AssetUsage

アセットの使用状況に関する情報が格納されています。

JSON 表現
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
フィールド
asset

string

アセットのリソース名。

servedAssetFieldType

enum (ServedAssetFieldType)

アセットの配信フィールド タイプ。

ServedAssetFieldType

使用可能なアセット フィールドのタイプ。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

HEADLINE_1 アセットは広告見出し 1 で使用されています。
HEADLINE_2 アセットは広告見出し 2 で使用されています。
HEADLINE_3 アセットは広告見出し 3 で使用されています。
DESCRIPTION_1 アセットが説明文 1 で使用されている。
DESCRIPTION_2 アセットが説明文 2 で使用されている。
HEADLINE アセットが広告見出しで使用されています。広告見出しが 1 つしかない場合にのみ使用します。それ以外の場合は、HEADLINE_1、HEADLINE_2、または HEADLINE_3 の列挙型を使用します。
HEADLINE_IN_PORTRAIT このアセットは、縦向き画像の見出しとして使用されました。
LONG_HEADLINE アセットが長い広告見出し(MultiAsset レスポンシブ検索広告で使用)で使用されています。
DESCRIPTION アセットが説明で使用されました。広告内の説明文が 1 つしかない場合にのみ使用します。それ以外の場合は、DESCRIPTION_1 または DESCRIPTION_@ 列挙型を使用します。
DESCRIPTION_IN_PORTRAIT このアセットは、縦向き画像の説明として使われていました。
BUSINESS_NAME_IN_PORTRAIT このアセットは、縦向き画像のビジネス名として使用されていました。
BUSINESS_NAME アセットがビジネス名として使用されていた。
MARKETING_IMAGE アセットがマーケティング画像として使用されていた。
MARKETING_IMAGE_IN_PORTRAIT このアセットは、縦向き画像のマーケティング画像として使用されました。
SQUARE_MARKETING_IMAGE アセットはスクエアのマーケティング画像として使用されました。
PORTRAIT_MARKETING_IMAGE このアセットは、縦向きのマーケティング画像として使用されました。
CALL_TO_ACTION 行動を促すフレーズとしてアセットが使用されていた。
YOU_TUBE_VIDEO アセットが YouTube 動画として使用されていた。
CALL このアセットは電話番号として使用されています。
MOBILE_APP このアセットはモバイルアプリとして使用されています。
CALLOUT このアセットはコールアウトとして使用されます。
STRUCTURED_SNIPPET このアセットは構造化スニペットとして使用されます。
PRICE このアセットは価格として使用されます。
PROMOTION このアセットはプロモーションとして使用されています。
AD_IMAGE このアセットは画像として使用されます。
LEAD_FORM アセットがリードフォームとして使用されます。

AssetGroup

アセット グループAssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
フィールド
resourceName

string

アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

アセット グループの ID

campaign

string

このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。

name

string

必須。アセット グループの名前。必須。長さは 1 ~ 128 文字以内にする必要があります。キャンペーン内で一意である必要があります。

finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。

finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。

status

enum (AssetGroupStatus)

アセット グループのステータス。

path1

string

広告に表示される URL に表示されるテキストの最初の部分です。

path2

string

広告に表示される URL に付加されて表示されるテキストの 2 番目の部分。このフィールドは、path1 が設定されている場合にのみ設定できます。

adStrength

enum (AdStrength)

このアセット グループの全体的な広告の有効性。

AssetGroupStatus

アセット グループのステータスです。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。
ENABLED アセット グループは有効になっています。
PAUSED アセット グループは一時停止されています。
REMOVED アセット グループが削除されました。

AdStrength

広告の有効性を列挙する列挙型です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING 広告の有効性は現在「保留中」です。
NO_ADS 広告を生成できませんでした。
POOR 強度が足りません。
AVERAGE 平均的な強度。
GOOD かなり強い。
EXCELLENT 非常に強い。

AssetSetAsset

AssetSetAsset は、アセットとアセットセット間のリンクです。AssetSetAsset を追加すると、アセットとアセットセットがリンクされます。

JSON 表現
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
フィールド
resourceName

string

アセットセットのアセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

このアセットセットのアセットがリンクしているアセットセット。

asset

string

このアセットセットのアセットがリンクしているアセット。

status

enum (AssetSetAssetStatus)

アセットセットのアセットのステータス。読み取り専用です。

AssetSetAssetStatus

アセットセットのアセットのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットセットのアセットが有効になっています。
REMOVED アセットセットのアセットが削除されました。

AssetSet

アセットのコレクションを表すアセットセット。AssetSetAsset を使用して、アセットをアセットセットにリンクします。

JSON 表現
{
  "id": string,
  "resourceName": string
}
フィールド
id

string (int64 format)

アセットセットの ID。

resourceName

string

アセットセットのリソース名。アセットセットのリソース名の形式は次のとおりです。

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

入札戦略。

JSON 表現
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
フィールド
resourceName

string

入札戦略のリソース名。入札戦略のリソース名の形式は次のとおりです。

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

入札戦略のステータス。

このフィールドは読み取り専用です。

type

enum (BiddingStrategyType)

入札戦略のタイプ。入札スキームを設定して入札戦略を作成します。

このフィールドは読み取り専用です。

currencyCode

string

入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。

クライアント センター(MCC)の顧客の入札戦略の場合、この通貨は作成時に設定でき、デフォルトは MCC 顧客の通貨になります。サービスを提供する顧客の場合は、このフィールドを設定できません。サービスを提供する顧客のすべての戦略で、サービス提供顧客の通貨が暗黙的に使用されます。いずれの場合も、effectiveCurrencyCode フィールドは戦略で使用される通貨を返します。

id

string (int64 format)

入札戦略の ID。

name

string

入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。

この文字列の長さは UTF-8 バイトで 1~255 の値にする必要があります(切り詰められます)。

effectiveCurrencyCode

string

入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。

クライアント センター(MCC)顧客の入札戦略の場合、これは広告主が戦略の作成時に設定した通貨です。サービスを提供する顧客の場合、顧客の currencyCode になります。

入札戦略の指標は、この通貨でレポートされます。

このフィールドは読み取り専用です。

campaignCount

string (int64 format)

この入札戦略が適用されているキャンペーンの数です。

このフィールドは読み取り専用です。

nonRemovedCampaignCount

string (int64 format)

この入札戦略に適用された削除済み以外のキャンペーンの数。

このフィールドは読み取り専用です。

共用体フィールド scheme。入札方式。

1 つのみ設定できます。scheme は次のいずれかになります。

enhancedCpc

object (EnhancedCpc)

コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる入札戦略。

maximizeConversionValue

object (MaximizeConversionValue)

予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。

maximizeConversions

object (MaximizeConversions)

予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。

targetCpa

object (TargetCpa)

指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。

targetImpressionShare

object (TargetImpressionShare)

選択した割合のインプレッションを重視して自動的に最適化する入札戦略です。

targetOutrankShare

object (TargetOutrankShare)

特定の競合他社よりも上位に掲載する必要があるオークションの目標割合に基づいて入札単価を設定できる入札戦略。このフィールドのサポートは終了しています。このフィールドを使用して新しい入札戦略を作成したり、このフィールドを使用して入札戦略をキャンペーンに適用したりすることはできません。このスキームがすでに入力されている戦略への変更は可能です。

targetRoas

object (TargetRoas)

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる入札戦略。

targetSpend

object (TargetSpend)

予算内でクリック数を最大限に獲得できるように入札単価を設定する入札戦略。

BiddingStrategyStatus

入札戦略のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED 入札戦略が有効になっています。
REMOVED 入札戦略が削除されている。

BiddingStrategyType

利用可能な入札戦略タイプを説明する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
COMMISSION コミッションは自動入札戦略の一種で、広告主様はコンバージョン値の一定割合を支払う。
ENHANCED_CPC 拡張クリック単価は、コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる入札戦略です。
INVALID 戻り値にのみ使用されます。キャンペーンに入札戦略が設定されていないことを示します。これにより、キャンペーンの広告が配信されなくなります。たとえば、マネージャーの入札戦略にキャンペーンを関連付けると、その後、広告配信中のアカウントと MCC アカウントとのリンクが解除されます。この場合、そのキャンペーンは、アクセス不可となっているマネージャーの入札戦略から自動的に接続解除され、無効な入札戦略タイプに移行します。
MANUAL_CPA 広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。
MANUAL_CPC クリックに基づく個別の入札単価。クリック 1 回ごとに支払います。
MANUAL_CPM インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。
MANUAL_CPV 動画の視聴ごとに設定可能な金額を支払う入札戦略です。
MAXIMIZE_CONVERSIONS 1 日の予算内でコンバージョン数を自動的に最大化する入札戦略。
MAXIMIZE_CONVERSION_VALUE ご指定の予算を消化しつつ収益を最大化できるように入札単価を自動的に設定する自動入札戦略です。
PAGE_ONE_PROMOTED ページ 1 プロモート入札スキーム。上限クリック単価を設定して、google.com のページ 1 またはページ 1 のプロモート スロットのインプレッションをターゲットにします。この列挙値は非推奨となりました。
PERCENT_CPC クリック単価の割合は、商品やサービスの広告価格に対する割合を入札単価にする入札戦略です。
TARGET_CPA 目標コンバージョン単価は、指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。
TARGET_CPM 目標インプレッション単価は、設定した目標インプレッション単価(CPM)でできるだけ多くのインプレッションを獲得できるように入札単価を設定する自動入札戦略です。
TARGET_IMPRESSION_SHARE 一定の割合の検索広告が最初のページ(または他の対象地域)の上部に表示されるように入札単価を設定する自動入札戦略です。
TARGET_OUTRANK_SHARE 目標優位表示シェアは自動入札戦略の一種であり、特定の競合他社よりも上位に表示すべきオークションの目標割合に基づいて入札単価を設定します。この列挙値は非推奨となりました。
TARGET_ROAS 目標広告費用対効果(ROAS)は、特定の目標の平均広告費用対効果(ROAS)を平均化しつつ、収益を最大化するのに役立つ自動入札戦略です。
TARGET_SPEND 目標予算は自動入札戦略の一種で、予算内でクリック数を最大化できるように入札単価が自動的に調整されます。

EnhancedCpc

この型にはフィールドがありません。

コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる自動入札戦略。

この入札戦略はサポートが終了したため、作成できなくなりました。同等の機能のために、EnhancedCpcEnabled を true に設定した ManualCpc を使用します。

MaximizeConversionValue

予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。

JSON 表現
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
フィールド
cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

cpcBidFloorMicros

string (int64 format)

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

targetRoas

number

目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。

MaximizeConversions

予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。

JSON 表現
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
フィールド
cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

cpcBidFloorMicros

string (int64 format)

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

targetCpaMicros

string (int64 format)

目標コンバージョン単価(CPA)オプション。指定したコンバージョン アクションあたりの平均費用として、入札戦略の通貨のマイクロ単位で指定します。設定すると、入札戦略は目標コンバージョン単価以下で最大限のコンバージョンを獲得します。目標コンバージョン単価が設定されていない場合は、予算内で可能な限り低いコンバージョン単価の達成を目指します。

TargetCpa

指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。

cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

cpcBidFloorMicros

string (int64 format)

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

TargetImpressionShare

一定の割合の検索広告が最初のページ(または他の対象地域)の上部に表示されるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
location

enum (TargetImpressionShareLocation)

検索結果ページの対象地域

locationFractionMicros

string (int64 format)

対象地域で表示する広告の割合(マイクロ単位)。たとえば、1% は 10,000 に相当します。

cpcBidCeilingMicros

string (int64 format)

自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。

TargetImpressionShareLocation

可能な目標を説明する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ANYWHERE_ON_PAGE ウェブページ上の任意の場所。
TOP_OF_PAGE 広告の上部ボックス。
ABSOLUTE_TOP_OF_PAGE 広告の上部ボックスの上部スロット。

TargetOutrankShare

特定の競合他社よりも上位に掲載すべきオークションの目標割合に基づいて入札単価を設定する自動入札戦略。この戦略は非推奨になりました。

JSON 表現
{
  "cpcBidCeilingMicros": string
}
フィールド
cpcBidCeilingMicros

string (Int64Value format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

TargetRoas

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる自動入札戦略です。

JSON 表現
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
フィールド
targetRoas

number

必須。費用単価の選択された収益(コンバージョン データに基づく)。値は 0.01~1000.0 の範囲で指定する必要があります。

cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

cpcBidFloorMicros

string (int64 format)

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

TargetSpend

予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
targetSpendMicros
(deprecated)

string (int64 format)

クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。

cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

CampaignBudget

キャンペーンの予算

JSON 表現
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
フィールド
resourceName

string

キャンペーン予算のリソース名。キャンペーンの予算リソース名の形式は次のとおりです。

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

キャンペーン予算が消費される割合を決定する配信方法。

作成オペレーションで指定しない場合のデフォルトは STANDARD です。

period

enum (BudgetPeriod)

予算を消化する期間。指定しない場合のデフォルトは DAILY です。

amountMicros

string (int64 format)

アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。

BudgetDeliveryMethod

予算の配分方法。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
STANDARD 予算サーバーは、全期間を通じて均等に広告配信を調整します。
ACCELERATED 予算サーバーによる広告配信が抑制されることはなく、広告はできるだけ早く配信されます。

BudgetPeriod

候補となる予算の期間。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DAILY 1 日の予算。
FIXED_DAILY 1 日の予算は固定されており、
CUSTOM_PERIOD カスタム予算と total_amount を併用して、全期間の予算の上限を指定できます。

キャンペーン

キャンペーン。

JSON 表現
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
フィールド
resourceName

string

キャンペーンのリソース名。キャンペーンのリソース名の形式は次のとおりです。

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

キャンペーンのステータス。

新しいキャンペーンが追加されると、ステータスはデフォルトで有効に設定されます。

servingStatus

enum (CampaignServingStatus)

キャンペーンの広告配信ステータス。

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

キャンペーンの入札戦略のシステム ステータスです。

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

キャンペーンの広告配信の最適化ステータス。

advertisingChannelType

enum (AdvertisingChannelType)

キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは networkSettings で絞り込むことができます。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。

advertisingChannelSubType

enum (AdvertisingChannelSubType)

advertisingChannelType への絞り込み(省略可)。親チャネルタイプの有効なサブタイプを指定してください。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplatefinalUrlsmobile_final_urls でカスタム パラメータ タグの置換に使用されるマッピングのリスト。

realTimeBiddingSetting

object (RealTimeBiddingSetting)

リアルタイム ビッダー(Ad Exchange ネットワークをターゲットとするキャンペーンのみ)の設定。

networkSettings

object (NetworkSettings)

キャンペーンの掲載ネットワークの設定です。

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

動的検索広告(DSA)を管理するための設定。

shoppingSetting

object (ShoppingSetting)

ショッピング キャンペーンを管理するための設定です。

geoTargetTypeSetting

object (GeoTargetTypeSetting)

広告の地域ターゲティングの設定。

labels[]

string

このキャンペーンに適用されたラベルのリソース名。

biddingStrategyType

enum (BiddingStrategyType)

入札戦略のタイプ。

入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する [biddingStrategy] フィールドを設定します。

このフィールドは読み取り専用です。

accessibleBiddingStrategy

string

AccessibleBiddingStrategy のリソース名。「biddingStrategy」によって特定された、適用されたポートフォリオ入札戦略の無制限の属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は、空になります。入札戦略の属性は、その戦略を共有しているすべてのお客様が使用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付きの属性は、戦略の所有者とそのマネージャーだけが使用できます。制限付き属性は、 BiddingStrategy リソースからのみ読み取ることができます。

frequencyCaps[]

object (FrequencyCapEntry)

このキャンペーンの広告が各ユーザーに表示される頻度を制限するリスト。

selectiveOptimization

object (SelectiveOptimization)

このキャンペーンの一部の最適化設定です。このキャンペーンの最適化で重視するコンバージョン アクションが含まれています。この機能は、 AdvertisingChannelType として MULTI_CHANNEL を使用し、 AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用しているアプリ キャンペーンにのみ適用されます。

optimizationGoalSetting

object (OptimizationGoalSetting)

このキャンペーンの最適化目標の設定です。最適化の目標タイプのセットが含まれています。

trackingSetting

object (TrackingSetting)

キャンペーン単位のトラッキング情報の設定。

engineId

string

外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

このキャンペーンから除外するアセット フィールドのタイプです。これらのフィールド タイプのアセットリンクは、このキャンペーンの上位レベルから継承されません。

createTime

string

このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。createTime は v1 で非推奨になります。代わりに creationTime を使用してください。

creationTime

string

このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

lastModifiedTime

string

このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

id

string (int64 format)

キャンペーンの ID。

name

string

キャンペーンの名前です。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。

trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。

campaignBudget

string

キャンペーンの予算

startDate

string

お客様のタイムゾーンでキャンペーンが配信を開始した日付(YYYY-MM-DD 形式)。

endDate

string

ユーザーのタイムゾーンで配信されるキャンペーンの最終日(YYYY-MM-DD 形式)。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。

finalUrlSuffix

string

並行トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用される接尾辞。

urlExpansionOptOut

boolean

よりターゲットを絞った URL への URL の拡張をオプトアウトすることを表します。オプトアウト(true)の場合、アセット グループの最終ページ URL、または広告主の Google Merchant Center またはビジネスデータ フィードで指定された URL のみがターゲティングされます。オプトイン(false)の場合、ドメイン全体がターゲティングされます。このフィールドを設定できるのは P-MAX キャンペーンのみで、デフォルト値は false です。

共用体フィールド campaign_bidding_strategy。キャンペーンの入札戦略。

ポートフォリオ(入札戦略サービスを通じて作成)または標準のいずれかで、キャンペーンに埋め込まれている必要があります。campaign_bidding_strategy は次のいずれかになります。

biddingStrategy

string

キャンペーンで使用されるポートフォリオ入札戦略。

manualCpa

object (ManualCpa)

標準の「個別コンバージョン単価」入札戦略を使用します。広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。ローカル サービス キャンペーンでのみ使用できます。

manualCpc

object (ManualCpc)

標準の個別クリック単価入札戦略。クリックベースの個別単価設定(クリック課金型)。

manualCpm

object (ManualCpm)

標準の個別インプレッション単価入札戦略です。インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。

maximizeConversions

object (MaximizeConversions)

ご指定の予算を消化しつつコンバージョン数を自動的に最大化する、標準の「コンバージョン数の最大化」入札戦略です。

maximizeConversionValue

object (MaximizeConversionValue)

ご指定の予算を消化しつつ収益を最大化できるよう、入札単価を自動的に設定する、標準の「コンバージョン値の最大化」入札戦略

targetCpa

object (TargetCpa)

標準の「目標コンバージョン単価」入札戦略です。設定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が自動的に設定されます。

targetImpressionShare

object (TargetImpressionShare)

目標インプレッション シェア入札戦略自動入札戦略の 1 つで、指定した割合のインプレッションを達成できるように入札単価を設定します。

targetRoas

object (TargetRoas)

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を自動的に最大化する標準の「目標広告費用対効果」入札戦略。

targetSpend

object (TargetSpend)

標準の目標予算入札戦略です。予算内でクリック数を最大限に獲得できるように入札単価が自動的に調整されます。

percentCpc

object (PercentCpc)

商品やサービスの広告価格に対する割合を入札単価とする標準のクリック単価入札戦略です。

targetCpm

object (TargetCpm)

インプレッション単価を自動的に最適化する入札戦略です。

CampaignStatus

キャンペーンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED キャンペーンは有効で、広告を表示できます。
PAUSED キャンペーンはユーザーによって一時停止されました。
REMOVED キャンペーンが削除されました。

CampaignServingStatus

キャンペーンの配信ステータスとして考えられるもの。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

SERVING 配信中。
NONE なし。
ENDED 終了。
PENDING Pending.
SUSPENDED 停止中。

BiddingStrategySystemStatus

入札戦略のシステム ステータスとして考えられるもの。

列挙型
UNSPECIFIED 入札戦略のタイプが見つからなかった、ステータス情報が見つからないなど、予期しないエラーが発生したことを表します。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED この入札戦略は有効になっており、特に問題も見つかっていません。
LEARNING_NEW この入札戦略は最近作成されたか最近再度有効にされたため、学習中です。
LEARNING_SETTING_CHANGE 最近設定が変更されたため、この入札戦略は学習中です。
LEARNING_BUDGET_CHANGE 最近予算が変更されたため、この入札戦略は学習中です。
LEARNING_COMPOSITION_CHANGE この入札戦略が適用されているキャンペーン、広告グループ、またはキーワードの数が最近変更されたため、この入札戦略は学習中です。
LEARNING_CONVERSION_TYPE_CHANGE 入札戦略は、コンバージョン レポートと、入札戦略に関係していたコンバージョンの種類をユーザーが最近変更したかどうかによって決まります。
LEARNING_CONVERSION_SETTING_CHANGE 入札戦略がコンバージョン レポートを使用していて、顧客が最近コンバージョン設定を変更した。
LIMITED_BY_CPC_BID_CEILING この入札戦略は入札単価の上限によって制限されています。
LIMITED_BY_CPC_BID_FLOOR この入札戦略は入札単価の下限によって制限されています。
LIMITED_BY_DATA 過去数週間に十分なコンバージョン トラフィックがなかったため、この入札戦略は制限されています。
LIMITED_BY_BUDGET この入札戦略では、かなりの割合のキーワードが予算による制限を受けています。
LIMITED_BY_LOW_PRIORITY_SPEND 費用の優先度が下がっているため、この入札戦略は目標予算を達成できません。
LIMITED_BY_LOW_QUALITY この入札戦略では、かなりの割合のキーワードで品質スコアが低下しています。
LIMITED_BY_INVENTORY ターゲティングの範囲が狭いため、入札戦略で予算を使い切ることができません。
MISCONFIGURED_ZERO_ELIGIBILITY コンバージョン トラッキングが設定されていない(ping がない)か、スマート ショッピング キャンペーンでリマーケティング リストが設定されている。
MISCONFIGURED_CONVERSION_TYPES 入札戦略がコンバージョン レポートを使用していて、この戦略でレポートされる可能性のあるコンバージョンの種類が顧客にはない場合。
MISCONFIGURED_CONVERSION_SETTINGS 入札戦略がコンバージョン レポートに基づいていて、顧客のコンバージョン設定が誤っている。
MISCONFIGURED_SHARED_BUDGET 入札戦略に含まれないキャンペーンが、戦略に含まれるキャンペーンと予算を共有している。
MISCONFIGURED_STRATEGY_TYPE キャンペーンの入札戦略タイプが無効で、配信されていません。
PAUSED この入札戦略は有効になっていません。この入札戦略が適用されている有効なキャンペーン、広告グループ、キーワードがない。または、入札戦略に有効な予算が関連付けられていません。
UNAVAILABLE 現在、この入札戦略はステータス レポートに対応していません。
MULTIPLE_LEARNING お問い合わせの期間中、この入札戦略に複数のシステム ステータス LEARNING_* が発生しました。
MULTIPLE_LIMITED お問い合わせの期間中、この入札戦略に複数のシステム ステータス LIMITED_* がありました。
MULTIPLE_MISCONFIGURED お問い合わせの期間中、この入札戦略に複数のシステム ステータス MISCONFIGURED_* が発生しました。
MULTIPLE お問い合わせの期間中、この入札戦略には複数のシステム ステータスがありました。

AdServingOptimizationStatus

配信ステータスを表す列挙型。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

OPTIMIZE 広告配信は、キャンペーンのクリック率に基づいて最適化されます。
CONVERSION_OPTIMIZE 広告配信は、キャンペーンのクリック率 × コンバージョン数に基づいて最適化されます。キャンペーンがコンバージョン オプティマイザーの入札戦略に使用されていない場合、デフォルトで「OPTIMIZED」が使用されます。
ROTATE 広告は 90 日間均等にローテーションされた後、クリック重視で最適化されます。
ROTATE_INDEFINITELY 成果の低い広告をより均等に表示し、最適化は行いません。
UNAVAILABLE 広告配信の最適化ステータスを表示できません。

AdvertisingChannelType

さまざまな広告チャネルのタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SEARCH 検索ネットワークこれには、ディスプレイ ネットワーク向けキャンペーンと検索+ キャンペーンが含まれます。
DISPLAY Google ディスプレイ ネットワークのみ。
SHOPPING ショッピング キャンペーンは、ショッピング 宿泊施設と google.com の検索結果に表示されます。
HOTEL ホテル広告キャンペーン
VIDEO 動画キャンペーン。
MULTI_CHANNEL アプリ キャンペーンとアプリ エンゲージメント キャンペーン(複数のチャネルで実施)
LOCAL ローカル広告キャンペーン
SMART スマート アシスト キャンペーン
PERFORMANCE_MAX おすすめします
LOCAL_SERVICES ローカル サービス キャンペーン。
DISCOVERY ファインド キャンペーン。
TRAVEL 旅行キャンペーン

AdvertisingChannelSubType

さまざまなチャネルのサブタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用します。このバージョンで不明な値を表します。
SEARCH_MOBILE_APP 検索キャンペーンのモバイルアプリ キャンペーン。
DISPLAY_MOBILE_APP ディスプレイ ネットワーク向けモバイルアプリ キャンペーン
SEARCH_EXPRESS 検索向け AdWords Express キャンペーン。
DISPLAY_EXPRESS ディスプレイ広告用の AdWords Express キャンペーン
SHOPPING_SMART_ADS スマートショッピングキャンペーン
DISPLAY_GMAIL_AD Gmail 広告キャンペーン
DISPLAY_SMART_CAMPAIGN スマート ディスプレイ キャンペーン: このサブタイプの新しいキャンペーンは作成できません。
VIDEO_OUTSTREAM 動画アウトストリーム キャンペーン
VIDEO_ACTION 動画 TrueView アクション キャンペーン。
VIDEO_NON_SKIPPABLE スキップ不可の動画広告を含む動画キャンペーン。
APP_CAMPAIGN アプリ キャンペーンを使用すると、Google 検索、Google Play、YouTube、Google ディスプレイ ネットワークなど、Google の主要なプロパティで Android アプリまたは iOS アプリを簡単に宣伝できます。
APP_CAMPAIGN_FOR_ENGAGEMENT 検索、YouTube、Google ディスプレイ ネットワークなど、Google の主要な複数のサービスでアプリのリエンゲージメントを促進することに重点を置いたアプリ エンゲージメント キャンペーン。
LOCAL_CAMPAIGN ローカル広告に特化したキャンペーン。
SHOPPING_COMPARISON_LISTING_ADS ショッピング比較キャンペーン。
SMART_CAMPAIGN 標準のスマート アシスト キャンペーン。
VIDEO_SEQUENCE シーケンス動画広告を含む動画キャンペーン。
APP_CAMPAIGN_FOR_PRE_REGISTRATION Google Play、YouTube、ディスプレイ ネットワークの複数の広告チャネルをターゲットとする、モバイルアプリの事前登録に特化したアプリ事前登録キャンペーンです。
VIDEO_REACH_TARGET_FREQUENCY フリークエンシー目標入札戦略を使用した動画リーチ キャンペーン。
TRAVEL_ACTIVITIES 旅行活動キャンペーン

CustomParameter

trackingUrlTemplatefinalUrlsmobile_final_urls のカスタム パラメータ タグで使用できるマッピング。

JSON 表現
{
  "key": string,
  "value": string
}
フィールド
key

string

パラメータタグ名と一致するキー。

value

string

置換される値。

RealTimeBiddingSetting

リアルタイム ビッダー(Ad Exchange ネットワークをターゲットとするキャンペーンのみ)の設定。

JSON 表現
{
  "optIn": boolean
}
フィールド
optIn

boolean

キャンペーンでリアルタイム ビッダーが有効になっているかどうか。

NetworkSettings

キャンペーンの掲載ネットワークの設定です。

JSON 表現
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
フィールド
targetSearchNetwork

boolean

Google 検索ネットワークのパートナー サイトに広告を配信するかどうか(targetGoogleSearchtrue にする必要があります)。

targetContentNetwork

boolean

Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。

targetPartnerSearchNetwork

boolean

Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。

DynamicSearchAdsSetting

動的検索広告(DSA)を管理するための設定。

JSON 表現
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
フィールド
domainName

string

必須。この設定が表すインターネット ドメイン名(「google.com」や「www.google.com」など)。

languageCode

string

必須。ドメインの言語を指定する言語コード(例: en)。

useSuppliedUrlsOnly

boolean

キャンペーンで、広告主指定の URL のみを使用しているかどうか。

ShoppingSetting

ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンと他のショッピング キャンペーンとの相互作用を定義します。

JSON 表現
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
フィールド
feedLabel

string

キャンペーンに含める商品のフィードラベル。設定できるのは feedLabel または salesCountry のみです。salesCountry の代わりに使用する場合は、feedLabel フィールドにも同じ形式の国コード(例: 「XX」)を指定できます。それ以外の場合は、Google Merchant Center でフィードラベルに使用される文字列を指定できます。

useVehicleInventory

boolean

車両リスティング広告枠をターゲットとするかどうか。

merchantId

string (int64 format)

Merchant Center アカウントの ID。このフィールドは、作成オペレーションでは必須です。ショッピング キャンペーンの場合、このフィールドは変更できません。

salesCountry

string

キャンペーンに含める商品の販売国。

campaignPriority

integer

キャンペーンの優先順位。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンで必須で、値は 0 ~ 2 です。スマート ショッピング キャンペーンの場合、このフィールドは省略可能ですが、設定する場合は 3 にする必要があります。

enableLocal

boolean

ローカル商品を含めるかどうか。

GeoTargetTypeSetting

広告の地域ターゲティングに関連する設定のコレクションを表します。

JSON 表現
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
フィールド
positiveGeoTargetType

enum (PositiveGeoTargetType)

このキャンペーンで非除外地域ターゲティングに使用される設定です。

negativeGeoTargetType

enum (NegativeGeoTargetType)

このキャンペーンの除外地域ターゲティングに使用される設定です。

PositiveGeoTargetType

指定可能な地域ターゲティングのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
PRESENCE_OR_INTEREST ユーザーが広告主の対象地域にいるか、その地域に関心を示した場合に、広告が表示されることを指定します。
SEARCH_INTEREST ユーザーが広告主の対象地域を検索した場合に、広告が表示されることを指定します。検索キャンペーンと通常のショッピング キャンペーンでのみ使用できます。
PRESENCE ユーザーが広告主の対象地域にいるか、定期的に訪れている場合に、広告が表示されることを指定します。

NegativeGeoTargetType

除外対象地域のタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
PRESENCE_OR_INTEREST 広告主の除外地域にいるユーザー、または広告主の除外地域に関心を示しているユーザーを除外します。
PRESENCE 広告主の除外地域にいるユーザーに対して広告を表示しないよう指定します。

FrequencyCapEntry

この型にはフィールドがありません。

特定の期間内に 1 つの広告(または一部の広告)を 1 つのユーザーに表示できる最大回数を指定するルールです。

SelectiveOptimization

このキャンペーンの一部の最適化設定です。このキャンペーンの最適化で重視するコンバージョン アクションが含まれています。この機能は、 AdvertisingChannelType として MULTI_CHANNEL を使用し、 AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用しているアプリ キャンペーンにのみ適用されます。

JSON 表現
{
  "conversionActions": [
    string
  ]
}
フィールド
conversionActions[]

string

このキャンペーンの最適化のために選択したコンバージョン アクションのセット。

OptimizationGoalSetting

このキャンペーンの最適化目標の設定です。最適化の目標タイプのセットが含まれています。

JSON 表現
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
フィールド
optimizationGoalTypes[]

enum (OptimizationGoalType)

最適化の目標タイプのリスト。

OptimizationGoalType

最適化の目標のタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用します。このバージョンで不明な値を表します。
CALL_CLICKS 通話クリック重視で最適化します。通話クリック コンバージョンとは、広告を見たユーザーが店舗に電話するために [電話] を選択した回数です。
DRIVING_DIRECTIONS 運転ルート向けに最適化します。運転ルート コンバージョンとは、ユーザーが広告を見た後に [ルートを検索] を選択して来店した回数です。
APP_PRE_REGISTRATION 事前登録を重視して最適化する。事前登録コンバージョンとは、アプリがリリースされたときに通知を受け取る事前登録の件数です。

TrackingSetting

キャンペーン単位のトラッキング情報の設定。

JSON 表現
{
  "trackingUrl": string
}
フィールド
trackingUrl

string

動的トラッキングに使用される URL。

ManualCpa

この型にはフィールドがありません。

広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。

ManualCpc

クリックベースの個別単価設定(クリック課金型)。

JSON 表現
{
  "enhancedCpcEnabled": boolean
}
フィールド
enhancedCpcEnabled

boolean

コンバージョン オプティマイザーのデータに基づいて入札単価を拡張するかどうか。

ManualCpm

この型にはフィールドがありません。

インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。

PercentCpc

商品やサービスの広告価格に対して、わずかな金額で入札する入札戦略。

JSON 表現
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
フィールド
cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。これは広告主が入力するオプションのフィールドで、ローカルのマイクロ秒単位で指定します。注: 値が 0 の場合は、bid_latency が未定義の場合と同様に解釈されます。

enhancedCpcEnabled

boolean

コンバージョンにつながる可能性に応じて、オークションごとに入札単価を調整します。個々の入札単価は cpcBidCeilingMicros を上回る場合がありますが、キャンペーンの平均入札単価が上回らないようにしてください。

TargetCpm

この型にはフィールドがありません。

目標インプレッション単価(目標インプレッション単価)は自動入札戦略の一種で、設定した目標インプレッション単価に基づいてパフォーマンスが最適化されるように入札単価が設定されます。

CampaignAsset

キャンペーンとアセット間のリンク。

JSON 表現
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
フィールド
resourceName

string

キャンペーン アセットのリソース名。CampaignAsset リソース名の形式は次のとおりです。

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

キャンペーン アセットのステータスです。

campaign

string

アセットがリンクされているキャンペーン。

asset

string

キャンペーンにリンクされているアセット。

CampaignAssetSet

CampaignAssetSet は、キャンペーンとアセットセット間のリンクです。CampaignAssetSet を追加すると、アセットセットとキャンペーンがリンクされます。

JSON 表現
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

キャンペーンのアセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

このアセットセットがリンクされているキャンペーン。

assetSet

string

キャンペーンにリンクされているアセットセット。

status

enum (AssetSetLinkStatus)

キャンペーンのアセットセットのアセットのステータス。読み取り専用です。

CampaignAudienceView

キャンペーンのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告向けのインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)に関する掲載結果データ(キャンペーンとオーディエンスの条件別に集計)が含まれます。このビューには、キャンペーン単位で設定されたオーディエンスのみが含まれます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

キャンペーンのオーディエンス ビューのリソース名。キャンペーンのオーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

キャンペーンの条件。

JSON 表現
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

キャンペーンの条件のリソース名。キャンペーンの条件のリソース名の形式は次のとおりです。

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

条件の表示名。

このフィールドはミューテーションの場合は無視されます。

type

enum (CriterionType)

条件のタイプ。

status

enum (CampaignCriterionStatus)

条件のステータス。

lastModifiedTime

string

このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

criterionId

string (int64 format)

条件の ID。

このフィールドは、変更時は無視されます。

bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。デバイスタイプをオプトアウトするには、0 を使用します。

negative

boolean

条件をターゲットに設定するか(false)、除外するか(true)を指定します。

共用体フィールド criterion。キャンペーンの条件。

1 つのみ設定する必要があります。criterion は次のいずれかになります。

keyword

object (KeywordInfo)

キーワード。

location

object (LocationInfo)

位置情報] をタップします。

device

object (DeviceInfo)

デバイス] など)を選択します。

ageRange

object (AgeRangeInfo)

年齢層。

gender

object (GenderInfo)

性別。

userList

object (UserListInfo)

ユーザーリスト。

language

object (LanguageInfo)

学びました。

webpage

object (WebpageInfo)

ウェブページ。

locationGroup

object (LocationGroupInfo)

地域グループ

CampaignCriterionStatus

CampaignCriterion のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED キャンペーンの条件は有効になっています。
PAUSED キャンペーンの条件は一時停止されています。
REMOVED キャンペーンの条件は削除されます。

LanguageInfo

言語の条件。

JSON 表現
{
  "languageConstant": string
}
フィールド
languageConstant

string

言語定数のリソース名。

LocationGroupInfo

フィードで指定された場所のリストを中心とした半径です。

JSON 表現
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
フィールド
geoTargetConstants[]

string

フィード内の地域の範囲を制限する地域ターゲティングの定数。現在、使用できる地域ターゲティングの定数は 1 つのみです。

radiusUnits

enum (LocationGroupRadiusUnits)

半径の単位。地域ターゲティングの定数では、マイルとメートルがサポートされています。フィード アイテム セットではミリマイルとメートルがサポートされています。これは必須であり、CREATE オペレーションで設定する必要があります。

feedItemSets[]

string

FeedItems がターゲットとする FeedItemSet。複数の ID を指定すると、少なくとも 1 つのセットに出現するすべての項目がターゲティングされます。このフィールドは geoTargetConstants では使用できません。これはオプションであり、CREATE オペレーションでのみ設定できます。

radius

string (int64 format)

対象地域を中心とした半径を指定する単位での距離です。これは必須であり、CREATE オペレーションで設定する必要があります。

LocationGroupRadiusUnits

地域グループ内の半径の距離の単位(例: MILES)

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
METERS メートル
MILES マイル
MILLI_MILES ミリマイル

CampaignLabel

キャンペーンとラベルの関係を表します。

JSON 表現
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
フィールド
resourceName

string

リソースの名前。キャンペーン ラベルのリソース名の形式は customers/{customerId}/campaignLabels/{campaign_id}~{label_id} です。

campaign

string

ラベルが添付されるキャンペーン。

label

string

キャンペーンに割り当てられるラベル。

CartDataSalesView

カートデータのセールスビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

カートデータの販売ビューのリソース名。カートデータの販売ビューのリソース名の形式は customers/{customerId}/cartDataSalesView です。

対象読者

オーディエンスは効果的なターゲティング オプションです。詳しいユーザー属性やアフィニティなどのさまざまなセグメント属性を組み合わせて、ターゲット セグメントの各セクションを表すオーディエンスを作成できます。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
フィールド
resourceName

string

オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

オーディエンスの ID。

name

string

必須。オーディエンスの名前。すべてのオーディエンスで一意である必要があります。長さは 1 ~ 255 にする必要があります。

description

string

このオーディエンスの説明。

ConversionAction

コンバージョン アクション。

JSON 表現
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
フィールド
resourceName

string

コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Floodlight アクティビティの作成時点のタイムスタンプ(ISO 8601 形式)。

status

enum (ConversionActionStatus)

コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。

type

enum (ConversionActionType)

このコンバージョン アクションのタイプ。

category

enum (ConversionActionCategory)

このコンバージョン アクションについてレポートされたコンバージョンのカテゴリです。

valueSettings

object (ValueSettings)

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。

attributionModelSettings

object (AttributionModelSettings)

このコンバージョン アクションのアトリビューション モデルに関連する設定です。

floodlightSettings

object (FloodlightSettings)

Floodlight コンバージョン タイプの Floodlight 設定。

id

string (int64 format)

コンバージョン アクションの ID。

name

string

コンバージョン アクションの名前。

新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。

primaryForGoal

boolean

コンバージョン アクションの primaryForGoal ビットが false の場合、そのコンバージョン アクションは、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、すべてのキャンペーンで入札不可になります。ただし、カスタム コンバージョン目標では primaryForGoal が考慮されないため、キャンペーンのカスタム コンバージョン目標で「primaryForGoal = false」のコンバージョン アクションが設定されていても、そのコンバージョン アクションは入札対象です。設定されていない場合、デフォルトで primaryForGoal は true になります。V9 では、primaryForGoal がオプションとして宣言されていないため、「update」オペレーションで作成された場合のみ false に設定できます。

ownerCustomer

string

コンバージョン アクションの所有者の顧客のリソース名。システム定義のコンバージョン アクションの場合は null。

includeInClientAccountConversionsMetric

boolean

このコンバージョン アクションを「clientAccountConversion」指標に含めるかどうか。

includeInConversionsMetric

boolean

このコンバージョン アクションを「コンバージョン」指標に含めるかどうか。

clickThroughLookbackWindowDays

string (int64 format)

インタラクション(クリックなど)からコンバージョン イベントまでの最大日数。

appId

string

アプリ コンバージョン アクションのアプリ ID。

ConversionActionStatus

コンバージョン アクションのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED コンバージョンが記録されます。
REMOVED コンバージョンは記録されません。
HIDDEN コンバージョンは記録されず、コンバージョン アクションは管理画面に表示されません。

ConversionActionType

コンバージョン アクションの種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_CALL ユーザーが広告の電話番号表示オプションをクリックすると発生するコンバージョン。
CLICK_TO_CALL モバイル デバイスのユーザーが電話番号をクリックしたときに発生するコンバージョン。
GOOGLE_PLAY_DOWNLOAD ユーザーが Google Play ストアからモバイルアプリをダウンロードしたときに発生するコンバージョン。
GOOGLE_PLAY_IN_APP_PURCHASE ユーザーが Android の請求を通じてアプリ内で購入を行うと発生するコンバージョン。
UPLOAD_CALLS 広告主様がトラッキングし、アップロードした通話コンバージョンです。
UPLOAD_CLICKS 広告主によってトラッキングされ、貢献度が割り当てられたクリックとともにアップロードされたコンバージョン。
WEBPAGE ウェブページで発生するコンバージョン。
WEBSITE_CALL 広告主のウェブサイトから動的に生成された電話番号にユーザーが電話をかけたときに発生するコンバージョン。
STORE_SALES_DIRECT_UPLOAD 自社またはサードパーティの販売者データのアップロードに基づく店舗販売コンバージョン。店舗での販売の直接アップロードのタイプを使用できるのは、許可リストに登録されているお客様のみです。
STORE_SALES 自社またはサードパーティの販売者データのアップロードや、決済ネットワークのカードを使用した実店舗での購入に基づく店舗販売コンバージョン。店舗販売のタイプを使用できるのは、許可リストに登録されているお客様のみです。読み取り専用。
FIREBASE_ANDROID_FIRST_OPEN Firebase でトラッキングされた Android アプリの初回起動コンバージョン。
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase でトラッキングされた Android アプリのアプリ内購入コンバージョン。
FIREBASE_ANDROID_CUSTOM Firebase でトラッキングされた Android アプリのカスタム コンバージョン。
FIREBASE_IOS_FIRST_OPEN Firebase でトラッキングされた iOS アプリの初回起動コンバージョン。
FIREBASE_IOS_IN_APP_PURCHASE Firebase でトラッキングされた iOS アプリのアプリ内購入コンバージョン。
FIREBASE_IOS_CUSTOM Firebase でトラッキングされた iOS アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 第三者のアプリ分析でトラッキングされた Android アプリの初回起動コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 第三者のアプリ分析でトラッキングされた Android アプリ内の購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 第三者のアプリ分析でトラッキングされた Android アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 第三者のアプリ分析でトラッキングされた iOS アプリの初回起動コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 第三者のアプリ分析でトラッキングされた iOS アプリ内の購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 第三者のアプリ分析でトラッキングされた iOS アプリのカスタム コンバージョン。
ANDROID_APP_PRE_REGISTRATION ユーザーが Google Play ストアからモバイルアプリを事前登録したときに発生するコンバージョン。読み取り専用。
ANDROID_INSTALLS_ALL_OTHER_APPS アプリ固有のタイプでトラッキングされていない、すべての Google Play ダウンロードをトラッキングしているコンバージョン。読み取り専用。
FLOODLIGHT_ACTION ユーザーが広告主の広告を表示またはクリックした後に特定のウェブページを訪問した回数をカウントする Floodlight アクティビティ。読み取り専用。
FLOODLIGHT_TRANSACTION 販売が成立した回数または購入されたアイテムの数をトラッキングする Floodlight アクティビティ。個々の販売の合計金額も取得できます。読み取り専用。
GOOGLE_HOSTED 広告と接点を持った後に Google の商品やサービスに由来するローカル アクションをトラッキングしたコンバージョンです。読み取り専用。
LEAD_FORM_SUBMIT ユーザーがリードフォームを送信したときにレポートされるコンバージョン。読み取り専用。
SALESFORCE Salesforce で発生したコンバージョン。読み取り専用。
SEARCH_ADS_360 検索広告 360 の Floodlight データからインポートされたコンバージョン。読み取り専用。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL スマート アシスト キャンペーンのカスタム条件を使用して、コール トラッキングを設定せずにスマート アシスト キャンペーン広告で発生した通話コンバージョンです。読み取り専用。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ユーザーが Google マップ内の通話要素をクリックします。スマート アシスト キャンペーンのみ読み取り専用。
SMART_CAMPAIGN_MAP_DIRECTIONS ユーザーが Google マップ内のビジネス拠点へのルートをリクエストします。スマート アシスト キャンペーンのみ読み取り専用。
SMART_CAMPAIGN_TRACKED_CALLS スマート アシスト キャンペーンのカスタム条件を使用して、コール トラッキングを設定したスマート アシスト キャンペーン広告で発生した通話コンバージョンです。読み取り専用。
STORE_VISITS ユーザーが広告主の実店舗を訪問したときに発生するコンバージョン。読み取り専用。
WEBPAGE_CODELESS 個別にコーディングされたイベント スニペットを使用しない、ウェブサイトのイベント(フォームの送信やページの読み込みなど)から作成されたコンバージョン。読み取り専用。
UNIVERSAL_ANALYTICS_GOAL リンクされたユニバーサル アナリティクスの目標に由来するコンバージョン。
UNIVERSAL_ANALYTICS_TRANSACTION リンクされたユニバーサル アナリティクスのトランザクションに由来するコンバージョン。
GOOGLE_ANALYTICS_4_CUSTOM リンクされた Google アナリティクス 4 カスタム イベント コンバージョンに由来するコンバージョン。
GOOGLE_ANALYTICS_4_PURCHASE リンクされた Google アナリティクス 4 の購入コンバージョンに由来するコンバージョン。

ConversionActionCategory

ConversionAction に関連付けられているコンバージョンのカテゴリ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DEFAULT デフォルトのカテゴリ。
PAGE_VIEW ページにアクセスしているユーザー。
PURCHASE 購入、販売、または「注文完了」イベント。
SIGNUP 登録ユーザーの操作。
LEAD 見込み顧客を発掘するアクション。
DOWNLOAD ソフトウェアのダウンロード アクション(アプリの場合)。
ADD_TO_CART 広告主様のサイトのショッピング カートやバッグに商品アイテムを追加すること。
BEGIN_CHECKOUT ユーザーが広告主のサイトで購入手続きのフローに入ったとき。
SUBSCRIBE_PAID 商品やサービスの有料サブスクリプションの開始。
PHONE_CALL_LEAD 広告主のサービスに対する関心を示すための呼び出し。
IMPORTED_LEAD 外部ソースから Google 広告にインポートされたリード コンバージョン。
SUBMIT_LEAD_FORM 広告主のサイトでビジネスに関心を示していることを示すフォームの送信。
BOOK_APPOINTMENT 広告主のビジネスとの面談の予約。
REQUEST_QUOTE 見積もりまたは価格見積もりのリクエスト。
GET_DIRECTIONS 来店の意向がある広告主のビジネス拠点の検索。
OUTBOUND_CLICK 広告主のパートナー サイトへのクリック。
CONTACT 広告主への通話、SMS、メール、チャット、その他の連絡。
ENGAGEMENT サイトの滞在時間や Google アナリティクス(GA)のスマートゴールなど、ウェブサイトのエンゲージメント イベントです。Google アナリティクス、Firebase、Google アナリティクスのゴールド目標のインポートに使用することを目的としています。
STORE_VISIT 実店舗への来店。
STORE_SALE 実店舗での販売。
QUALIFIED_LEAD 外部ソースから Google 広告にインポートされたリード コンバージョンで、広告主様(マーケティング チームまたはセールスチーム)によってさらに認定されたもの。見込み顧客が購入に至る過程で、広告主様は見込み顧客を獲得し、それに基づいて消費者に働きかけます。消費者が商品に興味を持ち、最終的に購入する可能性がある場合、広告主はそのような見込み顧客を「有望な見込み顧客」としてマークします。
CONVERTED_LEAD 外部ソースから Google 広告にインポートされたリード コンバージョンで、見込み顧客の発掘を目標とする広告主様が指定したステージをさらに完了したもの。

ValueSettings

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。

JSON 表現
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
フィールド
defaultValue

number

このコンバージョン アクションのコンバージョン イベントに無効な値、許可されていない値、または値がない場合、または常にデフォルト値を使用するように設定されている場合に使用する値です。

defaultCurrencyCode

string

このコンバージョン アクションのコンバージョン イベントの通貨コードが無効か指定されていない場合、または常にデフォルト値を使用するようにこのコンバージョン アクションが設定されている場合に使用する通貨コードです。

alwaysUseDefaultValue

boolean

このコンバージョン アクションのコンバージョン イベントで指定された値と通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを指定します。

AttributionModelSettings

このコンバージョン アクションのアトリビューション モデルに関連する設定です。

JSON 表現
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
フィールド
attributionModel

enum (AttributionModel)

このコンバージョン アクションのアトリビューション モデルのタイプ。

dataDrivenModelStatus

enum (DataDrivenModelStatus)

コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。

AttributionModel

特定のコンバージョンのクレジットを、過去の多くの接点に配分する方法を記述するアトリビューション モデル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXTERNAL 外部のアトリビューションを使用します。
GOOGLE_ADS_LAST_CLICK コンバージョン経路のすべての貢献度をラストクリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google 検索アトリビューションを使用して、コンバージョンのすべてのクレジットをファースト クリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google 検索アトリビューションを使用して、発生したすべてのクリックにコンバージョンへの貢献度を均等に割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google 検索アトリビューションを使用すると、コンバージョンに対する最近のクリックに、指数関数的に貢献度が割り当てられます(半減期は 1 週間)。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED コンバージョン経路の最初のクリックとラストクリックに、コンバージョンに対する貢献度の 40% を割り当てます。残りの 20% が他のすべてのクリックに均等に配分されます。Google 検索アトリビューションを使用します。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Google 検索アトリビューションを使用し、機械学習を利用して各クリックに貢献度を適切に配分する柔軟なモデル。

DataDrivenModelStatus

データドリブン モデルのステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AVAILABLE データドリブン モデルを利用できる。
STALE データドリブン モデルが古くなっています。7 日以上更新されていません。コードはまだ使用されていますが、30 日間更新されないと期限切れになります。
EXPIRED データドリブン モデルの有効期限が切れています。30 日以上更新されていないため、使用できません。最もよくある原因としては、過去 30 日間に必要な数のイベントが発生していないことが考えられます。
NEVER_GENERATED データドリブン モデルが生成されたことはない。最もよくある原因としては、30 日間で必要な数のイベントが発生していないことが考えられます。

FloodlightSettings

Floodlight コンバージョン アクションに関連する設定。

JSON 表現
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
フィールド
activityGroupTag

string

コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。

activityTag

string

コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。

activityId

string (int64 format)

DoubleClick Campaign Manager(DCM)の Floodlight アクティビティの ID。

ConversionCustomVariable

コンバージョン カスタム変数。詳しくは、https://support.google.com/sa360/answer/13567857 の「検索広告 360 リニューアル版でのカスタム Floodlight 指標とディメンションについて」をご覧ください。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
フィールド
resourceName

string

コンバージョン カスタム変数のリソース名。コンバージョン カスタム変数のリソース名の形式は次のとおりです。

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

コンバージョン カスタム変数の ID。

name

string

必須。コンバージョン カスタム変数の名前。名前は一意である必要があります。名前の最大長は 100 文字です。前後に余分なスペースを入れないでください。

tag

string

必須。コンバージョン カスタム変数のタグ。タグは一意で、「u」文字の直後に 100 以下の数字が続くものである必要があります。例: 「u4」。

status

enum (ConversionCustomVariableStatus)

コンバージョン イベントの発生に関するコンバージョン カスタム変数のステータス。

ownerCustomer

string

コンバージョン カスタム変数を所有する顧客のリソース名。

family

enum (ConversionCustomVariableFamily)

コンバージョン カスタム変数のファミリーです。

cardinality

enum (ConversionCustomVariableCardinality)

コンバージョン カスタム変数の基数。

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

検索広告 360 Floodlight コンバージョン カスタム変数のフィールド。

customColumnIds[]

string (int64 format)

このコンバージョン カスタム変数を使用するカスタム列の ID。

ConversionCustomVariableStatus

コンバージョン カスタム変数のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVATION_NEEDED

コンバージョン カスタム変数は有効化を待機しており、有効にするまで統計情報は発生しません。

このステータスは、CREATE および UPDATE リクエストでは使用できません。

ENABLED コンバージョン カスタム変数は有効になっており、統計情報が消費されます。
PAUSED コンバージョン カスタム変数は一時停止されており、再び有効にするまで統計情報は蓄積されません。

ConversionCustomVariableFamily

コンバージョン カスタム変数のファミリーです。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
STANDARD 標準のコンバージョン カスタム変数。使用する前に、お客様は有効にする必要があります。
FLOODLIGHT カスタム Floodlight 変数からインポートされたコンバージョン カスタム変数。

ConversionCustomVariableCardinality

コンバージョン カスタム変数の基数。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BELOW_ALL_LIMITS コンバージョン カスタム変数の基数がすべての上限を下回っています。この変数をセグメンテーションに使用できます。変数が有効になっている場合は、新しい値に対して統計情報が集計されます。
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT コンバージョン カスタム変数の基数がセグメント数の上限を超えていますが、統計情報の上限を超えていません。セグメンテーションは無効になりますが、変数を有効にすると新しい値の統計情報が集計されます。
APPROACHES_STATS_LIMIT コンバージョン カスタム変数はセグメンテーションの上限を超え、統計情報の上限に近づいています(90% を超えています)。セグメンテーションは無効になりますが、変数を有効にすると新しい値の統計情報が集計されます。
EXCEEDS_STATS_LIMIT コンバージョン カスタム変数が分割と統計情報の両方の上限を超えています。セグメンテーションは無効になり、有効な変数の統計情報は、既存の値によって変数の基数がそれ以上増えない場合にのみ蓄積されます。

FloodlightConversionCustomVariableInfo

検索広告 360 の Floodlight コンバージョン カスタム変数に関する情報です。

JSON 表現
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
フィールド
floodlightVariableType

enum (FloodlightVariableType)

検索広告 360 で定義された Floodlight 変数タイプ。

floodlightVariableDataType

enum (FloodlightVariableDataType)

検索広告 360 で定義されている Floodlight 変数のデータ型。

FloodlightVariableType

検索広告 360 で定義されている Floodlight 変数のタイプ。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DIMENSION ディメンションの Floodlight 変数タイプ。
METRIC 指標の Floodlight 変数タイプ。
UNSET Floodlight 変数タイプが設定されていません。

FloodlightVariableDataType

検索広告 360 で定義されている Floodlight 変数のデータ型。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NUMBER 「Number」タイプの Floodlight 変数を表します。この変数は、DIMENSION または METRIC タイプの Floodlight 変数に割り当てることができます。
STRING 「文字列」タイプの Floodlight 変数を表します。この変数は、DIMENSION タイプの Floodlight 変数に割り当てることができます。

顧客

顧客です。

JSON 表現
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
フィールド
resourceName

string

顧客のリソース名。顧客リソース名の形式は次のとおりです。

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

顧客のコンバージョン トラッキング設定。

accountType

enum (AccountType)

エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど)

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

クライアント センター(MCC)の顧客用の DoubleClick Campaign Manager(DCM)の設定。

accountStatus

enum (AccountStatus)

アカウントのステータス(有効、一時停止、削除済みなど)

lastModifiedTime

string

この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

engineId

string

外部エンジン アカウントのアカウント ID。

status

enum (CustomerStatus)

顧客のステータス。

creationTime

string

この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

id

string (int64 format)

顧客の ID。

descriptiveName

string

(省略可)顧客の一意でないわかりやすい名前。

currencyCode

string

アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。

timeZone

string

顧客のローカル タイムゾーン ID。

trackingUrlTemplate

string

パラメータからトラッキング URL を作成するための URL テンプレート。

finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。

autoTaggingEnabled

boolean

ユーザーに対して自動タグ設定が有効になっているかどうか。

manager

boolean

お客様がマネージャーであるかどうか。

ConversionTrackingSetting

検索広告 360 のコンバージョン トラッキングに関連するユーザー全体の設定のコレクションです。

JSON 表現
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
フィールド
acceptedCustomerDataTerms

boolean

お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はマネージャーから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。

conversionTrackingStatus

enum (ConversionTrackingStatus)

コンバージョン トラッキングのステータスです。顧客がコンバージョン トラッキングを使用しているかどうかと、その顧客のコンバージョン トラッキングの所有者は誰か。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの login-customer-id によって異なります。

enhancedConversionsForLeadsEnabled

boolean

お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はマネージャーから継承されます。このフィールドは読み取り専用です。

googleAdsConversionCustomer

string

コンバージョンが作成、管理される顧客のリソース名。このフィールドは読み取り専用です。

conversionTrackingId

string (int64 format)

このアカウントで使用されているコンバージョン トラッキング ID。この ID は、ユーザーがコンバージョン トラッキングを使用しているかどうかを示すものではありません(conversionTrackingStatus は使用しています)。このフィールドは読み取り専用です。

googleAdsCrossAccountConversionTrackingId

string (int64 format)

顧客のマネージャーのコンバージョン トラッキング ID。ユーザーがコンバージョン トラッキングを有効にしているときに設定され、conversionTrackingId をオーバーライドします。この項目は Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。

crossAccountConversionTrackingId

string (int64 format)

顧客のマネージャーのコンバージョン トラッキング ID。顧客がクロスアカウント コンバージョン トラッキングを有効にしている場合に設定され、conversionTrackingId をオーバーライドします。

ConversionTrackingStatus

顧客のコンバージョン トラッキング ステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NOT_CONVERSION_TRACKED 顧客はコンバージョン トラッキングを使用していない。
CONVERSION_TRACKING_MANAGED_BY_SELF コンバージョン アクションは、この顧客が作成、管理します。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER コンバージョン アクションは、リクエストの login-customer-id で指定されたマネージャーによって作成、管理されます。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER コンバージョン アクションが、リクエストの login-customer-id で指定された顧客またはマネージャーとは異なるマネージャーによって作成、管理されています。

AccountType

エンジン アカウントの種類として選択されます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BAIDU バイドゥ アカウント。
ENGINE_TRACK エンジントラッキングアカウントを使用します
FACEBOOK ログインします。
FACEBOOK_GATEWAY ゲートウェイ経由で管理されている Facebook アカウント。
GOOGLE_ADS Google 広告アカウント。
MICROSOFT Microsoft Advertising アカウント。
SEARCH_ADS_360 検索広告 360 のクライアント センター(MCC)アカウント。
YAHOO_JAPAN Yahoo! Japan アカウント。

DoubleClickCampaignManagerSetting

クライアント センター(MCC)の顧客用の DoubleClick Campaign Manager(DCM)の設定。

JSON 表現
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
フィールド
advertiserId

string (int64 format)

この顧客に関連付けられているキャンペーン マネージャー広告主の ID。

networkId

string (int64 format)

この顧客に関連付けられているキャンペーン マネージャー ネットワークの ID。

timeZone

string

この顧客に関連付けられている キャンペーン マネージャー ネットワークのタイムゾーン。America/New_York など、IANA タイムゾーン データベース形式で指定します。

AccountStatus

アカウントのステータス。

列挙型
UNSPECIFIED デフォルト値。
UNKNOWN 不明な値。
ENABLED アカウントで広告を配信できる。
PAUSED アカウントはユーザーによって無効にされています。
SUSPENDED アカウントは内部プロセスによって無効にされています。
REMOVED アカウントは元に戻せません。
DRAFT アカウントはまだ設定中です。まだ有効化されていません。

CustomerStatus

顧客のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED 広告を配信できる有効なアカウントを示します。
CANCELED 利用を停止したアカウントで広告を配信できないことを示します。管理者ユーザーが再度有効にできる。
SUSPENDED 強制停止中のアカウントで広告を配信できないことを示します。Google サポートのみが有効化できます。
CLOSED 広告を配信できない閉鎖されたアカウントであることを示します。テスト アカウントにも [CLOSED] ステータスが表示されます。ステータスは永続的であり、再開することはできません。

CustomerAsset

顧客とアセット間のリンク。

JSON 表現
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

顧客アセットのリソース名。CustomerAsset のリソース名は次の形式です。

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

必須。顧客に関連付けられているアセット。

status

enum (AssetLinkStatus)

顧客アセットのステータス。

CustomerAssetSet

CustomerAssetSet は、顧客とアセットセット間のリンクです。CustomerAssetSet を追加すると、アセットセットと顧客がリンクされます。

JSON 表現
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

顧客アセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

顧客に関連付けられているアセットセット。

customer

string

このアセットセットがリンクされている顧客。

status

enum (AssetSetLinkStatus)

顧客のアセットセットのアセットのステータスです。読み取り専用です。

AccessibleBiddingStrategy

顧客によって所有および共有されている入札戦略のビューを表します。

BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様のマネージャーが所有し、お客様と共有する戦略も含まれます。このリソースでは指標を提供せず、 BiddingStrategy の属性のごく一部のサブセットのみを公開しています。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
フィールド
resourceName

string

アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

入札戦略の ID。

name

string

入札戦略の名前。

type

enum (BiddingStrategyType)

入札戦略のタイプ。

ownerCustomerId

string (int64 format)

入札戦略を所有する顧客の ID。

ownerDescriptiveName

string

入札戦略を所有する顧客の名前。

共用体フィールド scheme。入札方式。

1 つのみ設定できます。scheme は次のいずれかになります。

maximizeConversionValue

object (MaximizeConversionValue)

予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。

maximizeConversions

object (MaximizeConversions)

予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。

targetCpa

object (TargetCpa)

指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。

targetImpressionShare

object (TargetImpressionShare)

選択した割合のインプレッションを重視して自動的に最適化する入札戦略です。

targetRoas

object (TargetRoas)

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる入札戦略。

targetSpend

object (TargetSpend)

予算内でクリック数を最大限に獲得できるように入札単価を設定する入札戦略。

MaximizeConversionValue

予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。

JSON 表現
{
  "targetRoas": number
}
フィールド
targetRoas

number

目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。

MaximizeConversions

予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。

JSON 表現
{
  "targetCpa": string,
  "targetCpaMicros": string
}
フィールド
targetCpa

string (int64 format)

目標コンバージョン単価(CPA)オプション。1 コンバージョンあたりにお支払いいただける平均金額です。

targetCpaMicros

string (int64 format)

目標コンバージョン単価(CPA)オプション。1 コンバージョンあたりにお支払いいただける平均金額です。

TargetCpa

指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "targetCpaMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。

TargetImpressionShare

一定の割合の検索広告が最初のページ(または他の対象地域)の上部に表示されるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
location

enum (TargetImpressionShareLocation)

検索結果ページの対象地域

locationFractionMicros

string (int64 format)

対象地域で表示する広告の割合(マイクロ単位)。たとえば、1% は 10,000 に相当します。

cpcBidCeilingMicros

string (int64 format)

自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。

TargetRoas

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる自動入札戦略です。

JSON 表現
{
  "targetRoas": number
}
フィールド
targetRoas

number

費用単位あたりの選択された収益(コンバージョン データに基づく)。

TargetSpend

予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略です。

JSON 表現
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
targetSpendMicros
(deprecated)

string (int64 format)

クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。

cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

ManagerLinkStatus

リンクのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVE 現在の効果のない関係を示します
INACTIVE 関係が終了していることを示します
PENDING 関係がマネージャーからリクエストされたものの、クライアントがまだ承認していないことを示します。
REFUSED マネージャーから関係がリクエストされましたが、クライアントは拒否しました。
CANCELED 取引関係がマネージャーからリクエストされたが、マネージャーが取引をキャンセルしたことを示します。

CustomerClient

特定の顧客とクライアントの顧客間のリンク。CustomerClient は、マネージャーの顧客に対してのみ存在します。直接クライアントと間接クライアントのすべての顧客と、MCC アカウントが含まれます。

JSON 表現
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
フィールド
resourceName

string

顧客クライアントのリソース名。CustomerClient リソース名の形式は customers/{customerId}/customerClients/{client_customer_id} です。

appliedLabels[]

string

リクエスト元のお客様が所有する、クライアントのお客様に適用されるラベルのリソース名。ラベルのリソース名の形式は次のとおりです。

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

クライアントのお客様のステータス。読み取り専用。

clientCustomer

string

特定の顧客に関連付けられている client-customer のリソース名。読み取り専用。

hidden

boolean

非表示のアカウントであるかどうかを指定します。

読み取り専用。

level

string (int64 format)

特定の顧客と顧客の距離。セルフリンクの場合、レベルの値は 0 になります。読み取り専用。

timeZone

string

クライアントのタイムゾーンを表す Common Locale Data Repository(CLDR)文字列表現(America/Los_Angeles など)。読み取り専用。

testAccount

boolean

クライアントがテスト アカウントであるかどうかを示します。読み取り専用。

manager

boolean

クライアントがマネージャーかどうかを示します。読み取り専用。

descriptiveName

string

クライアントのわかりやすい名前。読み取り専用。

currencyCode

string

クライアントの通貨コード(「USD」、「EUR」など)。読み取り専用。

id

string (int64 format)

クライアント顧客の ID。読み取り専用。

DynamicSearchAdsSearchTermView

動的検索広告の検索語句のビュー。

JSON 表現
{
  "resourceName": string,
  "landingPage": string
}
フィールド
resourceName

string

動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

インプレッションに対して動的に選択されるランディング ページ URL。

このフィールドは読み取り専用です。

GenderView

性別ビュー。genderView リソースは、追加された条件ではなく、有効な配信状態を反映します。性別に関する条件が設定されていない広告グループでは、デフォルトですべての性別に表示されるため、すべての性別が genderView に統計情報とともに表示されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

地域ターゲティングの定数。

JSON 表現
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
フィールド
resourceName

string

地域ターゲティングの定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

地域ターゲティングの定数ステータス。

id

string (int64 format)

地域ターゲティング定数の ID です。

name

string

地域ターゲティングの英語の定数名です。

countryCode

string

ターゲット地域に関連付けられる国コード(ISO-3166-1 alpha-2)です。

targetType

string

地域ターゲティングの定数ターゲット タイプです。

canonicalName

string

英語の完全修飾名。ターゲット地域の名前と、その親国と国の名前で構成されます。

parentGeoTarget

string

親の地域ターゲティング定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

地域ターゲティングの定数に設定されるステータスです。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。

ENABLED 地域ターゲティングの定数が有効である。
REMOVAL_PLANNED 地域ターゲティングの定数は廃止され、今後削除されます。

KeywordView

キーワード ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

キーワードビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

ラベル

ラベル。

JSON 表現
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
フィールド
resourceName

string

リソースの名前。ラベルのリソース名の形式は customers/{customerId}/labels/{label_id} のようになります。

status

enum (LabelStatus)

ラベルのステータス。読み取り専用。

textLabel

object (TextLabel)

色付きの背景にテキストを表示するラベルの一種。

id

string (int64 format)

ラベルの ID。読み取り専用。

name

string

ラベルの名前。

このフィールドは必須です。新しいラベルを作成する場合は空にしないでください。

この文字列の長さは 1~80 で指定します。

LabelStatus

ラベルのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED ラベルが有効になっています。
REMOVED ラベルが削除されます。

TextLabel

色付きの背景にテキストを表示するラベルの一種。

JSON 表現
{
  "backgroundColor": string,
  "description": string
}
フィールド
backgroundColor

string

ラベルの背景色(RGB 形式)。この文字列は、正規表現「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」と一致する必要があります。注: MCC アカウントでは、背景色が表示されない場合があります。

description

string

ラベルの簡単な説明。長さは 200 文字以下にする必要があります。

LanguageConstant

言語。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
フィールド
resourceName

string

言語定数のリソース名。言語定数のリソース名の形式は次のとおりです。

languageConstants/{criterionId}

id

string (int64 format)

言語定数の ID。

code

string

言語コード(「en_US」、「en_AU」、「es」、「fr」など)。

name

string

英語での完全な言語名(「英語(米国)」「スペイン語」など)。

targetable

boolean

言語をターゲットに設定できるかどうか。

LocationView

地域ビューでは、地域に関する条件別にキャンペーンのパフォーマンスの概要を確認できます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

ビジネス ビューのリソース名。ビジネス情報ビューのリソース名の形式は次のとおりです。

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

商品の入札カテゴリ。

JSON 表現
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
フィールド
resourceName

string

商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

商品入札カテゴリのレベル。

status

enum (ProductBiddingCategoryStatus)

商品入札カテゴリのステータス。

id

string (int64 format)

商品入札カテゴリの ID。

この ID は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。

countryCode

string

商品入札カテゴリの大文字 2 文字の国コード。

productBiddingCategoryConstantParent

string

親の商品入札カテゴリのリソース名。

languageCode

string

商品入札カテゴリの言語コード。

localizedName

string

languageCode に従ってローカライズされた商品入札カテゴリの値を表示します。

ProductBiddingCategoryLevel

商品入札カテゴリのレベルを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3
LEVEL4 レベル 4
LEVEL5 レベル 5

ProductBiddingCategoryStatus

商品入札カテゴリのステータスを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVE カテゴリは有効で、入札に使用できます。
OBSOLETE このカテゴリは古くなっています。レポート作成にのみ使用されます。

ProductGroupView

商品グループの表示。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

ショッピングのパフォーマンス ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報が表示されます。ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリなど、Merchant Center の商品ディメンションの値には、対応するイベントが記録されたときの各ディメンションの状態が反映されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

ショッピングのパフォーマンス ビューのリソース名。ショッピングのパフォーマンス ビューのリソース名の形式は customers/{customerId}/shoppingPerformanceView です。

UserList

ユーザーリスト。これは、お客様がターゲットに設定できるユーザーのリストです。

JSON 表現
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
フィールド
resourceName

string

ユーザーリストのリソース名。ユーザーリストのリソース名の形式は次のとおりです。

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

このリストのタイプ。

このフィールドは読み取り専用です。

id

string (int64 format)

ユーザーリストの ID。

name

string

このユーザー リストの名前。access_reason によっては、ユーザーリスト名が一意でないことがある(access_reason=SHARED の場合など)

UserListType

ユーザーリストの型を含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
REMARKETING コンバージョン タイプのコレクションとして表される UserList。
LOGICAL 他のユーザーリスト/インタレスト カテゴリの組み合わせとして表される UserList です。
EXTERNAL_REMARKETING Google アド マネージャー プラットフォームで作成されたユーザーリスト。
RULE_BASED ルールに関連付けられた UserList。
SIMILAR UserList には、別の UserList のユーザーと類似するユーザーを登録できます。
CRM_BASED 広告主様がメールやその他の形式で提供する自社 CRM データのユーザーリスト。

WebpageView

ウェブページ ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

ウェブページ ビューのリソース名。ウェブページ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

アクセス

訪問。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
フィールド
resourceName

string

訪問のリソース名。訪問のリソース名の形式は次のとおりです。

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

訪問の ID。

criterionId

string (int64 format)

Search Ads 360 キーワード ID。値 0 は、キーワードにアトリビューションがないことを示します。

merchantId

string (int64 format)

クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。

adId

string (int64 format)

広告 ID。値 0 は、広告が関連付けられていないことを示します。

clickId

string

クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。

visitDateTime

string

訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。

productId

string

クリックされた商品の ID。

productChannel

enum (ProductChannel)

クリックされた商品の販売チャネル: オンラインまたはローカル。

productLanguageCode

string

商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。

productStoreId

string

クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。

productCountryCode

string

クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。

assetId

string (int64 format)

訪問イベント中に操作されたアセットの ID。

assetFieldType

enum (AssetFieldType)

訪問イベントのアセット フィールド タイプ。

ProductChannel

商品の地域区分を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONLINE この商品はオンラインで販売されています。
LOCAL この商品は実店舗で販売されています。

コンバージョン

コンバージョン。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
フィールド
resourceName

string

コンバージョンのリソース名。コンバージョン リソース名の形式は次のとおりです。

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

コンバージョンの ID

criterionId

string (int64 format)

検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。

merchantId

string (int64 format)

クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。

adId

string (int64 format)

広告 ID。値 0 は、広告が関連付けられていないことを示します。

clickId

string

コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。

visitId

string (int64 format)

コンバージョンが結び付けられた検索広告 360 の訪問 ID。

advertiserConversionId

string

オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合、広告主の Floodlight 処理に応じて、id 列または floodlightOrderId 列と同じになります。

productId

string

クリックされた商品の ID。

productChannel

enum (ProductChannel)

クリックされた商品の販売チャネル: オンラインまたはローカル。

productLanguageCode

string

商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。

productStoreId

string

クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。

productCountryCode

string

クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。

attributionType

enum (AttributionType)

コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。

conversionDateTime

string

コンバージョン イベントのタイムスタンプ。

conversionLastModifiedDateTime

string

コンバージョンが最後に変更された時刻のタイムスタンプ。

conversionVisitDateTime

string

コンバージョンが関連付けられた訪問のタイムスタンプ。

conversionQuantity

string (int64 format)

コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ(コンバージョンで販売されたアイテム数など)を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。

conversionRevenueMicros

string (int64 format)

コンバージョン イベントの調整された収益(マイクロ秒単位)。これは常に広告配信中アカウントの通貨で表示されます。

floodlightOriginalRevenue

string (int64 format)

Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益(現在のレポートの通貨)。

floodlightOrderId

string

コンバージョンに関して広告主から提供された Floodlight オーダー ID。

status

enum (ConversionStatus)

コンバージョンのステータス(ENABLED または REMOVED)。

assetId

string (int64 format)

コンバージョン イベント中に操作されたアセットの ID。

assetFieldType

enum (AssetFieldType)

コンバージョン イベントのアセット フィールドのタイプ。

AttributionType

検索広告 360 のコンバージョン アトリビューション タイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
VISIT コンバージョンは訪問に関連付けられます。
CRITERION_AD コンバージョンは、条件と広告のペアに関連付けられます。

ConversionStatus

コンバージョンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED コンバージョンは有効です。
REMOVED コンバージョンが削除されました。

指標

指標データ。

JSON 表現
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
フィールド
allConversionsValueByConversionDate

number

すべてのコンバージョン値です。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。

allConversionsByConversionDate

number

コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。

conversionCustomMetrics[]

object (Value)

コンバージョンのカスタム指標。

conversionsValueByConversionDate

number

コンバージョンの日付ごとの、入札単価設定に使用されるコンバージョン値の合計。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

conversionsByConversionDate

number

入札対象のコンバージョンの種類のコンバージョン日別の合計コンバージョン数。アトリビューション モデリングにより、小数値になることがあります。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

historicalCreativeQualityScore

enum (QualityScoreBucket)

クリエイティブの過去の品質スコア。

historicalLandingPageQualityScore

enum (QualityScoreBucket)

過去のランディング ページの利便性の質。

historicalSearchPredictedCtr

enum (QualityScoreBucket)

過去の検索の予測クリック率(CTR)。

interactionEventTypes[]

enum (InteractionEventType)

支払い対象のインタラクションと無料インタラクションのタイプ。

rawEventConversionMetrics[]

object (Value)

未加工のイベント コンバージョン指標。

absoluteTopImpressionPercentage

number

「検索広告の最上部インプレッション シェア」とは、検索結果ページの最も目立つ位置に検索広告が表示されたインプレッションの割合です。

allConversionsFromInteractionsRate

number

インタラクションからのコンバージョンの数(ビュースルー コンバージョンとは逆)を、広告インタラクションの数で割った値です。

allConversionsValue

number

すべてのコンバージョン値。

allConversions

number

コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。

allConversionsValuePerCost

number

すべてのコンバージョンの値を、広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の合計費用で割った値です。

allConversionsFromClickToCall

number

ユーザーが広告のクリック中またはクリック後に [電話] ボタンをクリックして店舗に電話した回数です。この番号には、通話がつながったかどうかや通話時間は含まれません。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromDirections

number

ユーザーが広告をクリックした後に、[ルートを検索] ボタンをクリックして店舗への移動を行った回数。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromInteractionsValuePerInteraction

number

インタラクションによるすべてのコンバージョン値をインタラクションの合計数で割った値。

allConversionsFromMenu

number

ユーザーが広告をクリックした後に、店舗のメニューを表示するリンクをクリックした回数。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromOrder

number

ユーザーが広告をクリックした後に、店舗で注文を行った回数。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromOtherEngagement

number

ユーザーが広告をクリックした後に発生したコンバージョン(クチコミの投稿、店舗の場所の保存など)の件数です。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromStoreVisit

number

ユーザーが広告をクリックした後に、店舗を訪問したと推定される回数。

この指標はフィード アイテムにのみ適用されます。

visits

number

検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。

allConversionsFromStoreWebsite

number

ユーザーが広告をクリックした後に、ショップの URL にアクセスした回数。

この指標はフィード アイテムにのみ適用されます。

averageCost

number

インタラクション 1 回に対して支払う平均金額です。広告にかかった費用の合計を、インタラクション数の合計で割った値です。

averageCpc

number

すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

averageCpm

number

平均インプレッション単価(CPM)。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clicks

string (int64 format)

クリック数。

contentBudgetLostImpressionShare

number

予算が少なすぎるために、ディスプレイ ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: コンテンツ予算のインプレッション シェア損失率は 0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

contentImpressionShare

number

ディスプレイ ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: コンテンツのインプレッション シェアは 0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

contentRankLostImpressionShare

number

広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

conversionsFromInteractionsRate

number

入札対象のコンバージョンの平均(インタラクションから)です。広告インタラクションが入札単価設定に使用されるコンバージョンに、平均してどれくらいの頻度でつながっているかを確認できます。

clientAccountConversionsValue

number

クライアント アカウントのコンバージョン値。includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsValuePerCost

number

入札単価設定に使用されるコンバージョン値を、コンバージョンの対象となるインタラクションの合計費用で割った値。

conversionsFromInteractionsValuePerInteraction

number

インタラクションによるコンバージョン値を広告インタラクション数で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

clientAccountConversions

number

クライアント アカウントのコンバージョン数。includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costMicros

string (int64 format)

この期間のクリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

costPerAllConversions

number

広告インタラクションの費用をすべてのコンバージョンで割った値です。

costPerConversion

number

入札単価設定に使用されるコンバージョンあたりの平均有効費用。

costPerCurrentModelAttributedConversion

number

広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

crossDeviceConversions

number

ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、すべてのコンバージョンにすでに含まれています。

crossDeviceConversionsValue

number

クロスデバイス コンバージョンの合計値。

ctr

number

広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値。

conversions

number

コンバージョン数。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsValue

number

conversions フィールドに含まれるコンバージョンのコンバージョン値の合計。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。

historicalQualityScore

string (int64 format)

品質スコア(履歴)。

impressions

string (int64 format)

検索結果ページや Google ネットワークのウェブサイトに広告が表示された頻度。

interactionRate

number

広告が表示された後にその広告をユーザーが操作する頻度。これは、インタラクション数を広告が表示された回数で割った値です。

interactions

string (int64 format)

インタラクションの数。インタラクションとは、その広告フォーマットに関連付けられた主要なユーザー行動(テキスト広告やショッピング広告に対するクリック、動画広告の視聴など)を指します。

invalidClickRate

number

レポート対象期間中のクリック総数(フィルタ済みとフィルタなしのクリック数)のうち、除外されたクリックの割合。

invalidClicks

string (int64 format)

Google が不正と判断したクリックの数。料金は発生しません。

mobileFriendlyClicksPercentage

number

モバイル向けページに移動するモバイル クリックの割合。

searchAbsoluteTopImpressionShare

number

最も目立つ位置に表示されるお客様のショッピングまたは検索の広告のインプレッションの割合。詳しくは、https://support.google.com/sa360/answer/9566729 をご覧ください。0.1 未満の値はすべて 0.0999 として報告されます。

searchBudgetLostAbsoluteTopImpressionShare

number

予算の低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchBudgetLostImpressionShare

number

予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchBudgetLostTopImpressionShare

number

予算不足が原因で、広告が上位のオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索予算の検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchClickShare

number

検索ネットワークでのクリック数を、獲得可能だったと推定されるクリック数で割った値です。注: 検索クリック数シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchExactMatchImpressionShare

number

キーワードのマッチタイプにかかわらず、キーワードと完全に一致した(またはキーワードの類似パターンである)検索語句に対して、検索ネットワークで受け取ることが可能だったインプレッションの推定数でインプレッション数を割った値です。注: 検索の完全一致のインプレッション シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchImpressionShare

number

検索ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: 検索広告のインプレッション シェアは、0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchRankLostAbsoluteTopImpressionShare

number

広告ランクの低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索ランクの検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchRankLostImpressionShare

number

広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchRankLostTopImpressionShare

number

広告ランクの低さが原因で、広告がオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索ランクの検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchTopImpressionShare

number

上位の広告で獲得したインプレッション数を、上位広告の中で獲得可能だったと推定されるインプレッション数を基準として比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

通常、上位の広告は上位のオーガニック検索結果の上に表示されますが、特定の検索語句では上位のオーガニック検索結果の下に表示されることもあります。

topImpressionPercentage

number

上位のオーガニック検索結果の隣に表示された広告のインプレッションの割合です。

valuePerAllConversions

number

すべてのコンバージョンをすべてのコンバージョン数で割った値。

valuePerAllConversionsByConversionDate

number

すべてのコンバージョン値を総コンバージョン数で割った値です。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。

valuePerConversion

number

入札単価設定に使用されるコンバージョン値を、入札単価設定に使用されるコンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値が表示されます。

valuePerConversionsByConversionDate

number

コンバージョンの日付別の入札対象コンバージョン値を、コンバージョンの日付ごとの入札対象コンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値(コンバージョンの日付別)が表示されます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

clientAccountViewThroughConversions

string (int64 format)

ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像やリッチメディア広告を閲覧した後、別の広告を操作(クリックなど)することなく、サイトでコンバージョンに至ると発生します。

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

クライアント アカウントのクロスセルの売上原価(COGS)は、別の商品の広告を経由して購入された商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

crossSellCostOfGoodsSoldMicros

string (int64 format)

クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountCrossSellGrossProfitMicros

string (int64 format)

クライアント アカウントのクロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

crossSellGrossProfitMicros

string (int64 format)

クロスセルの総利益とは、ある商品が別の商品の広告によって販売につながった場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountCrossSellRevenueMicros

string (int64 format)

クライアント アカウントのクロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

crossSellRevenueMicros

string (int64 format)

クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountCrossSellUnitsSold

number

クライアント アカウントのクロスセルの販売数は、ある商品が別の商品の広告によって販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellUnitsSold

number

クロスセルの販売数は、別の商品の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

クライアント アカウントの主力商品の売上原価(COGS)とは、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

leadCostOfGoodsSoldMicros

string (int64 format)

主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountLeadGrossProfitMicros

string (int64 format)

クライアント アカウントの主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

leadGrossProfitMicros

string (int64 format)

主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountLeadRevenueMicros

string (int64 format)

クライアント アカウントの主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

leadRevenueMicros

string (int64 format)

主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clientAccountLeadUnitsSold

number

クライアント アカウントの主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

leadUnitsSold

number

主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

汎用的なデータコンテナ。

JSON 表現
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
フィールド
共用体フィールド value。値。value は次のいずれかになります。
booleanValue

boolean

ブール値。

int64Value

string (int64 format)

int64。

floatValue

number

浮動小数点数。

doubleValue

number

double。

stringValue

string

文字列。

QualityScoreBucket

品質スコアのバケットをリストした列挙型です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BELOW_AVERAGE クリエイティブの品質が平均を下回っています。
AVERAGE クリエイティブの品質は平均的です。
ABOVE_AVERAGE クリエイティブの品質が平均を上回っています。

InteractionEventType

支払い可能なインタラクションと無料のインタラクションの種類を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CLICK クリックしてサイトを表示ほとんどの場合、このインタラクションは外部の場所(通常は広告主のランディング ページ)に移動します。これは、クリック イベントのデフォルトの InteractionEventType でもあります。
ENGAGEMENT 所定の場所で広告を操作する意思をユーザーが表明したものです。
VIDEO_VIEW ユーザーが動画広告を視聴しました。
NONE 広告コンバージョン イベントのデフォルトの InteractionEventType。無料のインタラクション(広告コンバージョンなど)を「プロモート」し、主要指標の一部としてレポートすべきことが広告コンバージョンの行で示されていない場合に使用されます。これらは単に他の(広告)コンバージョンです。

セグメント

セグメント専用フィールド。

JSON 表現
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
フィールド
adNetworkType

enum (AdNetworkType)

広告ネットワークのタイプ。

conversionActionCategory

enum (ConversionActionCategory)

コンバージョン アクションのカテゴリ。

conversionCustomDimensions[]

object (Value)

コンバージョンのカスタム ディメンション。

dayOfWeek

enum (DayOfWeek)

曜日(例: MONDAY)。

device

enum (Device)

指標が適用されるデバイス。

keyword

object (Keyword)

キーワードの条件。

productChannel

enum (ProductChannel)

商品のチャネル。

productChannelExclusivity

enum (ProductChannelExclusivity)

商品のチャネル独占性。

productCondition

enum (ProductCondition)

商品の状態。

productSoldCondition

enum (ProductCondition)

販売された商品の状態。

rawEventConversionDimensions[]

object (Value)

未加工のイベント コンバージョン ディメンション。

conversionAction

string

コンバージョン アクションのリソース名。

conversionActionName

string

コンバージョン アクション名。

date

string

指標が適用される日付。yyyy-MM-dd 形式(例: 2018-04-17)。

month

string

月の初日の日付で表される月。形式は yyyy-MM-dd です。

productBiddingCategoryLevel1

string

商品の入札カテゴリ(レベル 1)。

productBiddingCategoryLevel2

string

商品の入札カテゴリ(レベル 2)。

productBiddingCategoryLevel3

string

商品の入札カテゴリ(レベル 3)。

productBiddingCategoryLevel4

string

商品の入札カテゴリ(レベル 4)。

productBiddingCategoryLevel5

string

商品の入札カテゴリ(レベル 5)。

productBrand

string

商品のブランド。

productCountry

string

商品の販売先の国の地域ターゲティング定数のリソース名。

productCustomAttribute0

string

商品のカスタム属性 0。

productCustomAttribute1

string

商品のカスタム属性 1。

productCustomAttribute2

string

商品のカスタム属性 2。

productCustomAttribute3

string

商品のカスタム属性 3。

productCustomAttribute4

string

商品のカスタム属性 4。

productItemId

string

商品の商品アイテム ID。

productLanguage

string

商品の言語の言語定数のリソース名。

productSoldBiddingCategoryLevel1

string

販売された商品の入札カテゴリ(レベル 1)。

productSoldBiddingCategoryLevel2

string

販売された商品の入札カテゴリ(レベル 2)。

productSoldBiddingCategoryLevel3

string

販売された商品の入札カテゴリ(レベル 3)。

productSoldBiddingCategoryLevel4

string

販売された商品の入札カテゴリ(レベル 4)。

productSoldBiddingCategoryLevel5

string

販売された商品の入札カテゴリ(レベル 5)。

productSoldBrand

string

販売した商品のブランド。

productSoldCustomAttribute0

string

販売された商品のカスタム属性 0。

productSoldCustomAttribute1

string

販売された商品のカスタム属性 1。

productSoldCustomAttribute2

string

販売された商品のカスタム属性 2。

productSoldCustomAttribute3

string

販売された商品のカスタム属性 3。

productSoldCustomAttribute4

string

販売された商品のカスタム属性 4。

productSoldItemId

string

販売した商品の商品アイテム ID。

productSoldTitle

string

販売した商品のタイトル。

productSoldTypeL1

string

販売した商品のタイプ(レベル 1)。

productSoldTypeL2

string

販売した商品のタイプ(レベル 2)。

productSoldTypeL3

string

販売した商品のタイプ(レベル 3)。

productSoldTypeL4

string

販売した商品のタイプ(レベル 4)。

productSoldTypeL5

string

販売した商品のタイプ(レベル 5)。

productStoreId

string

商品のストア ID。

productTitle

string

商品のタイトル。

productTypeL1

string

商品のタイプ(レベル 1)。

productTypeL2

string

商品のタイプ(レベル 2)。

productTypeL3

string

商品のタイプ(レベル 3)。

productTypeL4

string

商品のタイプ(レベル 4)。

productTypeL5

string

商品のタイプ(レベル 5)。

quarter

string

四半期の初日の日付で表される四半期。四半期に暦年を使用します。たとえば、2018 年の第 2 四半期は 2018-04-01 に始まります。形式は yyyy-MM-dd です。

week

string

月曜日から日曜日までとして定義される週。月曜日の日付で表されます。形式は yyyy-MM-dd です。

year

integer

年(yyyy 形式)。

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。インタラクション(クリックなど)は、広告が同時に配信されると、配信された広告のすべての要素(広告自体とサイトリンクなどのその他のコンポーネント)でカウントされます。interactionOnThisAsset が true の場合は、操作がこの特定のアセットで発生し、InteractionOnThisAsset が false の場合は、操作がこの特定のアセットではなく、このアセットとともに配信される広告の他の部分で発生しています。

AdNetworkType

Google 広告ネットワーク タイプを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
SEARCH Google 検索。
SEARCH_PARTNERS 検索パートナー
CONTENT ディスプレイ ネットワークです。
YOUTUBE_WATCH YouTube 動画
MIXED クロスネットワーク。

キーワード

キーワードの条件セグメントです。

JSON 表現
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
フィールド
info

object (KeywordInfo)

キーワード情報。

adGroupCriterion

string

AdGroupCriterion リソース名。

ProductChannelExclusivity

商品の在庫状況を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SINGLE_CHANNEL 商品アイテムは 1 つのチャネル(ProductChannel で指定された実店舗またはオンライン)でのみ販売されます。
MULTI_CHANNEL 商品アイテムが、対応するオンラインまたは実店舗と照合され、両方の ShoppingProductChannels で購入可能であることを示します。

ProductCondition

商品情報の状態を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
OLD 商品の状態が古い。
NEW 商品の状態が新品である。
REFURBISHED 商品の状態は再生品です。
USED 商品の状態が使用されます。

AssetInteractionTarget

AssetInteractionTarget セグメント。

JSON 表現
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
フィールド
asset

string

アセットのリソース名。

interactionOnThisAsset

boolean

CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。