এই গাইডটি লোকেশন টার্গেটিং বর্ণনা করে এবং কীভাবে আপনি আপনার প্রচারাভিযানের জন্য লোকেশন টার্গেটিং যোগ করতে, পুনরুদ্ধার করতে এবং আপডেট করতে Google Ads API ব্যবহার করতে পারেন।
জিও টার্গেটিং কেন গুরুত্বপূর্ণ?
অবস্থান টার্গেটিং আপনাকে একটি নির্দিষ্ট ভৌগলিক অঞ্চলের ব্যবহারকারীদের কাছে বিজ্ঞাপন পরিবেশন করতে দেয়৷ উদাহরণস্বরূপ, ধরে নিন আপনি সুপারমার্কেটের একটি চেইনের জন্য বিজ্ঞাপন দিচ্ছেন। অবস্থান লক্ষ্যমাত্রা ছাড়া, আপনার বিজ্ঞাপনগুলি বিশ্বব্যাপী সমস্ত অঞ্চলে প্রদর্শিত হবে এবং আপনার বিজ্ঞাপনগুলি সেই অঞ্চলের ব্যবহারকারীদের কাছ থেকে ক্লিক পেতে পারে যেখানে আপনার কোনো সুপারমার্কেট অবস্থান নেই৷ এটি বিনিয়োগের উপর রিটার্নের কোন সম্ভাবনা প্রদান করার সময় খরচ তৈরি করে। লোকেশন টার্গেটিং সহ, আপনার প্রচারাভিযান শুধুমাত্র সেই অঞ্চলে বিজ্ঞাপন দেখায় যেখানে আপনার সুপারমার্কেট খোলা আছে। এই পদ্ধতিটি আপনাকে সরাসরি সুপারমার্কেটের জন্য স্থানীয়ভাবে অনুসন্ধানকারী গ্রাহকদের লক্ষ্য করতে দেয়।
Google Ads API আপনাকে একটি নির্দিষ্ট ভৌগলিক বিন্দুর আশেপাশে দেশ, অঞ্চল বা প্রক্সিমিটি অনুসারে আপনার বিজ্ঞাপনগুলিকে লক্ষ্য করতে দেয়।
ভৌগলিক অবস্থানে বিজ্ঞাপন টার্গেট করা সম্পর্কে আরও জানুন।
একটি অঞ্চলের জন্য জিও টার্গেট প্রচারণা
আপনি যেকোন ভৌগলিক অঞ্চলে প্রচারাভিযান টার্গেট করতে পারেন যার জন্য Google বিজ্ঞাপন লোকেশন টার্গেটিং সমর্থন করে, উদাহরণস্বরূপ, একটি দেশ, একটি রাজ্য, একটি শহর বা একটি ডাক অঞ্চল৷ প্রতিটি লক্ষ্যযোগ্য অবস্থান একটি মানদণ্ড আইডি দ্বারা স্বতন্ত্রভাবে চিহ্নিত করা হয়। আপনি GeoTargetConstantService.SuggestGeoTargetConstants
ব্যবহার করে একটি মানদণ্ড আইডি দেখতে পারেন। প্রতিটি GeoTargetConstant
এর resource_name
হল geoTargetConstants/{Criterion ID}
ফর্মের। উদাহরণস্বরূপ, নিউ ইয়র্ক রাজ্যের resource_name
মান হল geoTargetConstants/21167
।
আপনি CampaignCriterionService
ব্যবহার করে আপনার প্রচারাভিযানে জিও টার্গেট যোগ করতে পারেন। নিম্নলিখিত কোড স্নিপেট দেখায় কিভাবে একটি মানদণ্ড আইডি দিয়ে আপনার প্রচারাভিযান টার্গেট করা যায়।
জাভা
private static CampaignCriterion buildLocationIdCriterion( long locationId, String campaignResourceName) { Builder criterionBuilder = CampaignCriterion.newBuilder().setCampaign(campaignResourceName); criterionBuilder .getLocationBuilder() .setGeoTargetConstant(ResourceNames.geoTargetConstant(locationId)); return criterionBuilder.build(); }
সি#
private CampaignCriterion buildLocationCriterion(long locationId, string campaignResourceName) { GeoTargetConstantName location = new GeoTargetConstantName(locationId.ToString()); return new CampaignCriterion() { Campaign = campaignResourceName, Location = new LocationInfo() { GeoTargetConstant = location.ToString() } }; }
পিএইচপি
private static function createLocationCampaignCriterionOperation( int $locationId, string $campaignResourceName ) { // Constructs a campaign criterion for the specified campaign ID using the specified // location ID. $campaignCriterion = new CampaignCriterion([ // Creates a location using the specified location ID. 'location' => new LocationInfo([ // Besides using location ID, you can also search by location names using // GeoTargetConstantServiceClient::suggestGeoTargetConstants() and directly // apply GeoTargetConstant::$resourceName here. An example can be found // in GetGeoTargetConstantByNames.php. 'geo_target_constant' => ResourceNames::forGeoTargetConstant($locationId) ]), 'campaign' => $campaignResourceName ]); return new CampaignCriterionOperation(['create' => $campaignCriterion]); }
পাইথন
def create_location_op(client, customer_id, campaign_id, location_id): campaign_service = client.get_service("CampaignService") geo_target_constant_service = client.get_service("GeoTargetConstantService") # Create the campaign criterion. campaign_criterion_operation = client.get_type("CampaignCriterionOperation") campaign_criterion = campaign_criterion_operation.create campaign_criterion.campaign = campaign_service.campaign_path( customer_id, campaign_id ) # Besides using location_id, you can also search by location names from # GeoTargetConstantService.suggest_geo_target_constants() and directly # apply GeoTargetConstant.resource_name here. An example can be found # in get_geo_target_constant_by_names.py. campaign_criterion.location.geo_target_constant = ( geo_target_constant_service.geo_target_constant_path(location_id) ) return campaign_criterion_operation
রুবি
def create_location(client, customer_id, campaign_id, location_id) client.operation.create_resource.campaign_criterion do |criterion| criterion.campaign = client.path.campaign(customer_id, campaign_id) criterion.location = client.resource.location_info do |li| # Besides using location_id, you can also search by location names from # GeoTargetConstantService.suggest_geo_target_constants() and directly # apply GeoTargetConstant.resource_name here. An example can be found # in get_geo_target_constant_by_names.rb. li.geo_target_constant = client.path.geo_target_constant(location_id) end end end
পার্ল
sub create_location_campaign_criterion_operation { my ($location_id, $campaign_resource_name) = @_; # Construct a campaign criterion for the specified campaign using the # specified location ID. my $campaign_criterion = Google::Ads::GoogleAds::V17::Resources::CampaignCriterion->new({ # Create a location using the specified location ID. location => Google::Ads::GoogleAds::V17::Common::LocationInfo->new({ # Besides using location ID, you can also search by location names # using GeoTargetConstantService::suggest() and directly apply # GeoTargetConstant->{resourceName} here. An example can be found # in get_geo_target_constants_by_names.pl. geoTargetConstant => Google::Ads::GoogleAds::V17::Utils::ResourceNames::geo_target_constant( $location_id)} ), campaign => $campaign_resource_name }); return Google::Ads::GoogleAds::V17::Services::CampaignCriterionService::CampaignCriterionOperation ->new({ create => $campaign_criterion }); }
Google মাঝে মাঝে বিভিন্ন কারণে কিছু অবস্থানের মাপকাঠি বাদ দিতে পারে: অবস্থানটি ছোট বা বৃহত্তর এলাকায় পুনর্গঠন করা হতে পারে, ভূ-রাজনৈতিক পরিবর্তন ইত্যাদি। একটি অবস্থান ENABLED
বা REMOVAL_PLANNED
কিনা তা নির্ধারণ করতে একটি GeoTargetConstant অবজেক্টের status
ক্ষেত্রটি পড়ুন। অবস্থানের লক্ষ্যগুলি কীভাবে পর্যায়ক্রমে শেষ হয় সে সম্পর্কে আরও পড়ুন৷
অবস্থানের নাম দ্বারা সন্ধান করুন
আপনি GeoTargetConstantService.SuggestGeoTargetConstants
ব্যবহার করে অবস্থানের নাম অনুসারে মানদণ্ডের আইডিও দেখতে পারেন। নিম্নলিখিত কোড উদাহরণ দেখায় কিভাবে অবস্থানের নাম অনুসারে একটি অবস্থানের মানদণ্ড আইডি সন্ধান করতে হয়।
জাভা
private void runExample(GoogleAdsClient googleAdsClient) { try (GeoTargetConstantServiceClient geoTargetClient = googleAdsClient.getLatestVersion().createGeoTargetConstantServiceClient()) { SuggestGeoTargetConstantsRequest.Builder requestBuilder = SuggestGeoTargetConstantsRequest.newBuilder(); // Locale is using ISO 639-1 format. If an invalid locale is given, 'en' is used by default. requestBuilder.setLocale("en"); // A list of country codes can be referenced here: // https://developers.google.com/google-ads/api/reference/data/geotargets requestBuilder.setCountryCode("FR"); requestBuilder .getLocationNamesBuilder() .addAllNames(ImmutableList.of("Paris", "Quebec", "Spain", "Deutschland")); SuggestGeoTargetConstantsResponse response = geoTargetClient.suggestGeoTargetConstants(requestBuilder.build()); for (GeoTargetConstantSuggestion suggestion : response.getGeoTargetConstantSuggestionsList()) { System.out.printf( "%s (%s,%s,%s,%s) is found in locale (%s) with reach (%d) for search term (%s).%n", suggestion.getGeoTargetConstant().getResourceName(), suggestion.getGeoTargetConstant().getName(), suggestion.getGeoTargetConstant().getCountryCode(), suggestion.getGeoTargetConstant().getTargetType(), suggestion.getGeoTargetConstant().getStatus().name(), suggestion.getLocale(), suggestion.getReach(), suggestion.getSearchTerm()); } } }
সি#
public void Run(GoogleAdsClient client) { // Get the GeoTargetConstantServiceClient. GeoTargetConstantServiceClient geoService = client.GetService(Services.V17.GeoTargetConstantService); // Locale is using ISO 639-1 format. If an invalid locale is given, // 'en' is used by default. string locale = "en"; // A list of country codes can be referenced here: // https://developers.google.com/google-ads/api/reference/data/geotargets string countryCode = "FR"; string[] locations = { "Paris", "Quebec", "Spain", "Deutschland" }; SuggestGeoTargetConstantsRequest request = new SuggestGeoTargetConstantsRequest() { Locale = locale, CountryCode = countryCode, LocationNames = new SuggestGeoTargetConstantsRequest.Types.LocationNames() }; request.LocationNames.Names.AddRange(locations); try { SuggestGeoTargetConstantsResponse response = geoService.SuggestGeoTargetConstants(request); foreach (GeoTargetConstantSuggestion suggestion in response.GeoTargetConstantSuggestions) { Console.WriteLine( $"{suggestion.GeoTargetConstant.ResourceName} " + $"({suggestion.GeoTargetConstant.Name}, " + $"{suggestion.GeoTargetConstant.CountryCode}, " + $"{suggestion.GeoTargetConstant.TargetType}, " + $"{suggestion.GeoTargetConstant.Status}) is found in locale " + $"({suggestion.Locale}) with reach ({suggestion.Reach}) " + $"for search term ({suggestion.SearchTerm})."); } } 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, array $locationNames, string $locale, string $countryCode ) { $geoTargetConstantServiceClient = $googleAdsClient->getGeoTargetConstantServiceClient(); $response = $geoTargetConstantServiceClient->suggestGeoTargetConstants( new SuggestGeoTargetConstantsRequest([ 'locale' => $locale, 'country_code' => $countryCode, 'location_names' => new LocationNames(['names' => $locationNames]) ]) ); // Iterates over all geo target constant suggestion objects and prints the requested field // values for each one. foreach ($response->getGeoTargetConstantSuggestions() as $geoTargetConstantSuggestion) { /** @var GeoTargetConstantSuggestion $geoTargetConstantSuggestion */ printf( "Found '%s' ('%s','%s','%s',%s) in locale '%s' with reach %d" . " for the search term '%s'.%s", $geoTargetConstantSuggestion->getGeoTargetConstant()->getResourceName(), $geoTargetConstantSuggestion->getGeoTargetConstant()->getName(), $geoTargetConstantSuggestion->getGeoTargetConstant()->getCountryCode(), $geoTargetConstantSuggestion->getGeoTargetConstant()->getTargetType(), GeoTargetConstantStatus::name( $geoTargetConstantSuggestion->getGeoTargetConstant()->getStatus() ), $geoTargetConstantSuggestion->getLocale(), $geoTargetConstantSuggestion->getReach(), $geoTargetConstantSuggestion->getSearchTerm(), PHP_EOL ); } }
পাইথন
def main(client): gtc_service = client.get_service("GeoTargetConstantService") gtc_request = client.get_type("SuggestGeoTargetConstantsRequest") gtc_request.locale = LOCALE gtc_request.country_code = COUNTRY_CODE # The location names to get suggested geo target constants. gtc_request.location_names.names.extend( ["Paris", "Quebec", "Spain", "Deutschland"] ) results = gtc_service.suggest_geo_target_constants(gtc_request) for suggestion in results.geo_target_constant_suggestions: geo_target_constant = suggestion.geo_target_constant print( f"{geo_target_constant.resource_name} " f"({geo_target_constant.name}, " f"{geo_target_constant.country_code}, " f"{geo_target_constant.target_type}, " f"{geo_target_constant.status.name}) " f"is found in locale ({suggestion.locale}) " f"with reach ({suggestion.reach}) " f"from search term ({suggestion.search_term})." )
রুবি
def get_geo_target_constants_by_names # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google::Ads::GoogleAds::GoogleAdsClient.new gtc_service = client.service.geo_target_constant location_names = client.resource.location_names do |ln| ['Paris', 'Quebec', 'Spain', 'Deutschland'].each do |name| ln.names << name end end # Locale is using ISO 639-1 format. If an invalid locale is given, # 'en' is used by default. locale = 'en' # A list of country codes can be referenced here: # https://developers.google.com/google-ads/api/reference/data/geotargets country_code = 'FR' response = gtc_service.suggest_geo_target_constants( locale: locale, country_code: country_code, location_names: location_names ) response.geo_target_constant_suggestions.each do |suggestion| puts sprintf("%s (%s,%s,%s,%s) is found in locale (%s) with reach (%d)" \ " from search term (%s).", suggestion.geo_target_constant.resource_name, suggestion.geo_target_constant.name, suggestion.geo_target_constant.country_code, suggestion.geo_target_constant.target_type, suggestion.geo_target_constant.status, suggestion.locale, suggestion.reach, suggestion.search_term) end end
পার্ল
sub get_geo_target_constants_by_names { my ($api_client, $location_names, $locale, $country_code) = @_; my $suggest_response = $api_client->GeoTargetConstantService()->suggest({ locale => $locale, countryCode => $country_code, locationNames => Google::Ads::GoogleAds::V17::Services::GeoTargetConstantService::LocationNames ->new({ names => $location_names })}); # Iterate over all geo target constant suggestion objects and print the requested # field values for each one. foreach my $geo_target_constant_suggestion ( @{$suggest_response->{geoTargetConstantSuggestions}}) { printf "Found '%s' ('%s','%s','%s',%s) in locale '%s' with reach %d" . " for the search term '%s'.\n", $geo_target_constant_suggestion->{geoTargetConstant}{resourceName}, $geo_target_constant_suggestion->{geoTargetConstant}{name}, $geo_target_constant_suggestion->{geoTargetConstant}{countryCode}, $geo_target_constant_suggestion->{geoTargetConstant}{targetType}, $geo_target_constant_suggestion->{geoTargetConstant}{status}, $geo_target_constant_suggestion->{locale}, $geo_target_constant_suggestion->{reach}, $geo_target_constant_suggestion->{searchTerm}; } return 1; }
একটি অবস্থানের সান্নিধ্যের জন্য প্রচারাভিযানগুলি লক্ষ্য করুন৷
এমন কিছু সময় আছে যখন আপনি একটি শহর বা দেশের চেয়ে আরও সুনির্দিষ্টভাবে লক্ষ্য করতে চাইতে পারেন। উদাহরণস্বরূপ, আপনি আপনার দোকানের অবস্থানের 10 কিলোমিটারের মধ্যে আপনার সুপারমার্কেটের বিজ্ঞাপন দিতে চাইতে পারেন। এই ধরনের ক্ষেত্রে, আপনি প্রক্সিমিটি টার্গেটিং ব্যবহার করতে পারেন। একটি প্রক্সিমিটি টার্গেট তৈরি করার কোডটি একটি লোকেশন টার্গেট যোগ করার অনুরূপ, আপনাকে একটি LocationInfo
অবজেক্টের পরিবর্তে একটি ProximityInfo
অবজেক্ট তৈরি করতে হবে।
জাভা
private static CampaignCriterion buildProximityLocation(String campaignResourceName) { Builder builder = CampaignCriterion.newBuilder().setCampaign(campaignResourceName); ProximityInfo.Builder proximityBuilder = builder.getProximityBuilder(); proximityBuilder.setRadius(10.0).setRadiusUnits(ProximityRadiusUnits.MILES); AddressInfo.Builder addressBuilder = proximityBuilder.getAddressBuilder(); addressBuilder .setStreetAddress("38 avenue de l'Opéra") .setCityName("Paris") .setPostalCode("75002") .setCountryCode("FR"); return builder.build(); }
সি#
private CampaignCriterion buildProximityCriterion(string campaignResourceName) { ProximityInfo proximity = new ProximityInfo() { Address = new AddressInfo() { StreetAddress = "38 avenue de l'Opéra", CityName = "Paris", PostalCode = "75002", CountryCode = "FR" }, Radius = 10d, // Default is kilometers. RadiusUnits = ProximityRadiusUnits.Miles }; return new CampaignCriterion() { Campaign = campaignResourceName, Proximity = proximity }; }
পিএইচপি
private static function createProximityCampaignCriterionOperation(string $campaignResourceName) { // Constructs a campaign criterion as a proximity. $campaignCriterion = new CampaignCriterion([ 'proximity' => new ProximityInfo([ 'address' => new AddressInfo([ 'street_address' => '38 avenue de l\'Opéra', 'city_name' => 'Paris', 'postal_code' => '75002', 'country_code' => 'FR', ]), 'radius' => 10.0, // Default is kilometers. 'radius_units' => ProximityRadiusUnits::MILES ]), 'campaign' => $campaignResourceName ]); return new CampaignCriterionOperation(['create' => $campaignCriterion]); }
পাইথন
def create_proximity_op(client, customer_id, campaign_id): campaign_service = client.get_service("CampaignService") # Create the campaign criterion. campaign_criterion_operation = client.get_type("CampaignCriterionOperation") campaign_criterion = campaign_criterion_operation.create campaign_criterion.campaign = campaign_service.campaign_path( customer_id, campaign_id ) campaign_criterion.proximity.address.street_address = "38 avenue de l'Opera" campaign_criterion.proximity.address.city_name = "Paris" campaign_criterion.proximity.address.postal_code = "75002" campaign_criterion.proximity.address.country_code = "FR" campaign_criterion.proximity.radius = 10 # Default is kilometers. campaign_criterion.proximity.radius_units = ( client.enums.ProximityRadiusUnitsEnum.MILES ) return campaign_criterion_operation
রুবি
def create_proximity(client, customer_id, campaign_id) client.operation.create_resource.campaign_criterion do |criterion| criterion.campaign = client.path.campaign(customer_id, campaign_id) criterion.proximity = client.resource.proximity_info do |proximity| proximity.address = client.resource.address_info do |address| address.street_address = "38 avenue de l'Opéra" address.city_name = "Paris" address.postal_code = "75002" address.country_code = "FR" end proximity.radius = 10 proximity.radius_units = :MILES end end end
পার্ল
sub create_proximity_campaign_criterion_operation { my ($campaign_resource_name) = @_; # Construct a campaign criterion as a proximity. my $campaign_criterion = Google::Ads::GoogleAds::V17::Resources::CampaignCriterion->new({ proximity => Google::Ads::GoogleAds::V17::Common::ProximityInfo->new({ address => Google::Ads::GoogleAds::V17::Common::AddressInfo->new({ streetAddress => "38 avenue de l'Opéra", cityName => "cityName", postalCode => "75002", countryCode => "FR" } ), radius => 10.0, # Default is kilometers. radiusUnits => MILES } ), campaign => $campaign_resource_name }); return Google::Ads::GoogleAds::V17::Services::CampaignCriterionService::CampaignCriterionOperation ->new({ create => $campaign_criterion }); }
জিও লক্ষ্য পুনরুদ্ধার করুন
আপনি GoogleAdsService.SearchStream
ব্যবহার করে একটি প্রচারাভিযানের জন্য জিও টার্গেট পুনরুদ্ধার করতে পারেন। আপনি WHERE
ক্লজে আপনার ফলাফল ফিল্টার করতে পারেন।
SELECT
campaign_criterion.campaign,
campaign_criterion.location.geo_target_constant,
campaign_criterion.proximity.geo_point.longitude_in_micro_degrees,
campaign_criterion.proximity.geo_point.latitude_in_micro_degrees,
campaign_criterion.proximity.radius,
campaign_criterion.negative
FROM campaign_criterion
WHERE
campaign_criterion.campaign = 'customers/{customer_id}/campaigns/{campaign_id}'
AND campaign_criterion.type IN (LOCATION, PROXIMITY)
জিও টার্গেট আপডেট করুন
একটি প্রচারাভিযানের জন্য অবস্থানের লক্ষ্যগুলি আপডেট করতে, আপনাকে বিদ্যমান জিও লক্ষ্যগুলির তালিকা পুনরুদ্ধার করতে হবে এবং এটিকে নতুন লক্ষ্যগুলির তালিকার সাথে তুলনা করতে হবে৷ তারপরে আপনার প্রয়োজন নেই এমন লক্ষ্যগুলি সরাতে আপনি remove
ক্রিয়াকলাপটি ব্যবহার করতে পারেন এবং আপনার প্রয়োজনীয় নতুন জিও লক্ষ্যগুলি যোগ করার জন্য create
অপারেশনটি ব্যবহার করতে পারেন (কিন্তু বিদ্যমান প্রচারে অনুপস্থিত)।
জিও টার্গেট বাদ দিন
এছাড়াও আপনি LocationInfo
বাদ দিতে পারেন, কিন্তু ProximityInfo
নয়। আপনি যদি একটি অঞ্চলকে টার্গেট করতে চান তবে এই বৈশিষ্ট্যটি সবচেয়ে কার্যকর, তবে একটি উপ-অঞ্চল বাদ দিন (উদাহরণস্বরূপ, নিউ ইয়র্ক সিটি বাদে সমগ্র মার্কিন যুক্তরাষ্ট্রকে লক্ষ্য করতে)। একটি অঞ্চল বাদ দিতে, CampaignCriterion
negative
ক্ষেত্রটিকে true
হিসাবে সেট করুন৷
একাধিক ভৌগলিক অঞ্চল লক্ষ্য করুন
একটি LocationGroupInfo
ব্যবহার করে, আপনি একাধিক ভৌগলিক অঞ্চলকে লক্ষ্য করার জন্য একটি প্রচারাভিযান সক্ষম করতে পারেন৷ একটি অঞ্চল প্রচারাভিযানের অবস্থান এক্সটেনশন দ্বারা সংজ্ঞায়িত অবস্থানের উপর কেন্দ্রীভূত।
LocationGroupInfo
তে সংজ্ঞায়িত ব্যাসার্ধ প্রতিটি অবস্থানের চারপাশে একটি বৃত্তাকার অঞ্চলকে চিহ্নিত করে, এবং একটি radius
বস্তু, দৈর্ঘ্য এবং radius_units
নিয়ে গঠিত, যা মিটার বা মাইল হতে পারে ( LocationGroupRadiusUnitsEnum
)।
একটি LocationGroupInfo
এর অবস্থানগুলিকে geo_target_constant
ফিল্ডে নির্ধারিত জিওটার্গেটিং মানদণ্ডের আইডিগুলির একটি তালিকা দ্বারা ফিল্টার করা যেতে পারে। যদি সংজ্ঞায়িত করা হয়, প্রদত্ত মানদণ্ড আইডিগুলির বাইরে বিদ্যমান কোনো অবস্থানগুলিকে লক্ষ্যবস্তু করা হবে না৷