Eksperimen adalah antarmuka untuk mengelola kampanye eksperimental yang terkait dengan kampanye dasar. Kampanye eksperimen adalah kampanye lengkap yang dapat menayangkan iklan dan menghasilkan klik, biaya, serta metrik lainnya.
Langkah pertama dalam menjalankan eksperimen menggunakan Google Ads API adalah membuat Experiment
. Resource ini menentukan beberapa informasi kunci
tentang eksperimen yang ingin Anda jalankan, seperti nama dan jenis
eksperimen. Anda tidak menentukan kampanye yang terlibat dalam eksperimen pada langkah ini.
Berikut adalah ringkasan beberapa kolom utama untuk Experiment
:
name
: Setiap eksperimen harus memiliki nama yang unik.description
: Kolom opsional yang dapat Anda gunakan untuk direferensikan di lain waktu. Tidak memengaruhi cara eksperimen berjalan.suffix
: Akhiran akan ditambahkan ke bagian akhir nama kampanye perlakuan sehingga Anda dapat membedakannya dari kampanye kontrol. Konsep ini akan dijelaskan lebih lanjut di halaman grup eksperimen.type
: Jenis eksperimen yang akan dijalankan. Ada banyak jenis di sini, tetapi kebanyakan dari mereka adalah eksperimen sistem. Untuk eksperimen kustom, Anda dapat menentukanSEARCH_CUSTOM
atauDISPLAY_CUSTOM
.status
: Saat membuat eksperimen, tetapkan kolom ini keSETUP
. Kemudian, setelah Anda memulai eksperimen, kolom ini akan memungkinkan Anda memeriksa apa yang saat ini dilakukanstart_date
danend_date
: Menentukan kapan eksperimen harus dimulai dan berakhir.sync_enabled
: Dinonaktifkan secara default. Jika ditetapkan ketrue
, perubahan yang dibuat pada kampanye asli saat eksperimen Anda berjalan akan otomatis disalin ke kampanye eksperimen. Pelajari lebih lanjut.
Berikut adalah contoh pembuatan eksperimen:
Java
private String createExperimentResource(GoogleAdsClient googleAdsClient, long customerId) { ExperimentOperation operation = ExperimentOperation.newBuilder() .setCreate( Experiment.newBuilder() // Name must be unique. .setName("Example Experiment #" + getPrintableDateTime()) .setType(ExperimentType.SEARCH_CUSTOM) .setSuffix("[experiment]") .setStatus(ExperimentStatus.SETUP) .build()) .build(); try (ExperimentServiceClient experimentServiceClient = googleAdsClient.getLatestVersion().createExperimentServiceClient()) { MutateExperimentsResponse response = experimentServiceClient.mutateExperiments( Long.toString(customerId), ImmutableList.of(operation)); String experiment = response.getResults(0).getResourceName(); System.out.printf("Created experiment with resource name '%s'%n", experiment); return experiment; } }
C#
/// <summary> /// Creates the experiment. /// </summary> /// <param name="client">The Google Ads client.</param> /// <param name="customerId">The customer ID for which the call is made.</param> /// <returns>The resource name of the newly created experiment.</returns> private static string CreateAnExperiment(GoogleAdsClient client, long customerId) { // Get the ExperimentService. ExperimentServiceClient experimentService = client.GetService( Services.V16.ExperimentService); // Creates the experiment. Experiment experiment = new Experiment() { // Name must be unique. Name = $"Example Experiment #{ExampleUtilities.GetRandomString()}", Type = ExperimentType.SearchCustom, Suffix = "[experiment]", Status = ExperimentStatus.Setup }; // Creates the operation. ExperimentOperation operation = new ExperimentOperation() { Create = experiment }; // Makes the API call. MutateExperimentsResponse response = experimentService.MutateExperiments( customerId.ToString(), new[] { operation }); // Displays the result. string experimentResourceName = response.Results.First().ResourceName; Console.WriteLine($"Created experiment with resource name " + $"'{experimentResourceName}'."); return experimentResourceName; }
PHP
private static function createExperimentResource( ExperimentServiceClient $experimentServiceClient, int $customerId ): string { // Creates an experiment and its operation. $experiment = new Experiment([ // Name must be unique. 'name' => 'Example Experiment #' . Helper::getPrintableDatetime(), 'type' => ExperimentType::SEARCH_CUSTOM, 'suffix' => '[experiment]', 'status' => ExperimentStatus::SETUP ]); $experimentOperation = new ExperimentOperation(['create' => $experiment]); // Issues a request to create the experiment. $response = $experimentServiceClient->mutateExperiments( MutateExperimentsRequest::build($customerId, [$experimentOperation]) ); $experimentResourceName = $response->getResults()[0]->getResourceName(); print "Created experiment with resource name '$experimentResourceName'" . PHP_EOL; return $experimentResourceName; }
Python
def create_experiment_resource(client, customer_id): """Creates a new experiment resource. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. Returns: the resource name for the new experiment. """ experiment_operation = client.get_type("ExperimentOperation") experiment = experiment_operation.create experiment.name = f"Example Experiment #{uuid.uuid4()}" experiment.type_ = client.enums.ExperimentTypeEnum.SEARCH_CUSTOM experiment.suffix = "[experiment]" experiment.status = client.enums.ExperimentStatusEnum.SETUP experiment_service = client.get_service("ExperimentService") response = experiment_service.mutate_experiments( customer_id=customer_id, operations=[experiment_operation] ) experiment_resource_name = response.results[0].resource_name print(f"Created experiment with resource name {experiment_resource_name}") return experiment_resource_name
Ruby
def create_experiment_resource(client, customer_id) operation = client.operation.create_resource.experiment do |e| # Name must be unique. e.name = "Example Experiment #{(Time.new.to_f * 1000).to_i}" e.type = :SEARCH_CUSTOM e.suffix = '[experiment]' e.status = :SETUP end response = client.service.experiment.mutate_experiments( customer_id: customer_id, operations: [operation], ) experiment = response.results.first.resource_name puts "Created experiment with resource name #{experiment}." experiment end
Perl
sub create_experiment_resource { my ($api_client, $customer_id) = @_; my $experiment = Google::Ads::GoogleAds::V16::Resources::Experiment->new({ # Name must be unique. name => "Example Experiment #" . uniqid(), type => SEARCH_CUSTOM, suffix => "[experiment]", status => SETUP }); my $operation = Google::Ads::GoogleAds::V16::Services::ExperimentService::ExperimentOperation ->new({ create => $experiment }); my $response = $api_client->ExperimentService()->mutate({ customerId => $customer_id, operations => [$operation]}); my $resource_name = $response->{results}[0]{resourceName}; printf "Created experiment with resource name '%s'.\n", $resource_name; return $resource_name; }