Conversions

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

リソース表現

コンバージョンは、ユーザーが広告を閲覧した後、期待されるアクションを正常に実行した時点を表します。

{
  "kind": "dfareporting#conversion",
  "floodlightConfigurationId": long,
  "floodlightActivityId": long,
  "encryptedUserId": string,
  "encryptedUserIdCandidates": [
    string
  ],
  "matchId": string,
  "mobileDeviceId": string,
  "gclid": string,
  "dclid": string,
  "limitAdTracking": boolean,
  "childDirectedTreatment": boolean,
  "nonPersonalizedAd": boolean,
  "treatmentForUnderage": boolean,
  "timestampMicros": long,
  "value": double,
  "quantity": long,
  "ordinal": string,
  "customVariables": [
    {
      "kind": "dfareporting#customFloodlightVariable",
      "type": string,
      "value": string
    }
  ]
}
プロパティ名 説明 メモ
childDirectedTreatment boolean このリクエストが 13 歳未満のユーザーから送信された可能性があるかどうか。COPPA を遵守するためのフィールドです。
customVariables[] list カスタム Floodlight 変数。
customVariables[].kind string リソースの種類を識別します。値: 固定文字列 "dfareporting#customFloodlightVariable"
customVariables[].type string 値を指定するカスタム Floodlight 変数のタイプ。タグ内の「u[1-20]=」にマッピングされます。

設定可能な値は次のとおりです。
  • "U1"
  • "U10"
  • "U100"
  • "U11"
  • "U12"
  • "U13"
  • "U14"
  • "U15"
  • "U16"
  • "U17"
  • "U18"
  • "U19"
  • "U2"
  • "U20"
  • "U21"
  • "U22"
  • "U23"
  • "U24"
  • "U25"
  • "U26"
  • "U27"
  • "U28"
  • "U29"
  • "U3"
  • "U30"
  • "U31"
  • "U32"
  • "U33"
  • "U34"
  • "U35"
  • "U36"
  • "U37"
  • "U38"
  • "U39"
  • "U4"
  • "U40"
  • "U41"
  • "U42"
  • "U43"
  • "U44"
  • "U45"
  • "U46"
  • "U47"
  • "U48"
  • "U49"
  • "U5"
  • "U50"
  • "U51"
  • "U52"
  • "U53"
  • "U54"
  • "U55"
  • "U56"
  • "U57"
  • "U58"
  • "U59"
  • "U6"
  • "U60"
  • "U61"
  • "U62"
  • "U63"
  • "U64"
  • "U65"
  • "U66"
  • "U67"
  • "U68"
  • "U69"
  • "U7"
  • "U70"
  • "U71"
  • "U72"
  • "U73"
  • "U74"
  • "U75"
  • "U76"
  • "U77"
  • "U78"
  • "U79"
  • "U8"
  • "U80"
  • "U81"
  • "U82"
  • "U83"
  • "U84"
  • "U85"
  • "U86"
  • "U87"
  • "U88"
  • "U89"
  • "U9"
  • "U90"
  • "U91"
  • "U92"
  • "U93"
  • "U94"
  • "U95"
  • "U96"
  • "U97"
  • "U98"
  • "U99"
customVariables[].value string カスタム Floodlight 変数の値。半角 50 文字以内の文字列を指定する必要があります。
dclid string ディスプレイ広告のクリック ID。encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIdgclid とは併用できません。このフィールドと encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIdgclid は、必須のフィールドです。
encryptedUserId string 暗号化された英数字のユーザー ID。このフィールドを設定する場合、encryptionInfo も指定する必要があります。encryptedUserIdCandidates[]matchIdmobileDeviceIdgcliddclid とは併用できません。このフィールドと encryptedUserIdCandidates[]matchIdmobileDeviceIdgcliddclid は、必須のフィールドです。
encryptedUserIdCandidates[] list 暗号化された英数字のユーザー ID のリスト。挿入されるコンバージョンで、露出がコンバージョンのタイムスタンプより前に発生したすべてのユーザー ID が使用されます。該当するユーザー ID が見つからない場合、コンバージョンは INVALID_ARGUMENT エラーにより拒否されます。このフィールドを設定する場合、encryptionInfo も指定する必要があります。このフィールドは、batchinsert を呼び出すときにのみ使用できます。batchupdate ではサポートされません。encryptedUserIdmatchIdmobileDeviceIdgcliddclid とは併用できません。このフィールドと encryptedUserIdmatchIdmobileDeviceIdgcliddclid は、必須のフィールドです。
floodlightActivityId long このコンバージョンの Floodlight アクティビティ ID。必須フィールドです。
floodlightConfigurationId long このコンバージョンの Floodlight 設定 ID。必須フィールドです。
gclid string Google クリック ID。encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIddclid とは併用できません。このフィールドと encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIddclid は、必須のフィールドです。
kind string リソースの種類を識別します。値: 固定文字列 "dfareporting#conversion"
limitAdTracking boolean 広告トラッキング制限を有効にするかどうか。true に設定した場合、このコンバージョンはレポート作成に使用されますが、ターゲティングには使用されません。これにより、リマーケティングが行われなくなります。
matchId string マッチ ID フィールド。マッチ ID は、Floodlight のマッチ ID 機能を使用して Google と同期した独自の自社 ID です。encryptedUserIdencryptedUserIdCandidates[]mobileDeviceIdgcliddclid とは併用できません。このフィールドと encryptedUserIdencryptedUserIdCandidates[]mobileDeviceIdgcliddclid は、必須のフィールドです。
mobileDeviceId string モバイル デバイス ID。encryptedUserIdencryptedUserIdCandidates[]matchIdgcliddclid とは併用できません。このフィールドと encryptedUserIdencryptedUserIdCandidates[]matchIdgcliddclid は、必須のフィールドです。
nonPersonalizedAd boolean コンバージョンがパーソナライズされていない広告用であったかどうか。
ordinal string コンバージョンの序数。このフィールドは、同一日に同一ユーザーによる複数コンバージョンが発生している場合の処理方法を指定するために使用されます。必須フィールドです。
quantity long コンバージョンの数量。
timestampMicros long コンバージョンのタイムスタンプ(Unix エポックからのマイクロ秒単位の経過時間)。必須フィールドです。
treatmentForUnderage boolean このリクエストが 16 歳未満のユーザーから送信された可能性があるかどうか(対象年齢は国によって異なります)。EU の一般データ保護規則(GDPR)を遵守するためのフィールドです。
value double コンバージョンの価値。

メソッド

batchinsert
コンバージョンを挿入します。
batchupdate
既存のコンバージョンを更新します。