指定された通話コンバージョンを処理します。
スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP リクエスト
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
必須。アップロードを行った顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"conversions": [
{
object ( |
フィールド | |
---|---|
conversions[] |
必須。アップロード中のコンバージョン。 |
partialFailure |
必須。true の場合、成功したオペレーションが実行され、無効なオペレーションはエラーを返します。false の場合、すべての操作が有効である場合にのみ、すべての操作が 1 つのトランザクションで実行されます。常に true に設定する必要があります。部分的エラーについて詳しくは、https://developers.google.com/google-ads/api/docs/best-practices/partial-failures をご覧ください。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。 |
レスポンスの本文
ConversionUploadService.UploadCallConversions
に対するレスポンス メッセージです。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "partialFailureError": { object ( |
フィールド | |
---|---|
partialFailureError |
部分的障害モードの変換の失敗に関連するエラー。コンバージョン内ですべてのエラーが発生した場合に返されます。変換以外で発生したエラー(認証エラーなど)は、RPC レベルのエラーを返します。部分的エラーについて詳しくは、https://developers.google.com/google-ads/api/docs/best-practices/partial-failures をご覧ください。 |
results[] |
正常に処理されたコンバージョンに対して返されます。エラーが発生した行の Proto は空になります。validateOnly が true の場合、結果は返されません。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。
CallConversion
通話コンバージョン。
JSON 表現 |
---|
{ "customVariables": [ { object ( |
フィールド | |
---|---|
customVariables[] |
このコンバージョンに関連付けられているカスタム変数。 |
consent |
イベントの同意設定。 |
callerId |
この通話の発信者番号。発信者番号は E.164 形式で、先頭に「+」記号を付ける必要があります(例: 「+16502531234」)。 |
callStartDateTime |
通話が発生した日時。タイムゾーンを指定してください。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です(例: 2019-01-01 12:32:45-08:00)。 |
conversionAction |
このコンバージョンに関連付けられたコンバージョン アクションのリソース名。注: このリソース名には顧客 ID とコンバージョン アクション ID が含まれますが、検証ではお客様 ID は無視され、コンバージョン アクションの識別子としてコンバージョン アクション ID が使用されます。 |
conversionDateTime |
コンバージョンが発生した日時。通話時刻より後である必要があります。タイムゾーンを指定してください。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です(例: 2019-01-01 12:32:45-08:00)。 |
conversionValue |
広告主にとってのコンバージョンの価値。 |
currencyCode |
コンバージョン値に関連付けられている通貨。3 文字の ISO 4217 通貨コードを指定します。例: USD、EUR。 |
CallConversionResult
正常に処理された CallConversionUpload の情報を識別します。
JSON 表現 |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
フィールド | |
---|---|
callerId |
この通話の発信者番号。発信者番号は E.164 形式で、先頭に「+」記号を付ける必要があります。 |
callStartDateTime |
通話が発生した日時。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です(例: 2019-01-01 12:32:45-08:00)。 |
conversionAction |
このコンバージョンに関連付けられたコンバージョン アクションのリソース名。 |
conversionDateTime |
コンバージョンが発生した日時。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です(例: 2019-01-01 12:32:45-08:00)。 |