গুগল অ্যাডস এপিআই-তে পারফরম্যান্স অপ্টিমাইজ করতে, বিভিন্ন অপারেশনের মধ্যে নির্ভরতা পরিচালনা করতে এবং রিসোর্স পরিবর্তন করার সময় রেসপন্স সামলাতে এই সেরা পদ্ধতিগুলো অনুসরণ করুন।
অস্থায়ী সম্পদের নাম
GoogleAdsService.Mutate এবং BatchJobService উভয়ই অস্থায়ী রিসোর্স নাম সমর্থন করে, যা পরবর্তী অপারেশনগুলিতে রেফারেন্স হিসেবে ব্যবহার করা যায়। এর ফলে আপনি একটিমাত্র মিউটেট রিকোয়েস্ট বা ব্যাচ জবের মাধ্যমে একটি ক্যাম্পেইন এবং এর সাথে যুক্ত অ্যাড গ্রুপ, অ্যাড ও কিওয়ার্ড তৈরি করতে পারেন।
একই মিউটেট রিকোয়েস্ট বা ব্যাচ জবের মধ্যে নতুন তৈরি করা কোনো রিসোর্সকে রেফারেন্স করতে, নতুন রিসোর্সটির resource_name ফিল্ডে একটি নেগেটিভ ইন্টিজার আইডি (যেমন -1 বা -2 , 0 বাদে) উল্লেখ করুন। উদাহরণস্বরূপ, একটি ব্যাচ রিকোয়েস্টে ক্যাম্পেইন তৈরি করার সময়, এর রিসোর্স নেমটি customers/CUSTOMER_ID/campaigns/-1 সেট করুন। একই রিকোয়েস্টের মধ্যে পরবর্তী কোনো অপারেশনে অ্যাড গ্রুপ তৈরি করার সময়, প্যারেন্ট ক্যাম্পেইন হিসেবে customers/CUSTOMER_ID/campaigns/-1 রেফারেন্স করুন। API স্বয়ংক্রিয়ভাবে -1 তৈরির সময় জেনারেট হওয়া আসল ক্যাম্পেইন আইডি দিয়ে প্রতিস্থাপন করে।
ব্যবহারের সীমাবদ্ধতা
অস্থায়ী রিসোর্স নাম ব্যবহার করার সময় নিম্নলিখিত নিয়মগুলি মনে রাখবেন:
- ক্রম গুরুত্বপূর্ণ: একটি অস্থায়ী রিসোর্সের নাম সংজ্ঞায়িত করার পরেই কেবল আপনি সেটির উল্লেখ করতে পারবেন। অপারেশনের তালিকায়, নির্ভরশীল অপারেশনটি (যেমন একটি অ্যাড গ্রুপ তৈরি করা) অবশ্যই তার প্যারেন্ট রিসোর্স তৈরি করার অপারেশনের (যেমন একটি ক্যাম্পেইন তৈরি করা) পরে থাকতে হবে।
- একক-অনুরোধ বা ব্যাচ-জবের পরিধি: অস্থায়ী রিসোর্স নামগুলো আলাদা জব বা মিউটেট অনুরোধ জুড়ে স্থায়ী থাকে না। পূর্ববর্তী কোনো জব বা মিউটেট অনুরোধে তৈরি করা রিসোর্সকে রেফারেন্স করতে, এর প্রকৃত সিস্টেম-জেনারেটেড রিসোর্স নামটি ব্যবহার করুন।
- বৈশ্বিক অনন্যতা: একটি একক জব বা মিউটেট রিকোয়েস্টের মধ্যে, প্রতিটি অস্থায়ী রিসোর্সের নামে অবশ্যই সমস্ত রিসোর্স টাইপ জুড়ে একটি অনন্য ঋণাত্মক পূর্ণসংখ্যা ব্যবহার করতে হবে। উদাহরণস্বরূপ, আপনি একই রিকোয়েস্টে একটি ক্যাম্পেইন এবং একটি অ্যাড গ্রুপ উভয়কেই
-1বরাদ্দ করতে পারবেন না। একই রিকোয়েস্ট বা ব্যাচ জবের মধ্যে একটি অস্থায়ী আইডি পুনরায় ব্যবহার করলেNewResourceCreationError.DUPLICATE_TEMP_IDSত্রুটি দেখা দেয়।
উদাহরণ পেলোড
ধরুন, আপনি একটিমাত্র API রিকোয়েস্ট বা ব্যাচ জবের মাধ্যমে একটি ক্যাম্পেইন, একটি অ্যাড গ্রুপ এবং একটি অ্যাড যোগ করতে চান। আপনি GoogleAdsService.Mutate অথবা BatchJobService.AddBatchJobOperations রিকোয়েস্ট পেলোডে mutateOperations অ্যারেটিকে নিচের REST JSON উদাহরণে দেখানো অনুযায়ী সাজাতে পারেন (সংক্ষিপ্ততার জন্য অন্যান্য প্রয়োজনীয় রিসোর্স ফিল্ডগুলো বাদ দেওয়া হয়েছে):
{
"mutateOperations": [
{
"campaignOperation": {
"create": {
"resourceName": "customers/CUSTOMER_ID/campaigns/-1"
}
}
},
{
"adGroupOperation": {
"create": {
"resourceName": "customers/CUSTOMER_ID/adGroups/-2",
"campaign": "customers/CUSTOMER_ID/campaigns/-1"
}
}
},
{
"adGroupAdOperation": {
"create": {
"adGroup": "customers/CUSTOMER_ID/adGroups/-2"
}
}
}
]
}
এই উদাহরণটি নিম্নলিখিত মূল বিবরণগুলি প্রদর্শন করে:
- অ্যাড গ্রুপটি একটি নতুন অস্থায়ী আইডি (
-2) ব্যবহার করছে, কারণ-1ইতিমধ্যেই ক্যাম্পেইনের জন্য বরাদ্দ করা আছে। - অ্যাড গ্রুপটি পূর্ববর্তী অপারেশনে তৈরি করা ক্যাম্পেইনের সাথে নিজেকে লিঙ্ক করার জন্য
customers/CUSTOMER_ID/campaigns/-1রেফারেন্সটি ব্যবহার করে। -
adGroupAdOperationটিcustomers/CUSTOMER_ID/adGroups/-2রেফারেন্স করে এবংresourceNameবাদ দেয়, কারণ রিকোয়েস্টের পরবর্তী কোনো অপারেশনে নতুন অ্যাডটিকে রেফারেন্স করা হয়নি।
একই ধরণের গ্রুপ অপারেশন
GoogleAdsService.Mutate ব্যবহার করার সময়, parent এবং child নির্ভরতা বজায় রেখে repeated mutate_operations অ্যারেতে অপারেশনগুলিকে রিসোর্স টাইপ অনুসারে একসাথে গ্রুপ করুন। এই পদ্ধতিটি ক্রমানুসারে অপারেশনগুলি পড়তে থাকে যতক্ষণ না এটি একটি ভিন্ন রিসোর্স টাইপের সম্মুখীন হয়, এবং তারপর একই টাইপের সমস্ত সংলগ্ন অপারেশনগুলিকে একটি একক ব্যাকএন্ড পরিষেবা অনুরোধে ব্যাচ করে।
উদাহরণস্বরূপ, যদি আপনি repeated mutate_operations ফিল্ডে ৫টি ক্যাম্পেইন অপারেশনের পর ১০টি অ্যাড গ্রুপ অপারেশন অন্তর্ভুক্ত করেন, তাহলে সিস্টেম দুটি ব্যাকএন্ড কল সম্পাদন করে: একটি ৫টি ক্যাম্পেইন অপারেশনের জন্য CampaignService এ, এবং দ্বিতীয়টি ১০টি অ্যাড গ্রুপ অপারেশনের জন্য AdGroupService এ।
এর বিপরীতে, অপারেশনগুলোকে [campaign, ad group, campaign, ad group] ক্রমে সাজিয়ে ইন্টারলিভ করলে চারটি পৃথক ব্যাকএন্ড কল হয়। ইন্টারলিভড কলগুলো API-এর পারফরম্যান্স কমিয়ে দেয় এবং বড় ব্যাচের ক্ষেত্রে রিকোয়েস্ট টাইমআউটের কারণ হতে পারে।
আংশিক ব্যর্থতা এবং ব্যাচ সীমা পরিচালনা করুন
ডিফল্টরূপে, কোনো একটি অপারেশন ব্যর্থ হলে GoogleAdsService.Mutate সম্পূর্ণ অনুরোধটি রোলব্যাক করে। একই অনুরোধের অন্যান্য অপারেশন ব্যর্থ হলেও বৈধ অপারেশনগুলো সম্পন্ন করতে, অনুরোধে partial_failure কে true সেট করুন এবং প্রতিক্রিয়ায় partial_failure_error পরীক্ষা করুন। যখন partial_failure true থাকে, তখন যদি কোনো প্যারেন্ট অপারেশন যা একটি অস্থায়ী আইডি (যেমন customers/CUSTOMER_ID/campaigns/-1 ) নির্ধারণ করে, তা ভ্যালিডেশনে ব্যর্থ হয়, তবে একই অনুরোধে সেই অস্থায়ী আইডি উল্লেখকারী যেকোনো নির্ভরশীল চাইল্ড অপারেশনও NewResourceCreationError.TEMP_ID_RESOURCE_HAD_ERRORS ত্রুটির সাথে ব্যর্থ হয়। আরও বিস্তারিত জানতে, আংশিক ব্যর্থতা নির্দেশিকা দেখুন।
এছাড়াও অনুরোধের আকার, সাব-ব্যাচিং এবং রেট লিমিট মনে রাখবেন:
- অনুরোধ এবং খণ্ডের আকারের সীমা: একটি একক
GoogleAdsService.Mutateঅনুরোধ ১০,০০০ মিউটেট অপারেশনের একটি সীমা প্রয়োগ করে (অথবা ২০,০০০ পর্যন্ত, যখন অনুরোধের সমস্ত অপারেশনAdGroupCriterionOperationহয়, সীমা অতিক্রম করলেRequestError.TOO_MANY_MUTATE_OPERATIONSফেরত দেয়) এবং সর্বাধিক ১০০টি অ্যাকশন অপারেশন (RequestError.TOO_MANY_ACTION_OPERATIONS)।BatchJobService.AddBatchJobOperationsপ্রতি কলে সর্বোচ্চ ১০,০০০ অপারেশন, প্রতিটিMutateOperationজন্য ১০,৪৮৪,৫০৪ বাইট এবং প্রতিAddBatchJobOperationsRequestজন্য ৪১,৯৩৭,৯২০ বাইট প্রয়োগ করে (যেকোনো সীমা অতিক্রম করলেBatchJobError.REQUEST_TOO_LARGEফেরত দেয়, যেখানে প্রতি ব্যাচ জবে মোট ১,০০০,০০০ পর্যন্ত অপারেশন হতে পারে)। একই ক্যাম্পেইন বা অ্যাকাউন্টকে লক্ষ্য করে যুগপৎ পরিবর্তন ঘটানো হলেDatabaseError.CONCURRENT_MODIFICATIONত্রুটি দেখা দিতে পারে। -
BatchJobServiceঅ্যাটমিক সাব-ব্যাচিং: যদিও ব্যাচ জবগুলো আংশিক-ব্যর্থতা সেম্যান্টিকসের অধীনে সম্পাদিত হয় (ডিফল্টরূপে প্রতিটি অভ্যন্তরীণ সাব-ব্যাচে ১,০০০ অপারেশন),BatchJobServiceস্বয়ংক্রিয়ভাবে একই প্যারেন্ট আইডির জন্য কিছু সংলগ্ন নির্ভরশীল অপারেশনকে অ্যাটমিক সাব-ব্যাচে একত্রিত করে:- একই
AssetGroupআইডির জন্য একটিAssetGroupOperation(create) এবং এর পরপরইAssetGroupAssetOperation(create) অপারেশনসমূহ (মোট ১,০০০টি পর্যন্ত অপারেশন, যাBatchJobError.ASSET_GROUP_AND_ASSET_GROUP_ASSET_TRANSACTION_FAILUREসাথে স্বয়ংক্রিয়ভাবে ব্যর্থ হয়; প্রতিটিAssetGroupOperationupdateবাremoveএকটি স্বতন্ত্র একক-অপারেশন সাব-ব্যাচে সম্পাদিত হয়)। - একটি পারফরম্যান্স ম্যাক্স
CampaignOperation(create, যখন ব্র্যান্ড গাইডলাইন সক্রিয় থাকে—যা ডিফল্ট, যদি নাbrand_guidelines_enabledকেfalseবাhotel_property_asset_setকে সেট করা হয়) এবং এর পরে একইCampaignআইডির জন্য ধারাবাহিকCampaignAssetOperation(create) অপারেশনসমূহ (মোট ১,০০০টি পর্যন্ত অপারেশন, যাBatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILUREসাথে অ্যাটমিকভাবে ব্যর্থ হয়)। - একই প্যারেন্ট (
AssetGroupবাAdGroup)-এর জন্য পরপরAssetGroupListingGroupFilterOperation(max 10,000, যাBatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILUREত্রুটির কারণে অ্যাটমিকভাবে ব্যর্থ হয়) অথবাAdGroupCriterionOperation(listing_group,max 20,000, যাCriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATIONকারণে অ্যাটমিকভাবে ব্যর্থ হয়) অপারেশন।
- একই
প্রতিক্রিয়া থেকে পরিবর্তনযোগ্য বৈশিষ্ট্যগুলি পুনরুদ্ধার করুন
যদি আপনি আপনার মিউটেট রিকোয়েস্টের response_content_type MUTABLE_RESOURCE হিসেবে সেট করেন, তাহলে রিকোয়েস্ট দ্বারা তৈরি বা আপডেট করা (অপসারণ করা নয়) প্রতিটি সমর্থিত অবজেক্টের জন্য রেসপন্সে resource_name এবং এর মিউটেবল ফিল্ডগুলো দিয়ে পূর্ণ রিসোর্স অবজেক্টটি থাকে (পাশাপাশি ফেরত আসা রিসোর্সের কিছু গুরুত্বপূর্ণ সিস্টেম-পপুলেটেড ফিল্ডও থাকে, যেমন ExperimentArm.in_design_campaigns )। remove অপারেশনের ক্ষেত্রে—অথবা যেসব রিসোর্স টাইপ MUTABLE_RESOURCE ফেরত দেওয়া সমর্থন করে না—রেসপন্সটি সর্বদা শুধুমাত্র resource_name ফেরত দেয়। প্রতিটি মিউটেট কলের পরে একটি অতিরিক্ত Search বা SearchStream রিকোয়েস্ট পাঠানো এড়াতে এই ফিচারটি ব্যবহার করুন।
আপনি যদি response_content_type সেট না করেন, তাহলে Google Ads API ডিফল্টরূপে RESOURCE_NAME_ONLY ব্যবহার করে এবং প্রতিটি পরিবর্তিত রিসোর্সের শুধুমাত্র resource_name ফেরত দেয়।
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি মিউটেট কল থেকে একটি পরিবর্তনযোগ্য রিসোর্স পুনরুদ্ধার করতে হয়:
জাভা
private String createExperimentArms( GoogleAdsClient googleAdsClient, long customerId, long campaignId, String experiment) { List<ExperimentArmOperation> operations = new ArrayList<>(); operations.add( ExperimentArmOperation.newBuilder() .setCreate( // The "control" arm references an already-existing campaign. ExperimentArm.newBuilder() .setControl(true) .addCampaigns(ResourceNames.campaign(customerId, campaignId)) .setExperiment(experiment) .setName("control arm") .setTrafficSplit(40) .build()) .build()); operations.add( ExperimentArmOperation.newBuilder() .setCreate( // In standard campaign experiments, creating the treatment arm automatically // generates a draft campaign that you can modify before starting the experiment. ExperimentArm.newBuilder() .setControl(false) .setExperiment(experiment) .setName("experiment arm") .setTrafficSplit(60) .build()) .build()); try (ExperimentArmServiceClient experimentArmServiceClient = googleAdsClient.getLatestVersion().createExperimentArmServiceClient()) { // Constructs the mutate request. MutateExperimentArmsRequest mutateRequest = MutateExperimentArmsRequest.newBuilder() .setCustomerId(Long.toString(customerId)) .addAllOperations(operations) // We want to fetch the draft campaign IDs from the treatment arm, so the easiest way // to do that is to have the response return the newly created entities. .setResponseContentType(ResponseContentType.MUTABLE_RESOURCE) .build(); // Sends the mutate request. MutateExperimentArmsResponse response = experimentArmServiceClient.mutateExperimentArms(mutateRequest); // Results always return in the order that you specify them in the request. Since we created // the treatment arm last, it will be the last result. If you don't remember which arm is the // treatment arm, you can always filter the query in the next section with // `experiment_arm.control = false`. MutateExperimentArmResult controlArmResult = response.getResults(0); MutateExperimentArmResult treatmentArmResult = response.getResults(response.getResultsCount() - 1); System.out.printf( "Created control arm with resource name '%s'%n", controlArmResult.getResourceName()); System.out.printf( "Created treatment arm with resource name '%s'%n", treatmentArmResult.getResourceName()); return treatmentArmResult.getExperimentArm().getInDesignCampaigns(0); } }
সি#
private static (MutateExperimentArmResult, MutateExperimentArmResult) CreateExperimentArms(GoogleAdsClient client, long customerId, long baseCampaignId, string experimentResourceName) { // Get the ExperimentArmService. ExperimentArmServiceClient experimentService = client.GetService( Services.V25.ExperimentArmService); // Create the control arm. The control arm references an already-existing campaign. ExperimentArmOperation controlArmOperation = new ExperimentArmOperation() { Create = new ExperimentArm() { Control = true, Campaigns = { ResourceNames.Campaign(customerId, baseCampaignId) }, Experiment = experimentResourceName, Name = "Control Arm", TrafficSplit = 40 } }; // Create the non-control arm. // In standard campaign experiments, creating the treatment arm automatically // generates a draft campaign that you can modify before starting the experiment. ExperimentArmOperation treatmentArmOperation = new ExperimentArmOperation() { Create = new ExperimentArm() { Control = false, Experiment = experimentResourceName, Name = "Experiment Arm", TrafficSplit = 60 } }; // We want to fetch the draft campaign IDs from the treatment arm, so the // easiest way to do that is to have the response return the newly created // entities. MutateExperimentArmsRequest request = new MutateExperimentArmsRequest { CustomerId = customerId.ToString(), Operations = { controlArmOperation, treatmentArmOperation }, ResponseContentType = ResponseContentType.MutableResource }; MutateExperimentArmsResponse response = experimentService.MutateExperimentArms( request ); // Results always return in the order that you specify them in the request. // Since we created the treatment arm last, it will be the last result. MutateExperimentArmResult controlArm = response.Results.First(); MutateExperimentArmResult treatmentArm = response.Results.Last(); Console.WriteLine($"Created control arm with resource name " + $"'{controlArm.ResourceName}'."); Console.WriteLine($"Created treatment arm with resource name" + $" '{treatmentArm.ResourceName}'."); return (controlArm, treatmentArm); }
পিএইচপি
private static function createExperimentArms( GoogleAdsClient $googleAdsClient, int $customerId, int $campaignId, string $experimentResourceName ): string { $operations = []; $experimentArm1 = new ExperimentArm( [ // The "control" arm references an already-existing campaign. 'control' => true, 'campaigns' => [ResourceNames::forCampaign($customerId, $campaignId)], 'experiment' => $experimentResourceName, 'name' => 'control arm', 'traffic_split' => 40 ] ); $operations[] = new ExperimentArmOperation(['create' => $experimentArm1]); $experimentArm2 = new ExperimentArm( [ // The non-"control" arm, also called a "treatment" arm, will automatically // generate draft campaigns that you can modify before starting the // experiment. 'control' => false, 'experiment' => $experimentResourceName, 'name' => 'experiment arm', 'traffic_split' => 60 ] ); $operations[] = new ExperimentArmOperation(['create' => $experimentArm2]); // Issues a request to create the experiment arms. $experimentArmServiceClient = $googleAdsClient->getExperimentArmServiceClient(); $response = $experimentArmServiceClient->mutateExperimentArms( MutateExperimentArmsRequest::build($customerId, $operations) // We want to fetch the draft campaign IDs from the treatment arm, so the easiest // way to do that is to have the response return the newly created entities. ->setResponseContentType(ResponseContentType::MUTABLE_RESOURCE) ); // Results always return in the order that you specify them in the request. // Since we created the treatment arm last, it will be the last result. $controlArmResourceName = $response->getResults()[0]->getResourceName(); $treatmentArm = $response->getResults()[count($operations) - 1]; print "Created control arm with resource name '$controlArmResourceName'" . PHP_EOL; print "Created treatment arm with resource name '{$treatmentArm->getResourceName()}'" . PHP_EOL; return $treatmentArm->getExperimentArm()->getInDesignCampaigns()[0]; }
পাইথন
def create_experiment_arms( client: GoogleAdsClient, customer_id: str, base_campaign_id: str, experiment: str, ) -> str: """Creates a control and treatment experiment arms. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. base_campaign_id: the campaign ID to associate with the control arm of the experiment. experiment: the resource name for an experiment. Returns: the resource name for the new treatment experiment arm. """ operations: List[ExperimentArmOperation] = [] campaign_service: CampaignServiceClient = client.get_service( "CampaignService" ) # The "control" arm references an already-existing campaign. operation_1: ExperimentArmOperation = client.get_type( "ExperimentArmOperation" ) exa_1: ExperimentArm = operation_1.create exa_1.control = True exa_1.campaigns.append( campaign_service.campaign_path(customer_id, base_campaign_id) ) exa_1.experiment = experiment exa_1.name = "control arm" exa_1.traffic_split = 40 operations.append(operation_1) # In standard campaign experiments, creating the treatment arm automatically # generates a draft campaign that you can modify before starting the experiment. operation_2: ExperimentArmOperation = client.get_type( "ExperimentArmOperation" ) exa_2: ExperimentArm = operation_2.create exa_2.control = False exa_2.experiment = experiment exa_2.name = "experiment arm" exa_2.traffic_split = 60 operations.append(operation_2) experiment_arm_service: ExperimentArmServiceClient = client.get_service( "ExperimentArmService" ) request: MutateExperimentArmsRequest = client.get_type( "MutateExperimentArmsRequest" ) request.customer_id = customer_id request.operations = operations # We want to fetch the draft campaign IDs from the treatment arm, so the # easiest way to do that is to have the response return the newly created # entities. request.response_content_type = ( client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE ) response: MutateExperimentArmsResponse = ( experiment_arm_service.mutate_experiment_arms(request=request) ) # Results always return in the order that you specify them in the request. # Since we created the treatment arm second, it will be the second result. control_arm_result: Any = response.results[0] treatment_arm_result: Any = response.results[1] print( f"Created control arm with resource name {control_arm_result.resource_name}" ) print( f"Created treatment arm with resource name {treatment_arm_result.resource_name}" ) return treatment_arm_result.experiment_arm.in_design_campaigns[0]
রুবি
def create_experiment_arms(client, customer_id, base_campaign_id, experiment) operations = [] operations << client.operation.create_resource.experiment_arm do |ea| # The "control" arm references an already-existing campaign. ea.control = true ea.campaigns << client.path.campaign(customer_id, base_campaign_id) ea.experiment = experiment ea.name = 'control arm' ea.traffic_split = 40 end operations << client.operation.create_resource.experiment_arm do |ea| # The non-"control" arm, also called a "treatment" arm, will automatically # generate draft campaigns that you can modify before starting the # experiment. ea.control = false ea.experiment = experiment ea.name = 'experiment arm' ea.traffic_split = 60 end response = client.service.experiment_arm.mutate_experiment_arms( customer_id: customer_id, operations: operations, # We want to fetch the draft campaign IDs from the treatment arm, so the # easiest way to do that is to have the response return the newly created # entities. response_content_type: :MUTABLE_RESOURCE, ) # Results always return in the order that you specify them in the request. # Since we created the treatment arm last, it will be the last result. control_arm_result = response.results.first treatment_arm_result = response.results.last puts "Created control arm with resource name #{control_arm_result.resource_name}." puts "Created treatment arm with resource name #{treatment_arm_result.resource_name}." treatment_arm_result.experiment_arm.in_design_campaigns.first end
পার্ল
sub create_experiment_arms { my ($api_client, $customer_id, $base_campaign_id, $experiment) = @_; my $operations = []; push @$operations, Google::Ads::GoogleAds::V25::Services::ExperimentArmService::ExperimentArmOperation ->new({ create => Google::Ads::GoogleAds::V25::Resources::ExperimentArm->new({ # The "control" arm references an already-existing campaign. control => "true", campaigns => [ Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign( $customer_id, $base_campaign_id ) ], experiment => $experiment, name => "control arm", trafficSplit => 40 })}); push @$operations, Google::Ads::GoogleAds::V25::Services::ExperimentArmService::ExperimentArmOperation ->new({ create => Google::Ads::GoogleAds::V25::Resources::ExperimentArm->new({ # The non-"control" arm, also called a "treatment" arm, will automatically # generate draft campaigns that you can modify before starting the # experiment. control => "false", experiment => $experiment, name => "experiment arm", trafficSplit => 60 })}); my $response = $api_client->ExperimentArmService()->mutate({ customerId => $customer_id, operations => $operations, # We want to fetch the draft campaign IDs from the treatment arm, so the # easiest way to do that is to have the response return the newly created # entities. responseContentType => MUTABLE_RESOURCE }); # Results always return in the order that you specify them in the request. # Since we created the treatment arm last, it will be the last result. my $control_arm_result = $response->{results}[0]; my $treatment_arm_result = $response->{results}[1]; printf "Created control arm with resource name '%s'.\n", $control_arm_result->{resourceName}; printf "Created treatment arm with resource name '%s'.\n", $treatment_arm_result->{resourceName}; return $treatment_arm_result->{experimentArm}{inDesignCampaigns}[0]; }