/
UploadOfflineConversion.cs
127 lines (113 loc) · 5.52 KB
/
UploadOfflineConversion.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V6.Errors;
using Google.Ads.GoogleAds.V6.Services;
using System;
namespace Google.Ads.GoogleAds.Examples.V6
{
/// <summary>
/// This code example imports offline conversion values for specific clicks to your account.
/// To get Google Click ID for a click, use the "click_view" resource:
/// https://developers.google.com/google-ads/api/fields/latest/click_view.
/// To set up a conversion action, run the AddConversionAction.cs example.
/// </summary>
public class UploadOfflineConversion : ExampleBase
{
/// <summary>
/// Main method, to run this code example as a standalone application.
/// </summary>
/// <param name="args">The command line arguments.</param>
public static void Main(string[] args)
{
UploadOfflineConversion codeExample = new UploadOfflineConversion();
Console.WriteLine(codeExample.Description);
// The Google Ads customer ID for which the call is made.
long customerId = long.Parse("INSERT_CUSTOMER_ID_HERE");
// The conversion action ID.
long conversionActionId = long.Parse("INSERT_CONVERSION_ACTION_ID_HERE");
// The Google Click ID for which conversions are uploaded.
string gclid = "INSERT_GCLID_HERE";
// The conversion time in "yyyy-mm-dd hh:mm:ss+|-hh:mm" format.
string conversionTime = "INSERT_CONVERSION_TIME_HERE";
// The conversion value.
double conversionValue = double.Parse("CONVERSION_VALUE");
codeExample.Run(new GoogleAdsClient(), customerId, conversionActionId, gclid,
conversionTime, conversionValue);
}
/// <summary>
/// Returns a description about the code example.
/// </summary>
public override string Description =>
"This code example imports offline conversion values for specific clicks to your " +
"account. To get Google Click ID for a click, use the 'click_view' resource: " +
"https://developers.google.com/google-ads/api/fields/latest/click_view. To set up a " +
"conversion action, run the AddConversionAction.cs example.";
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for the conversion action is
/// added.</param>
/// <param name="conversionActionId">The conversion action ID.</param>
/// <param name="conversionTime">The conversion time.</param>
/// <param name="gclid">The click ID.</param>
/// <param name="conversionValue">The convsersion value.</param>
// [START UploadOfflineConversion]
public void Run(GoogleAdsClient client, long customerId, long conversionActionId,
string gclid, string conversionTime, double conversionValue)
{
// Get the ConversionActionService.
ConversionUploadServiceClient conversionUploadService =
client.GetService(Services.V6.ConversionUploadService);
// Creates a click conversion by specifying currency as USD.
ClickConversion clickConversion = new ClickConversion()
{
ConversionAction = ResourceNames.ConversionAction(customerId, conversionActionId),
Gclid = gclid,
ConversionValue = conversionValue,
ConversionDateTime = conversionTime,
CurrencyCode = "USD"
};
try
{
// Issues a request to upload the click conversion.
UploadClickConversionsResponse response =
conversionUploadService.UploadClickConversions(
new UploadClickConversionsRequest()
{
CustomerId = customerId.ToString(),
Conversions = { clickConversion },
PartialFailure = true,
ValidateOnly = false
});
// Prints the result.
ClickConversionResult uploadedClickConversion = response.Results[0];
Console.WriteLine($"Uploaded conversion that occurred at " +
$"'{uploadedClickConversion.ConversionDateTime}' from Google " +
$"Click ID '{uploadedClickConversion.Gclid}' to " +
$"'{uploadedClickConversion.ConversionAction}'.");
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
// [END UploadOfflineConversion]
}
}