REST Resource: accounts.conversionSources

リソース: ConversionSource

販売アカウントが所有するコンバージョンの発生元を表します。1 つの販売アカウントに設定できるコンバージョンの発生元は最大 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

このソースで使用されているアトリビューション モデル。Google は、Google アナリティクス 4 で提供されているものと同じモデルセットをサポートしています(https://support.google.com/analytics/answer/10596866 を参照)。

列挙型
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

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