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)

カスタム列。

広告グループ

広告グループ。

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

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

targetingSetting

object (TargetingSetting)

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

labels[]

string

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

engineId

string

外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、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 で選択した条件にのみ広告を表示するか、この targetDimension のすべての値をターゲットに設定し、他の TargetDimensions のターゲティングに基づいて広告を表示するかを指定します。値を true にした場合、これらの条件は入札単価調整比のみ適用され、ターゲティングには影響しないことを意味します。値を false にした場合、これらの条件によってターゲティングが制限され、入札単価調整比が適用されることになります。

TargetingDimension

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
KEYWORD キーワードの条件(「火星クルーズ」など)。キーワードは個別の入札単価ディメンションとして使用できます。キーワードは常にターゲティング ディメンションであるため、ターゲットを [すべて] に設定することはできません。TargetRestriction ディメンションがあります。
AUDIENCE ユーザーリスト、ユーザーの関心、カスタム アフィニティ、購買意向の強いカスタムなどのオーディエンス条件。
TOPIC コンテンツのカテゴリをターゲティングするためのトピック条件(「category::Animals>Pets」など)ディスプレイと動画のターゲティングに使用されます。
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 ファインド動画レスポンシブ広告です。
MULTIMEDIA_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

区切り文字でパス 1 に追加されるテキスト。

adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ResponsiveSearchAdInfo

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

JSON 表現
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
フィールド
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されると、このリストから広告見出しが選択されます。

descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信されると、このリストから説明文が選択されます。

path1

string

自動生成された表示 URL に付加される、区切り文字付きのテキスト。

path2

string

区切り文字でパス 1 に追加されるテキスト。

adTrackingId

string (int64 format)

広告のトラッキング ID。

AdTextAsset

広告内で使用されるテキスト アセット。

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

string

アセットのテキスト。

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 バイドゥ: クリエイティブは承認されませんでした。
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: モバイル 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! Japan、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 Baidu: モバイル 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 引数の web 条件は、比較対象のウェブ条件と等しくなります。
CONTAINS 引数 web 条件は、比較対象のウェブ条件の一部です。

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 画像/png の MIME タイプ。
FLASH application/x-shockwave-flash の MIME タイプ。
TEXT_HTML text/html の MIME タイプ。
PDF アプリケーション/PDF の MIME タイプ。
MSWORD アプリケーション/ミリ秒の MIME タイプ。
MSEXCEL application/vnd.ms-excel の MIME タイプ。
RTF application/rtf の MIME タイプ。
AUDIO_WAV Audio/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 は、曜日と広告が表示される期間として指定されます。

同じ日に追加できる AdSchedule は 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 は 1 日の終わりを表します。このフィールドは 0 ~ 24 の値にする必要があります。

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

MinuteOfHour

15 時間単位の列挙。例: 「FIFTEEN」

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

DayOfWeek

曜日を列挙します(例: "Monday")。

列挙型
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!Japan のみの項目が表示されます。

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

必須。モバイルアプリを一意に識別する文字列。「com.android.ebay」のようにプラットフォームのネイティブ ID のみを含めてください。Android または「12345689」追加できます

appStore

enum (MobileAppVendor)

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

MobileAppVendor

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

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

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 行動を促すフレーズのタイプは「今すぐ注文」です。
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 とアセットタイプごとに一意です。プレイス 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 アセットが長い広告見出しで使用されています(MultiAssetResponseAd で使用)。
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 入札戦略に適用し、その後で広告配信中アカウントと MCC アカウントのリンクを解除した場合です。この場合、アクセスできなくなったクライアント センター(MCC)入札戦略からキャンペーンが自動的に切り離され、無効な入札戦略タイプに移行します。
MANUAL_CPA 広告主が指定したアクションごとに入札単価を設定できる個別単価設定。
MANUAL_CPC クリックに基づく個別の入札単価。クリック 1 回ごとに支払います。
MANUAL_CPM インプレッションに基づく個別単価設定。1,000 回のインプレッションごとにユーザーが支払います。
MANUAL_CPV 動画の視聴 1 回あたりで設定可能な金額を支払う入札戦略。
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)を維持しながら収益を最大化できる自動入札戦略です。
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)オプション。コンバージョン アクション 1 回に対して支出する平均金額を、入札戦略の通貨のマイクロ単位で指定します。設定すると、目標コンバージョン単価以下で最大限のコンバージョンを獲得できます。目標コンバージョン単価が設定されていない場合、入札戦略は、予算内で可能な限り低いコンバージョン単価の達成を目指します。

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

AccessibleBidStrategy のリソース名です。「bidStrategy」で識別される、接続されているポートフォリオ入札戦略の無制限の属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は空になります。制限のない戦略属性は、戦略を共有しているすべてのお客様が利用でき、AccessibleBiddingStrategy リソースから読み取られます。これに対して、制限付きの属性は、戦略のオーナーである顧客とそのマネージャーのみが使用できます。制限付き属性は、BidStrategy リソースからのみ読み取ることができます。

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

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 で非推奨となります。代わりに createTime を使用してください。

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)

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

targetImpressionShare

object (TargetImpressionShare)

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

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

BiddingStrategy の考えられるシステム ステータスです。

列挙型
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 がない)または SSC のリマーケティング リストがありません。
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 P-MAX キャンペーンです
LOCAL_SERVICES ローカル サービス キャンペーン。
DISCOVERY ファインド キャンペーン
TRAVEL 旅行キャンペーン
SOCIAL ソーシャル キャンペーン。

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 動画アクション キャンペーン
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 旅行関連の目標達成のためのキャンペーンです
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook トラッキングはソーシャル キャンペーンのみです。

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 つの広告(または広告セット)をユーザーに表示する最大回数を指定するルール。

SelectiveOptimization

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

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)

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

enhancedCpcEnabled

boolean

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

TargetCpm

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

目標インプレッション単価(CPM)は自動入札戦略の一種で、設定した目標インプレッション単価で掲載結果が最適化されるように入札単価が設定されます。

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

FeedItem がターゲットに設定されている FeedItemSets です。複数の 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 では、「update」を使用して作成された場合にのみ primaryForGoal を false に設定可能オプションとして宣言されていないためです。

ownerCustomer

string

コンバージョン アクションのオーナーである顧客のリソース名。システム定義のコンバージョン アクションの場合は null。

includeInClientAccountConversionsMetric

boolean

このコンバージョン アクションを「clientAccountConversions」に含めるかどうか表示されます。

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 アクティビティ。販売 1 件あたりの合計金額も取得できます。読み取り専用。
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

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

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 「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)

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

お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。

conversionTrackingStatus

enum (ConversionTrackingStatus)

コンバージョン トラッキングのステータス。顧客がコンバージョン トラッキングを使用しているかどうか、またこの顧客のコンバージョン トラッキングの所有者は誰なのかが表示されます。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの login-customer-id によって異なります。

enhancedConversionsForLeadsEnabled

boolean

お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。

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 で指定された MCC アカウントによって作成、管理されます。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER コンバージョン アクションが、リクエストの login-customer-id で指定された顧客または管理者とは別の管理者が作成、管理している。

AccountType

考えられるエンジン アカウントの種類です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BAIDU Baidu アカウント。
ENGINE_TRACK エンジントラッキングアカウントです
FACEBOOK できます。
FACEBOOK_GATEWAY ゲートウェイ経由で管理される Facebook アカウント
GOOGLE_ADS Google 広告アカウント。
MICROSOFT Microsoft Advertising アカウント。
SEARCH_ADS_360 検索広告 360 のクライアント センター(MCC)アカウント。
YAHOO_JAPAN Yahoo Japan アカウント

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager(DCM)の設定です。

JSON 表現
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
フィールド
advertiserId

string (int64 format)

この顧客に関連付けられているキャンペーン マネージャー 広告主の ID。

networkId

string (int64 format)

この顧客に関連付けられているキャンペーン マネージャー ネットワークの ID。

timeZone

string

この顧客に関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン。IANA タイムゾーン データベース形式(America/New_York など)で指定します。

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

アクセス可能な入札戦略のリソース名。AccessibleBidStrategy リソース名の形式は次のとおりです。

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 は、マネージャーのお客様専用です。直接的および間接的なクライアントのすべての顧客と、マネージャー自体が含まれます。

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

特定の顧客にリンクされている顧客顧客のリソース名。読み取り専用。

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

ラベルの背景色(16 進数形式)。この文字列は、正規表現「^#([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}

アクセス

1 回の訪問です。

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,
  "averageQualityScore": 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

コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。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

コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。

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

すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

averageCpm

number

平均インプレッション単価(CPM)。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

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

インタラクションから発生したコンバージョン値を広告インタラクションの数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

clientAccountConversions

number

クライアント アカウントのコンバージョン数。これには、includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costMicros

string (int64 format)

指定の期間における、クリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

costPerAllConversions

number

広告インタラクションの費用をすべてのコンバージョンで割った値です。

costPerConversion

number

入札対象のコンバージョンあたりの平均コンバージョン対象費用。

costPerCurrentModelAttributedConversion

number

広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

crossDeviceConversions

number

ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、すでにすべてのコンバージョンに含まれています。

crossDeviceConversionsValue

number

クロスデバイス コンバージョンの合計値。

ctr

number

広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値です。

conversions

number

コンバージョン数です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsValue

number

conversions フィールドに含まれるコンバージョンのコンバージョン値の合計。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。

averageQualityScore

number

平均品質スコア。

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

予算の低さが原因で、広告が検索結果ページの上位の広告の 1 番目に入らなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、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

上位の広告の 1 つとして実際に獲得できたインプレッション数と、上位の広告として獲得可能だったインプレッション数の推定値を比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、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 ドルです。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

crossSellCostOfGoodsSoldMicros

string (int64 format)

クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この注文でのクロスセルの売上原価は 5 ドルです。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

clientAccountCrossSellGrossProfitMicros

string (int64 format)

クライアント アカウントのクロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

crossSellGrossProfitMicros

string (int64 format)

クロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

clientAccountCrossSellRevenueMicros

string (int64 format)

クライアント アカウントのクロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

crossSellRevenueMicros

string (int64 format)

クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

clientAccountCrossSellUnitsSold

number

クライアント アカウントのクロスセルの販売数は、ある商品が別の商品の広告から販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルされた商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツとジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellUnitsSold

number

クロスセルの販売数とは、ある商品が別の商品の広告から販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルされた商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツとジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

クライアント アカウントの主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

leadCostOfGoodsSoldMicros

string (int64 format)

主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

clientAccountLeadGrossProfitMicros

string (int64 format)

クライアント アカウントの主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品で得られた収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

leadGrossProfitMicros

string (int64 format)

主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品で得られた収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

clientAccountLeadRevenueMicros

string (int64 format)

クライアント アカウントの主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

leadRevenueMicros

string (int64 format)

主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

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,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "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)。

geoTargetCity

string

都市を表す地域ターゲティング定数のリソース名。

geoTargetCountry

string

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

geoTargetMetro

string

大都市圏を表す地域ターゲティング定数のリソース名。

geoTargetRegion

string

リージョンを表す地域ターゲティング定数のリソース名。

hour

integer

時間帯(0 ~ 23 の数値)。

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 年 4 月 1 日から始まります。形式は 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 の指標でのみ使用。インタラクションの指標が、アセット自体で発生したのか、別のアセットや広告ユニットで発生したのかを示します。