এই নির্দেশিকাটি Google Ads API ব্যবহার করে আপনি তৈরি করতে পারেন এমন বিভিন্ন ধরনের রূপান্তর ক্রিয়াগুলির একটি তালিকা, Google Ads ওয়েব ইন্টারফেসে এই ম্যাপগুলি কীভাবে তৈরি করা যায় সে সম্পর্কে তথ্য এবং নতুন রূপান্তর ক্রিয়াগুলি কীভাবে তৈরি করতে হয় তা প্রদর্শন করে একটি বিস্তারিত কোড উদাহরণ প্রদান করে৷
রূপান্তর পরিমাপ করতে, আপনি যে type
রূপান্তর ক্রিয়া ট্র্যাক করতে চান তার জন্য একটি ConversionAction
সেট আপ করুন৷ উদাহরণস্বরূপ, একটি অনলাইন ক্রয় এবং একটি ফোন কলের জন্য বিভিন্ন রূপান্তর ক্রিয়া প্রয়োজন৷
API-এ নতুন রূপান্তর ক্রিয়াগুলি সেট আপ করার সর্বোত্তম উপায় হল নীচের রূপান্তর অ্যাকশন কোডের উদাহরণটি ব্যবহার করা৷ নমুনাটি আপনার জন্য সমস্ত ব্যাকগ্রাউন্ড প্রমাণীকরণের কাজগুলি পরিচালনা করে এবং আপনাকে একটি ConversionAction
তৈরির মাধ্যমে নিয়ে যায়।
বেশিরভাগ রূপান্তর ক্রিয়াগুলিকে ট্র্যাক করতে আপনার পক্ষ থেকে অতিরিক্ত পদক্ষেপেরও প্রয়োজন। উদাহরণস্বরূপ, আপনার ওয়েবসাইটে রূপান্তরগুলি ট্র্যাক করতে, আপনাকে আপনার ওয়েবসাইটের রূপান্তর পৃষ্ঠায় ট্যাগ নামে একটি কোড স্নিপেট যোগ করতে হবে৷ অন্যান্য রূপান্তর কর্মের প্রয়োজনীয়তার জন্য, আমাদের সহায়তা কেন্দ্র নিবন্ধটি দেখুন।
ওয়েবসাইট রূপান্তর
একটি ওয়েবসাইট রূপান্তর আপনাকে ওয়েবসাইট ক্রিয়াকলাপ যেমন অনলাইন বিক্রয়, লিঙ্ক ক্লিক, পৃষ্ঠা দর্শন এবং সাইন-আপগুলি ট্র্যাক করতে দেয়৷
আপনার ওয়েবসাইটে রূপান্তরগুলি ট্র্যাক করতে, আপনাকে অবশ্যই WEBPAGE
এ সেট করা ConversionActionType
দিয়ে একটি ConversionAction
তৈরি করতে হবে এবং আপনার ওয়েবসাইটের রূপান্তর পৃষ্ঠায় ট্যাগ নামে একটি কোড স্নিপেট যোগ করতে হবে৷
ConversionAction
বিভিন্ন ধরনের ওয়েবসাইট রূপান্তরকে অন্তর্ভুক্ত করে, API-এর মধ্যে একটি ConversionAction
এর tag_snippets ক্ষেত্রে তালিকাভুক্ত প্রতিটি TagSnippet
এর type
ক্ষেত্রের দ্বারা আলাদা করা হয়।
একটি TagSnippet
ট্র্যাকিং কোড প্রদান করে যা আপনার রূপান্তর ক্রিয়াগুলি ট্র্যাক করার জন্য আপনার ওয়েবসাইটে অবশ্যই অন্তর্ভুক্ত করতে হবে৷ ওয়েবসাইট এবং ফোন নম্বর ক্লিক রূপান্তরগুলির জন্য event_snippet
প্রয়োজন, যা ওয়েব পৃষ্ঠাগুলিতে স্থাপন করা উচিত যা একটি রূপান্তর ক্রিয়া নির্দেশ করে যেমন একটি চেকআউট নিশ্চিতকরণ বা লিড ফর্ম জমা পৃষ্ঠা এবং global_site_tag
, যা আপনার ওয়েবসাইটের প্রতিটি পৃষ্ঠায় ইনস্টল করা আবশ্যক৷ আপনি ConversionActionService
এর মাধ্যমে এই দুটি বৈশিষ্ট্যই পুনরুদ্ধার করতে পারেন। আপনার পৃষ্ঠাগুলিকে কীভাবে ট্যাগ করবেন সে সম্পর্কে আরও তথ্যের জন্য আমাদের সহায়তা কেন্দ্রটি দেখুন৷
Google বিজ্ঞাপন ওয়েব ইন্টারফেসের প্রতিটি উৎসের জন্য ব্যবহার করার জন্য নিম্নলিখিত সারণী সমতুল্য API প্যারামিটারগুলি দেখায়:
ট্র্যাকিং কোডের ধরন | গুগল বিজ্ঞাপন উত্স |
---|---|
WEBPAGE | ওয়েবসাইট, ওয়েবসাইট (Google Analytics (GA4)) |
WEBPAGE_ONCLICK | ওয়েবসাইট, ওয়েবসাইট (Google Analytics (GA4)) |
CLICK_TO_CALL | ফোন নম্বর ক্লিক করে |
--- | ওয়েবসাইট (Google Analytics (UA)) |
অ্যাপ রূপান্তর
একটি অ্যাপ রূপান্তর আপনাকে মোবাইল অ্যাপ ইনস্টল বা Google Play স্টোর থেকে অ্যাপ কেনাকাটা ট্র্যাক করতে দেয়।
নিম্নলিখিত সারণীটি Google বিজ্ঞাপন ওয়েব ইন্টারফেসের প্রতিটি উত্সের জন্য ব্যবহার করার জন্য সমতুল্য ConversionActionType
API প্যারামিটারগুলি দেখায়:
রূপান্তর কর্মের ধরন | গুগল বিজ্ঞাপন উত্স |
---|---|
GOOGLE_PLAY_DOWNLOAD | Google Play > ইনস্টল |
GOOGLE_PLAY_IN_APP_PURCHASE | Google Play > অ্যাপ-মধ্যস্থ কেনাকাটা |
আপনি যদি Google Analytics 4 বৈশিষ্ট্য বা থার্ড-পার্টি অ্যাপ অ্যানালিটিক্স ব্যবহার করে অন্যান্য মোবাইল অ্যাপ অ্যাকশন ট্র্যাক করতে চান। অতিরিক্ত রূপান্তর কর্ম প্রকার দেখুন।
ফোন কল রূপান্তর
ফোন কল রূপান্তর ট্র্যাকিং আপনাকে বিজ্ঞাপন থেকে কল, আপনার ওয়েবসাইটের একটি নম্বরে কল এবং মোবাইল সাইটের নম্বরগুলিতে ক্লিক করতে দেয়৷
নিম্নলিখিত সারণীটি Google বিজ্ঞাপন ওয়েব ইন্টারফেসের প্রতিটি উত্সের জন্য ব্যবহার করার জন্য সমতুল্য ConversionActionType
API প্যারামিটারগুলি দেখায়:
রূপান্তর কর্মের ধরন | গুগল বিজ্ঞাপন উত্স |
---|---|
AD_CALL | কল এক্সটেনশন বা শুধুমাত্র-কল বিজ্ঞাপন ব্যবহার করে বিজ্ঞাপন থেকে কল |
WEBSITE_CALL | আপনার ওয়েবসাইটে একটি ফোন নম্বরে কল |
CLICK_TO_CALL | আপনার মোবাইল ওয়েবসাইটে একটি নম্বর ক্লিক করুন |
CLICK_TO_CALL
প্রকারটি AD_CALL
প্রকারের থেকে আলাদা যে এটি প্রকৃত ফোন কলগুলিকে ট্র্যাক করে না৷ পরিবর্তে, CLICK_TO_CALL
শুধুমাত্র একটি মোবাইল ডিভাইস থেকে একটি ফোন নম্বরে ক্লিক ট্র্যাক করে৷ আপনি যখন ফোন কল ট্র্যাক করার জন্য Google ফরওয়ার্ডিং নম্বর ব্যবহার করতে অক্ষম হন তখন এটি কার্যকর।
AD_CALL
একটি AD_CALL
রূপান্তর ক্রিয়া Google Ads ওয়েব ইন্টারফেসে বিজ্ঞাপনের রূপান্তর থেকে একটি কল হিসাবে উপস্থিত হয়৷ আপনি আপনার AD_CALL
রূপান্তর ক্রিয়া তৈরি করার পরে, আপনি যখন একটি CallAsset
তৈরি করবেন তখন call_conversion_action
ফিল্ডে এর সংস্থানের নাম উল্লেখ করুন। কল সম্পদ আপনাকে সরাসরি আপনার বিজ্ঞাপনে একটি ফোন নম্বর দেখাতে দেয়।
একটি কল একটি নির্দিষ্ট সময়ের চেয়ে বেশি স্থায়ী হলে রূপান্তর হিসাবে রিপোর্ট করা হয়৷ ডিফল্ট 60 সেকেন্ড।
WEBSITE_CALL
একটি WEBSITE_CALL
রূপান্তর ক্রিয়া Google বিজ্ঞাপন ওয়েব ইন্টারফেসে একটি ওয়েবসাইট রূপান্তর থেকে কল হিসাবে প্রদর্শিত হয়৷
AD_CALL
এর বিপরীতে, আপনার ওয়েবসাইটে তালিকাভুক্ত নম্বরগুলিতে কল ট্র্যাকিংয়ের জন্য গতিশীল Google ফরওয়ার্ডিং নম্বর পুনরুদ্ধার করতে এই ট্র্যাকারটির আপনার ওয়েবসাইটে event_snippet
এবং global_site_tag
যোগ করতে হবে। এছাড়াও, আপনাকে অবশ্যই একটি কল সম্পদ সেট আপ করতে হবে এবং এটি গ্রাহক, প্রচারাভিযান বা বিজ্ঞাপন গোষ্ঠী স্তরে লিঙ্ক করতে হবে ৷
অফলাইন রূপান্তর আমদানি করুন
নিম্নলিখিত সারণীটি Google বিজ্ঞাপন ওয়েব ইন্টারফেসের প্রতিটি উত্সের জন্য ব্যবহার করার জন্য সমতুল্য ConversionActionType
API প্যারামিটার এবং প্রতিটি নির্দিষ্ট রূপান্তর ক্রিয়া প্রকারের জন্য ডকুমেন্টেশনের একটি লিঙ্ক দেখায়:
রূপান্তর কর্মের ধরন | গুগল বিজ্ঞাপন উত্স | API সেটআপ গাইড |
---|---|---|
UPLOAD_CLICKS | লিডের জন্য ক্লিক এবং বর্ধিত রূপান্তরগুলি থেকে রূপান্তরগুলি ট্র্যাক করুন৷ | আপলোড ক্লিক গাইড লিড গাইডের জন্য উন্নত রূপান্তর |
UPLOAD_CALLS | কল থেকে রূপান্তর ট্র্যাক | API সেটআপ গাইড |
STORE_SALES | ট্র্যাক রূপান্তর দোকান বিক্রয় | API সেটআপ গাইড |
ওয়েবের জন্য উন্নত রূপান্তর
ওয়েবের জন্য উন্নত রূপান্তরগুলি আপনাকে একই সময়ে পরিবর্তে একটি রূপান্তর ইভেন্টের 24 ঘন্টার মধ্যে WEBPAGE
রূপান্তর ক্রিয়াগুলির জন্য প্রথম পক্ষের রূপান্তর ডেটা পাঠাতে দেয়৷ এটি গ্রাহক ডাটাবেস বা CRM সিস্টেমের মতো বিভিন্ন উত্স থেকে প্রথম-পক্ষের ডেটা সনাক্ত করা সম্ভব করে।
অতিরিক্ত রূপান্তর ক্রিয়া প্রকার
Google Ads API রিপোর্টে অতিরিক্ত ধরনের রূপান্তর অ্যাকশন উপলব্ধ করে, কিন্তু সেই অ্যাকশন তৈরি বা পরিবর্তন সীমিত বা নিষিদ্ধ করতে পারে।
SKAdNetwork রূপান্তর
আপনি যদি iOS অ্যাপ প্রচারাভিযান চালান এবং SKAdNetwork প্রয়োগ করে থাকেন, তাহলে আপনি নিম্নলিখিত সংস্থানগুলি ব্যবহার করে Customer
এবং Campaign
স্তরে Google-কে দেওয়া SKAdNetwork ডেটা অ্যাক্সেস করতে পারেন:
রিপোর্ট ক্ষেত্র | বর্ণনা |
---|---|
metrics.sk_ad_network_installs | অ্যাপল দ্বারা রিপোর্ট করা ইনস্টল সংখ্যা. এই মেট্রিক শুধুমাত্র segments.sk_ad_network_conversion_value এবং তারিখ-সম্পর্কিত সেগমেন্টের যেকোন সমন্বয় দ্বারা বিভক্ত করা যেতে পারে। |
metrics.sk_ad_network_total_conversions | অ্যাপল দ্বারা রিপোর্ট করা ইনস্টল এবং অন্যান্য ধরনের রূপান্তর সহ মোট রূপান্তর সংখ্যা। এই মেট্রিক শুধুমাত্র SKAdNetwork-সম্পর্কিত বিভাগ এবং তারিখ-সম্পর্কিত বিভাগ দ্বারা বিভক্ত করা যেতে পারে। |
segments.sk_ad_network_ad_event_type | একটি নির্দিষ্ট রূপান্তরের জন্য ঘটে যাওয়া ইভেন্টের ধরন৷ |
segments.sk_ad_network_attribution_credit | একটি নির্দিষ্ট রূপান্তরের জন্য অ্যাট্রিবিউশন কীভাবে জমা হয়। |
segments.sk_ad_network_fine_conversion_value | Apple দ্বারা রিপোর্ট করা একটি রূপান্তরের মান। এই সেগমেন্টটি Apple যদি |
segments.sk_ad_network_coarse_conversion_value | একটি পৃথক রূপান্তরের জন্য মোটা মান। |
segments.sk_ad_network_postback_sequence_index | পোস্টব্যাকের অবস্থান, ক্রমানুসারে, একটি নির্দিষ্ট রূপান্তরের জন্য। |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id | অ্যাপ আইডি যেখানে iOS স্টোর কিট বিজ্ঞাপন নেটওয়ার্ক ইনস্টল করা বিজ্ঞাপনটি দেখানো হয়েছে। |
segments.sk_ad_network_source_domain | যে ওয়েবসাইটটিতে iOS স্টোর কিট অ্যাড নেটওয়ার্ক ইনস্টল করার বিজ্ঞাপনটি দেখানো হয়েছে। একটি নাল মান মানে এই বিভাগটি প্রযোজ্য নয় - উদাহরণস্বরূপ, নন-iOS প্রচারাভিযান - বা Apple দ্বারা পাঠানো কোনো পোস্টব্যাকে উপস্থিত ছিল না। |
segments.sk_ad_network_source_type | উৎসের ধরন যেখানে iOS স্টোর কিট বিজ্ঞাপন নেটওয়ার্ক ইনস্টল করা বিজ্ঞাপনটি দেখানো হয়েছে। একটি নাল মান মানে এই বিভাগটি প্রযোজ্য নয় — উদাহরণস্বরূপ, নন-iOS প্রচারাভিযান — বা অ্যাপলের পাঠানো কোনো পোস্টব্যাকে সোর্স ডোমেন বা সোর্স অ্যাপ উপস্থিত ছিল না। |
segments.sk_ad_network_user_type | ব্যবহারকারীর ধরন যা একটি নির্দিষ্ট রূপান্তর তৈরি করেছে। |
segments.sk_ad_network_redistributed_fine_conversion_value | এই সেগমেন্টের রূপান্তর মানগুলি শূন্য মানগুলিকে অন্তর্ভুক্ত করে যা রূপান্তর মানগুলিতে পুনরায় বিতরণ করা হয়েছিল৷ এই সেগমেন্টটি Apple দ্বারা প্রত্যাবর্তিত পর্যবেক্ষিত সূক্ষ্ম রূপান্তর মানগুলির সমষ্টি এবং Google থেকে মডেল করা নাল মানগুলির প্রতিনিধিত্ব করে৷ |
segments.sk_ad_network_version | iOS স্টোর কিট অ্যাড নেটওয়ার্ক API সংস্করণ যেটি ব্যবহার করা হয়েছিল। |
এছাড়াও আপনি CustomerSkAdNetworkConversionValueSchema
এর মাধ্যমে iOS অ্যাপগুলির সাথে নির্দিষ্ট লিঙ্কযুক্ত গ্রাহকদের জন্য একটি SKAdNetwork রূপান্তর মান ম্যাপিং সংরক্ষণ করতে পারেন।
নমুনা পাইথন কোড
#!/usr/bin/env python # Copyright 2019 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 # # https://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. import argparse import sys from google.ads.googleads.client import GoogleAdsClient from google.ads.googleads.errors import GoogleAdsException def main(client, customer_id): """Adds a keyword plan, campaign, ad group, etc. to the customer account. Also handles errors from the API and prints them. Args: client: An initialized instance of GoogleAdsClient customer_id: A str of the customer_id to use in requests. """ res = update_skan_cv_schema( client, customer_id, "my_app_id", "account_link_id" ) print(res) def update_skan_cv_schema(client, customer_id, app_id, account_link_id): skan_service = client.get_service( "CustomerSkAdNetworkConversionValueSchemaService" ) req = client.get_type( "MutateCustomerSkAdNetworkConversionValueSchemaRequest" ) operation = client.get_type( "CustomerSkAdNetworkConversionValueSchemaOperation" ) schema_instance = client.get_type( "CustomerSkAdNetworkConversionValueSchema" ) new_schema = operation.update new_schema.resource_name = ( skan_service.customer_sk_ad_network_conversion_value_schema_path( "customer_id", "account_link_id" ) ) new_schema.schema.app_id = app_id new_schema.schema.measurement_window_hours = 48 skan_cv_mapping = ( schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings() ) skan_cv_mapping.fine_grained_conversion_value = 0 # 0 - 63 skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0 skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48 skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event() skan_cv_event.mapped_event_name = "TEST" skan_cv_event.event_revenue_value = 10 skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event) new_schema.schema.fine_grained_conversion_value_mappings.append( skan_cv_mapping ) req.operation = operation req.customer_id = customer_id res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema( req ) return res if __name__ == "__main__": # GoogleAdsClient will read the google-ads.yaml configuration file in the # home directory if none is specified. googleads_client = GoogleAdsClient.load_from_storage( version="v17" ) parser = argparse.ArgumentParser( description="Creates a keyword plan for specified customer." ) # The following argument(s) should be provided to run the example. parser.add_argument( "-c", "--customer_id", type=str, required=True, help="The Google Ads customer ID.", ) args = parser.parse_args() try: main(googleads_client, args.customer_id) except GoogleAdsException as ex: print( f'Request with ID "{ex.request_id}" failed with status ' f'"{ex.error.code().name}" and includes the following errors:' ) for error in ex.failure.errors: print(f'\tError with message "{error.message}".') if error.location: for field_path_element in error.location.field_path_elements: print(f"\t\tOn field: {field_path_element.field_name}") sys.exit(1)
Google Analytics
একটি লিঙ্ক করা Google Analytics প্রপার্টি থেকে কনভার্সনগুলির নিম্নলিখিত type
মানগুলির মধ্যে একটি রয়েছে:
GA4 সম্পত্তি রূপান্তর:
-
GOOGLE_ANALYTICS_4_CUSTOM
-
GOOGLE_ANALYTICS_4_PURCHASE
এছাড়াও আপনি
google_analytics_4_settings
ফিল্ড থেকে GA4 প্রপার্টি আইডি, প্রপার্টির নাম এবং ইভেন্টের নাম পুনরুদ্ধার করতে পারেন।-
ইউনিভার্সাল অ্যানালিটিক্স সম্পত্তি রূপান্তর:
-
UNIVERSAL_ANALYTICS_GOAL
-
UNIVERSAL_ANALYTICS_TRANSACTION
-
আপনি একটি GA4 সম্পত্তি রূপান্তরে নিম্নলিখিত পরিবর্তনগুলি করতে পারেন:
- আপনার GA4 প্রপার্টি থেকে কনভার্সনটি আপনার Google Ads অ্যাকাউন্টে ইম্পোর্ট করুন এর
status
ফিল্ডHIDDEN
থেকেENABLED
করে পরিবর্তন করুন। - Google Ads বিডিং এবং রিপোর্টগুলিকে কীভাবে প্রভাবিত করবে তা নির্দেশ করতে এর
primary_for_goal
এবংcategory
ক্ষেত্রগুলিকে পরিবর্তন করুন। - এর
name
বাvalue_settings
আপডেট করুন। - একটি
remove
অপারেশন ব্যবহার করে আপনার Google বিজ্ঞাপন অ্যাকাউন্ট থেকে রূপান্তর সরান।
একটি আমদানি করা GA4 রূপান্তরের অন্যান্য বৈশিষ্ট্য বা আমদানি করা ইউনিভার্সাল অ্যানালিটিক্স রূপান্তরের কোনো বৈশিষ্ট্য পরিবর্তন করার কোনো প্রচেষ্টার ফলে একটি MUTATE_NOT_ALLOWED
ত্রুটি দেখা দেয়। আপনি শুধুমাত্র Google Ads UI ব্যবহার করে সেই পরিবর্তনগুলি করতে পারেন৷
ফায়ারবেস এবং তৃতীয় পক্ষের অ্যাপ বিশ্লেষণ
তৃতীয় পক্ষের অ্যাপ বিশ্লেষণ বা ফায়ারবেস রূপান্তরগুলি আমদানি করতে, ConversionActionService
এর mutate
পদ্ধতি ব্যবহার করে HIDDEN
থেকে ENABLED
এ ConversionAction
status
পরিবর্তন করুন৷ এই রূপান্তর ক্রিয়াগুলির জন্য app_id
আপডেট করা সমর্থিত নয়।
-
FIREBASE_ANDROID_FIRST_OPEN
-
FIREBASE_ANDROID_IN_APP_PURCHASE
-
FIREBASE_ANDROID_CUSTOM
-
FIREBASE_IOS_FIRST_OPEN
-
FIREBASE_IOS_IN_APP_PURCHASE
-
FIREBASE_IOS_CUSTOM
-
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
-
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
-
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
-
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
-
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
-
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
দোকান বিক্রয়
যদিও আপনি Google Ads API ব্যবহার করে STORE_SALES
বা STORE_SALES_DIRECT_UPLOAD
রূপান্তর ক্রিয়া তৈরি করতে পারবেন না, তবে API স্টোর বিক্রয় লেনদেন আপলোড করা সমর্থন করে।
-
STORE_SALES
-
STORE_SALES_DIRECT_UPLOAD
বিবিধ
নিম্নলিখিত রূপান্তর অ্যাকশনের ধরনগুলি Google Ads API-এ শুধুমাত্র পঠনযোগ্য এবং প্রতিবেদনের উদ্দেশ্যে সরবরাহ করা হয়।
-
ANDROID_APP_PRE_REGISTRATION
-
ANDROID_INSTALLS_ALL_OTHER_APPS
-
FLOODLIGHT_ACTION
-
FLOODLIGHT_TRANSACTION
-
GOOGLE_HOSTED
-
LEAD_FORM_SUBMIT
-
SALESFORCE
-
SEARCH_ADS_360
-
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
-
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
-
SMART_CAMPAIGN_MAP_DIRECTIONS
-
SMART_CAMPAIGN_TRACKED_CALLS
-
STORE_VISITS
-
WEBPAGE_CODELESS
অজানা
যদি আপনার Google Ads অ্যাকাউন্টে অন্য ধরনের রূপান্তর ক্রিয়াগুলি অন্তর্ভুক্ত থাকে, তাহলে আপনি দেখতে পাবেন যে অনুসন্ধান এবং প্রতিবেদনগুলি রূপান্তর ক্রিয়াগুলি ফিরিয়ে দেয় যেখানে ConversionAction.type
UNKNOWN
৷ API এই রূপান্তর ক্রিয়াগুলি পরিচালনা করতে সমর্থন করে না, তবে মূল রূপান্তর মেট্রিক্স যেমন metrics.conversions
এবং metrics.conversions_value
এর জন্য সম্পূর্ণ ফলাফল প্রদান করার জন্য রিপোর্টে সেগুলি ফেরত দেয়।
কোড উদাহরণ
নিম্নলিখিত কোড উদাহরণ আপনাকে একটি নতুন রূপান্তর ক্রিয়া তৈরি করার প্রক্রিয়ার মধ্য দিয়ে নিয়ে যায়। বিশেষত, এটি UPLOAD_CLICKS
এ সেট করা type
সাথে একটি রূপান্তর ক্রিয়া তৈরি করে। ইম্পোর্ট > ম্যানুয়াল ইম্পোর্ট ব্যবহার করে API বা আপলোড > ক্লিক থেকে ট্র্যাক কনভার্সন ব্যবহার করে একটি নতুন কনভার্সন অ্যাকশন তৈরি করার মতো একই Google Ads UI ফ্লো। এটি category
DEFAULT
সেট করে।
নিম্নলিখিত ডিফল্ট সেটিংস প্রযোজ্য:
Google Ads API
primary_for_goal
ক্ষেত্রটি স্বয়ংক্রিয়ভাবে সেট করে, কিন্তু আপনার রূপান্তর লক্ষ্যগুলির সাথে একত্রিত হলে একটি রূপান্তর ক্রিয়া কীভাবে আপনার অ্যাকাউন্টে প্রতিবেদন এবং বিডিংকে প্রভাবিত করে তা নিয়ন্ত্রণ করতে আপনি এই ক্ষেত্রটি স্পষ্টভাবে সেট করতে পারেন।Google বিজ্ঞাপন API স্বয়ংক্রিয়ভাবে
MANY_PER_CLICK
এcounting_type
সেট করে। আরও বিশদ বিবরণের জন্য রূপান্তর গণনা বিকল্পগুলি সম্পর্কে দেখুন৷Google Ads API অ্যাট্রিবিউশন মডেলটিকে অ্যাট্রিবিউশন
AttributionModel
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
মানতেattribution_model_settings
ফিল্ড সেট করে ডেটা চালিত হিসাবে সেট করে।
জাভা
private void runExample(GoogleAdsClient googleAdsClient, long customerId) { // Creates a ConversionAction. ConversionAction conversionAction = ConversionAction.newBuilder() // Note that conversion action names must be unique. If a conversion action already // exists with the specified conversion_action_name the create operation will fail with // a ConversionActionError.DUPLICATE_NAME error. .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime()) .setCategory(ConversionActionCategory.DEFAULT) .setType(ConversionActionType.WEBPAGE) .setStatus(ConversionActionStatus.ENABLED) .setViewThroughLookbackWindowDays(15L) .setValueSettings( ValueSettings.newBuilder() .setDefaultValue(23.41) .setAlwaysUseDefaultValue(true) .build()) .build(); // Creates the operation. ConversionActionOperation operation = ConversionActionOperation.newBuilder().setCreate(conversionAction).build(); try (ConversionActionServiceClient conversionActionServiceClient = googleAdsClient.getLatestVersion().createConversionActionServiceClient()) { MutateConversionActionsResponse response = conversionActionServiceClient.mutateConversionActions( Long.toString(customerId), Collections.singletonList(operation)); System.out.printf("Added %d conversion actions:%n", response.getResultsCount()); for (MutateConversionActionResult result : response.getResultsList()) { System.out.printf( "New conversion action added with resource name: '%s'%n", result.getResourceName()); } } }
সি#
public void Run(GoogleAdsClient client, long customerId) { // Get the ConversionActionService. ConversionActionServiceClient conversionActionService = client.GetService(Services.V17.ConversionActionService); // Note that conversion action names must be unique. // If a conversion action already exists with the specified name the create operation // will fail with a ConversionAction.DUPLICATE_NAME error. string ConversionActionName = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(); // Add a conversion action. ConversionAction conversionAction = new ConversionAction() { Name = ConversionActionName, Category = ConversionActionCategory.Default, Type = ConversionActionType.Webpage, Status = ConversionActionStatus.Enabled, ViewThroughLookbackWindowDays = 15, ValueSettings = new ConversionAction.Types.ValueSettings() { DefaultValue = 23.41, AlwaysUseDefaultValue = true } }; // Create the operation. ConversionActionOperation operation = new ConversionActionOperation() { Create = conversionAction }; try { // Create the conversion action. MutateConversionActionsResponse response = conversionActionService.MutateConversionActions(customerId.ToString(), new ConversionActionOperation[] { operation }); // Display the results. foreach (MutateConversionActionResult newConversionAction in response.Results) { Console.WriteLine($"New conversion action with resource name = " + $"'{newConversionAction.ResourceName}' was added."); } } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } }
পিএইচপি
public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId) { // Creates a conversion action. $conversionAction = new ConversionAction([ // Note that conversion action names must be unique. // If a conversion action already exists with the specified conversion_action_name // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error. 'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(), 'category' => ConversionActionCategory::PBDEFAULT, 'type' => ConversionActionType::WEBPAGE, 'status' => ConversionActionStatus::ENABLED, 'view_through_lookback_window_days' => 15, 'value_settings' => new ValueSettings([ 'default_value' => 23.41, 'always_use_default_value' => true ]) ]); // Creates a conversion action operation. $conversionActionOperation = new ConversionActionOperation(); $conversionActionOperation->setCreate($conversionAction); // Issues a mutate request to add the conversion action. $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient(); $response = $conversionActionServiceClient->mutateConversionActions( MutateConversionActionsRequest::build($customerId, [$conversionActionOperation]) ); printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL); foreach ($response->getResults() as $addedConversionAction) { /** @var ConversionAction $addedConversionAction */ printf( "New conversion action added with resource name: '%s'%s", $addedConversionAction->getResourceName(), PHP_EOL ); } }
পাইথন
def main(client, customer_id): conversion_action_service = client.get_service("ConversionActionService") # Create the operation. conversion_action_operation = client.get_type("ConversionActionOperation") # Create conversion action. conversion_action = conversion_action_operation.create # Note that conversion action names must be unique. If a conversion action # already exists with the specified conversion_action_name, the create # operation will fail with a ConversionActionError.DUPLICATE_NAME error. conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}" conversion_action.type_ = ( client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS ) conversion_action.category = ( client.enums.ConversionActionCategoryEnum.DEFAULT ) conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED conversion_action.view_through_lookback_window_days = 15 # Create a value settings object. value_settings = conversion_action.value_settings value_settings.default_value = 15.0 value_settings.always_use_default_value = True # Add the conversion action. conversion_action_response = ( conversion_action_service.mutate_conversion_actions( customer_id=customer_id, operations=[conversion_action_operation], ) ) print( "Created conversion action " f'"{conversion_action_response.results[0].resource_name}".' )
রুবি
def add_conversion_action(customer_id) # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google::Ads::GoogleAds::GoogleAdsClient.new # Add a conversion action. conversion_action = client.resource.conversion_action do |ca| ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}" ca.type = :UPLOAD_CLICKS ca.category = :DEFAULT ca.status = :ENABLED ca.view_through_lookback_window_days = 15 # Create a value settings object. ca.value_settings = client.resource.value_settings do |vs| vs.default_value = 15 vs.always_use_default_value = true end end # Create the operation. conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action) # Add the ad group ad. response = client.service.conversion_action.mutate_conversion_actions( customer_id: customer_id, operations: [conversion_action_operation], ) puts "New conversion action with resource name = #{response.results.first.resource_name}." end
পার্ল
sub add_conversion_action { my ($api_client, $customer_id) = @_; # Note that conversion action names must be unique. # If a conversion action already exists with the specified conversion_action_name, # the create operation fails with error ConversionActionError.DUPLICATE_NAME. my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid(); # Create a conversion action. my $conversion_action = Google::Ads::GoogleAds::V17::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation ->new({create => $conversion_action}); # Add the conversion action. my $conversion_actions_response = $api_client->ConversionActionService()->mutate({ customerId => $customer_id, operations => [$conversion_action_operation]}); printf "New conversion action added with resource name: '%s'.\n", $conversion_actions_response->{results}[0]{resourceName}; return 1; }
এই উদাহরণটি আপনার ক্লায়েন্ট লাইব্রেরির রিমার্কেটিং ফোল্ডারে এবং কোড উদাহরণ সংগ্রহে পাওয়া যেতে পারে: রূপান্তর অ্যাকশন কোড উদাহরণ যোগ করুন ।
বৈধতা
Google Ads এবং Google Ads API বিভিন্ন ধরনের রূপান্তর ক্রিয়াকে সমর্থন করে, তাই কিছু বৈধকরণ নিয়ম কর্মের type
উপর ভিত্তি করে পরিবর্তিত হয়।
একটি রূপান্তর ক্রিয়া তৈরি করার সময় সবচেয়ে সাধারণ ত্রুটি হল DUPLICATE_NAME
। আপনি প্রতিটি রূপান্তর কর্মের জন্য একটি অনন্য নাম ব্যবহার করছেন তা নিশ্চিত করুন৷
এখানে ConversionAction
ফিল্ড সেট করার কিছু টিপস আছে:
- সমস্ত enum ক্ষেত্র
-
UNKNOWN
এ যেকোনো enum ক্ষেত্র সেট করার চেষ্টা করা হলে একটিRequestError.INVALID_ENUM_VALUE
ত্রুটি দেখা দেয়। -
app_id
-
app_id
বৈশিষ্ট্যটি অপরিবর্তনীয় এবং শুধুমাত্র একটি নতুন অ্যাপ রূপান্তর তৈরি করার সময় সেট করা যেতে পারে। -
attribution_model_settings
- এটিকে একটি বঞ্চিত বিকল্পে সেট করার ফলে একটি
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
ত্রুটি দেখা দেয়৷ Google Ads শুধুমাত্রGOOGLE_ADS_LAST_CLICK
এবংGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
সমর্থন করে। -
click_through_lookback_window_days
এই অ্যাট্রিবিউটটিকে অনুমোদিত সীমার বাইরের একটি মান নির্ধারণ করার ফলে একটি
RangeError.TOO_LOW
বাRangeError.TOO_HIGH
ত্রুটি দেখা দেয়৷একটি
AD_CALL
বাWEBSITE_CALL
রূপান্তর কর্মের জন্য এই বৈশিষ্ট্যটি অবশ্যই[1,60]
সীমার মধ্যে থাকতে হবে। বেশিরভাগ অন্যান্য রূপান্তর কর্মের জন্য, অনুমোদিত পরিসর হল[1,30]
।-
include_in_conversions_metric
একটি
create
বাupdate
অপারেশনে এই মান সেট করা একটিFieldError.IMMUTABLE_FIELD
ত্রুটির সাথে ব্যর্থ হয়৷ পরিবর্তে, রূপান্তর লক্ষ্য নির্দেশিকাতে বর্ণিতprimary_for_goal
সেট করুন।-
phone_call_duration_seconds
কলের জন্য নয় এমন একটি রূপান্তর ক্রিয়াতে এই বৈশিষ্ট্যটি সেট করার চেষ্টা করলে একটি
FieldError.VALUE_MUST_BE_UNSET
ত্রুটি দেখা দেয়৷-
type
type
অ্যাট্রিবিউট অপরিবর্তনীয় এবং শুধুমাত্র একটি নতুন রূপান্তর তৈরি করার সময় সেট করা যেতে পারে।UNKNOWN
এর সমানtype
সহ একটি রূপান্তর ক্রিয়া আপডেট করার ফলে একটিMutateError.MUTATE_NOT_ALLOWED
ত্রুটি দেখা দেয়৷-
value_settings
একটি
WEBSITE_CALL
বাAD_CALL
রূপান্তর অ্যাকশনেরvalue_settings
always_use_default_value
true
সেট করা আবশ্যক। এই মানটি তৈরি বা আপডেট করার সময় একটিfalse
মান উল্লেখ করার ফলে একটিINVALID_VALUE
ত্রুটি দেখা দেয়।-
view_through_lookback_window_days
এই অ্যাট্রিবিউটটিকে অনুমোদিত সীমার বাইরের একটি মান নির্ধারণ করার ফলে একটি
RangeError.TOO_LOW
বাRangeError.TOO_HIGH
ত্রুটি দেখা দেয়৷ বেশিরভাগ রূপান্তর কর্মের জন্য, অনুমোদিত পরিসর হল[1,30]
।এই বৈশিষ্ট্যটি
AD_CALL
বাWEBSITE_CALL
রূপান্তর ক্রিয়াগুলিতে সেট করা যাবে না৷ একটি মান নির্দিষ্ট করার ফলে একটিVALUE_MUST_BE_UNSET
ত্রুটি দেখা দেয়৷