従来版の Search Ads 360 Reporting API は、2024 年 6 月 30 日に廃止され、廃止されます。なお、Search Ads 360 Conversion API は影響を受けず、引き続きサポートされます。新しいレポートの作成には、必ず新しい Search Ads 360 Reporting API を使用してください。

2024 年 4 月以降、レポートをリクエストすると、unsupportedApiVersion エラーが返されます。詳しくはこちらをご覧ください。

また、既存の検索広告 360 の実装を新しい API に移行することを強くおすすめします。詳しくは、新しい Search Ads 360 Reporting API のスタートガイドと移行ガイドをご覧ください。

このページは Cloud Translation API によって翻訳されました。

Conversion

コンバージョンリソースには、ユーザーが Floodlight コンバージョンを一括作成、変更、取得するためのメソッドが用意されています。

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表記

コンバージョンのリスト。

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

プロパティ名	値	説明	メモ
`conversion[]`	`list`	リクエストされているコンバージョン。
`conversion[].adGroupId`	`long`	DS 広告グループ ID。
`conversion[].adId`	`long`	DS の広告 ID。
`conversion[].adUserDataConsent`	`string`	設定でコアサービス（CPS）の設定に同意することを表明します。デフォルト値はありません。使用できる値は次のとおりです。GRANTED: 「許可」の同意ステータスを指定します。GTE 設定から CPS 設定を読み取ります。DENIED: 希望する同意ステータスは拒否です。CPS リストは空です。
`conversion[].advertiserId`	`long`	DS 広告主 ID。
`conversion[].agencyId`	`long`	DS 代理店 ID。
`conversion[].attributionModel`	`string`	DoubleClick Search カスタマーサポートへのお問い合わせ後に広告主様のみご利用いただけます。
`conversion[].campaignId`	`long`	DS キャンペーン ID。
`conversion[].channel`	`string`	商品の販売チャネル。指定できる値は次のとおりです。「`local`」: 実店舗「`online`」: オンラインショップ
`conversion[].clickId`	`string`	コンバージョンの DS クリック ID。
`conversion[].conversionId`	`string`	オフラインコンバージョンの場合は、広告主がこの ID を指定します。広告主は、自分にとってわかりやすい任意の ID を指定できます。リクエスト内の各コンバージョンには一意の ID を指定する必要があります。ID とタイムスタンプの組み合わせは、その広告主のすべてのコンバージョンの中で一意である必要があります。オンラインコンバージョンの場合は、広告主の Floodlight 処理に応じて、`dsConversionId` または `floodlightOrderId` がこのプロパティにコピーされます。
`conversion[].conversionModifiedTimestamp`	`unsigned long`	コンバージョンが最後に変更された時刻（エポックミリ UTC）。
`conversion[].conversionTimestamp`	`unsigned long`	コンバージョンが発生した時刻（エポックミリ UTC）。
`conversion[].countMillis`	`long`	DoubleClick Search カスタマーサポートへのお問い合わせ後に広告主様のみご利用いただけます。
`conversion[].criterionId`	`long`	DS 条件（キーワード）ID。
`conversion[].currencyCode`	`string`	コンバージョンの収益の通貨コード。ISO 4217 英字（3 文字）形式で指定してください。	書き込み可能
`conversion[].customDimension[]`	`list`	コンバージョンのカスタムディメンション。レポート内のデータのフィルタリングに使用できます。
`conversion[].customDimension[].name`	`string`	カスタムディメンション名。
`conversion[].customDimension[].value`	`string`	カスタムディメンションの値。
`conversion[].customMetric[]`	`list`	コンバージョンのカスタム指標。
`conversion[].customMetric[].name`	`string`	カスタム指標の名前。
`conversion[].customMetric[].value`	`double`	カスタム指標の数値。
`conversion[].customerId`	`string`	検索広告 360 リニューアル版のお客様 ID。クライアントアカウントである必要があります。このフィールドを設定した場合、他のすべての ID フィールドは検索広告 360 リニューアル版の ID に設定する必要があります。
`conversion[].deviceType`	`string`	コンバージョンが発生したデバイスのタイプ。有効な値は次のとおりです。 "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	DoubleClick Search が各コンバージョンに対して生成する ID。
`conversion[].engineAccountId`	`long`	DS エンジンアカウント ID。
`conversion[].floodlightOrderId`	`string`	コンバージョンに関して広告主から提供された Floodlight オーダー ID。
`conversion[].inventoryAccountId`	`long`	この ID は、商品が含まれる在庫アカウントを一意に識別するために生成され、使用されます。
`conversion[].productCountry`	`string`	商品を含む Merchant Center フィードに登録されている国。国の指定には ISO 3166 コードを使用します。
`conversion[].productGroupId`	`long`	DS 商品グループ ID。
`conversion[].productId`	`string`	商品 ID（SKU）。
`conversion[].productLanguage`	`string`	商品が含まれる Merchant Center フィードに登録されている言語。ISO 639 コードを使用して言語を指定します。
`conversion[].quantityMillis`	`long`	このコンバージョンの量（ミリ単位）。	書き込み可能
`conversion[].revenueMicros`	`long`	この `TRANSACTION` コンバージョンの収益額（マイクロ単位）（値に 1000000 を掛けた値、小数なし）。たとえば、収益の値を「10」に指定するには、リクエストに「10000000」（1, 000 万）と入力します。	書き込み可能
`conversion[].segmentationId`	`long`	数値のセグメンテーション識別子（例: DoubleClick Search Floodlight アクティビティ ID）。
`conversion[].segmentationName`	`string`	わかりやすいセグメント識別子（例: DoubleClick Search の Floodlight アクティビティ名）。
`conversion[].segmentationType`	`string`	このコンバージョンのセグメンテーションタイプ（例: `FLOODLIGHT`）。有効な値は次のとおりです。 "`FLOODLIGHT`"
`conversion[].state`	`string`	コンバージョンの状態（`ACTIVE` または `REMOVED`）。注: DELETED は非推奨となりました。有効な値は次のとおりです。 "`ACTIVE`" "`DELETED`": （サポート終了） "`REMOVED`"	書き込み可能
`conversion[].storeId`	`string`	商品を宣伝した実店舗の ID。チャンネルが「`local`」の場合にのみ適用されます。
`conversion[].type`	`string`	コンバージョンのタイプ（`ACTION` または `TRANSACTION`）。「`ACTION`」コンバージョンは、ユーザーが行った、金銭的な数値化可能な値を持たないアクションを指します。「`TRANSACTION`」のコンバージョンは、ユーザーによる、金銭的な数値化可能な値を持つアクションを指します。たとえば、メーリングリストの登録（`ACTION`）や e コマースでの購入（`TRANSACTION`）などが該当します。有効な値は次のとおりです。 "`ACTION`" "`TRANSACTION`"
`kind`	`string`	これが ConversionList リソースであることを示します。値: 固定文字列 `doubleclicksearch#conversionList`。

Methods

get: DoubleClick Search エンジンアカウントからコンバージョンのリストを取得します。
getByCustomerId: 検索広告 360 リニューアル版のお客様 ID を使用して、DoubleClick Search エンジンアカウントからコンバージョンのリストを取得します。
insert: 新しいコンバージョンのバッチを DoubleClick Search に挿入します。
update: DoubleClick Search で一連のコンバージョンを更新します。
updateAvailability: DoubleClick Search で一連の Floodlight アクティビティが利用可能かどうかを更新します。