REST Resource: accounts.conversionSources

リソース: ConversionSource

販売者のアカウントが所有するコンバージョン ソースを表します。販売者のアカウントには、最大 200 個のコンバージョン ソースを設定できます。

JSON 表現 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
フィールド
name

string

出力専用。ID。新しい ConversionSource の作成時に Content API によって生成されます。形式: [a-z]{4}:.+ コロンの前の 4 文字は、コンバージョン ソースのタイプを表します。コロンの後のコンテンツは、そのタイプのコンバージョン ソースの ID を表します。2 つの異なるコンバージョン ソースの ID が、コンバージョン タイプが異なる場合でも同じになることがあります。サポートされているタイプ接頭辞は次のとおりです。- galk: GoogleAnalyticsLink ソース用。- mcdn: MerchantCenterDestination ソースの場合。
state

enum (State)

出力専用。このコンバージョン ソースの現在の状態。API では編集できません。
expireTime

string (Timestamp format)

出力専用。アーカイブされたコンバージョン ソースが完全に削除され、復元できなくなるまでの時間。
controller

enum (Controller)

出力専用。コンバージョンの発生元のコントローラ。
共用体フィールド source_data。必須。ソースの種類ごとに固有のコンバージョン ソース データ。source_data は次のいずれかになります。
merchantCenterDestination

object (MerchantCenterDestination)

コンバージョンの発生元が「Merchant Center タグのデスティネーション」タイプである。

AttributionSettings

アトリビューション前のデータを受信するコンバージョン ソースのアトリビューション設定を表します。

JSON 表現 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
フィールド
attributionLookbackWindowDays

integer

必須。このソースのアトリビューションに使用されるルックバック ウィンドウ（日数）。サポートされている値は 7、30、40 です。
attributionModel

enum (AttributionModel)

必須。アトリビューション モデル。
conversionType[]

object (ConversionType)

変更不可。順序なしリスト。コンバージョン イベントを分類できるコンバージョンの種類のリスト。作成時にこのリストが空の場合、標準の「購入」タイプが自動的に作成されます。

AttributionModel

このソースで使用されているアトリビューション モデル。https://support.google.com/analytics/answer/10596866 に記載されているとおり、Google アナリティクス 4 で提供されているモデルと同じセットがサポートされています。

列挙型
ATTRIBUTION_MODEL_UNSPECIFIED モデルが指定されていません。
CROSS_CHANNEL_LAST_CLICK クロスチャネルのラストクリック モデル。
ADS_PREFERRED_LAST_CLICK Google 広告優先ラストクリック モデル。
CROSS_CHANNEL_DATA_DRIVEN クロスチャネル データドリブン モデル。
CROSS_CHANNEL_FIRST_CLICK クロスチャネル ファースト クリック モデル。
CROSS_CHANNEL_LINEAR クロスチャネル線形モデル。
CROSS_CHANNEL_POSITION_BASED クロスチャネル接点ベースモデル。
CROSS_CHANNEL_TIME_DECAY クロスチャネル減衰モデル。

ConversionType

コンバージョン イベントの種類を表すメッセージ

JSON 表現 
{
  "name": string,
  "report": boolean
}
フィールド
name

string

出力専用。コンバージョン イベント名（クライアントから報告される名前）。
report

boolean

出力専用。タイプを Merchant Center レポートに含めるかどうかを示すオプション。

MerchantCenterDestination

「Merchant Center のリンク先」の参照元を使用すると、Google タグを使用してオンライン ショップからコンバージョン イベントを、参照元が作成された Merchant Center アカウントに直接送信できます。

JSON 表現 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
フィールド
destination

string

出力専用。Merchant Center のリンク先 ID。
attributionSettings

object (AttributionSettings)

必須。Merchant Center のリンク先で使用されているアトリビューション設定。
displayName

string

必須。販売者が指定した、リンク先の表示名。これは、Merchant Center の UI 内でコンバージョンの発生元を識別するための名前です。64 文字以内で指定します。
currencyCode

string

必須。3 文字の通貨コード（ISO 4217）。通貨コードは、このリンク先に送信されたコンバージョンが Merchant Center でどの通貨でレポートされるかを定義します。

州

コンバージョン ソースの状態を表します。

列挙型
STATE_UNSPECIFIED コンバージョン ソースの状態が指定されていません。
ACTIVE コンバージョン ソースが完全に機能している。
ARCHIVED コンバージョン ソースは過去 30 日間にアーカイブされており、現在は機能していません。削除解除メソッドを使用して復元できます。
PENDING コンバージョン ソースの作成は開始されていますが、まだ完全に完了していません。

コントローラ

コンバージョンの発生元を制御するエンティティ。

列挙型
CONTROLLER_UNSPECIFIED デフォルト値。この値は使用されません。
MERCHANT コンバージョンの発生元を所有する販売者が管理します。
YOUTUBE_AFFILIATES YouTube アフィリエイト プログラムによって管理されます。

メソッド

create

 新しいコンバージョン ソースを作成します。

delete

 既存のコンバージョン ソースをアーカイブします。

get

 コンバージョンの発生元を取得します。

list

 呼び出し元がアクセスできるコンバージョン ソースのリストを取得します。

patch

 既存のコンバージョン ソースの情報を更新します。

undelete

 アーカイブしたコンバージョンの発生元を再度有効にします。