مکان یابی

این راهنما، هدف‌گیری مکانی و نحوه استفاده از API گوگل ادز برای افزودن، بازیابی و به‌روزرسانی هدف‌گیری مکانی برای کمپین‌های شما را شرح می‌دهد.

برای اطلاعات بیشتر در مورد محدودیت‌های هدف‌گیری، به بخش محدودیت‌های هدف‌گیری در بخش « درباره محدودیت‌های حساب Google Ads» مراجعه کنید.

چرا هدف‌گیری جغرافیایی مهم است؟

هدف‌گیری مکانی به شما این امکان را می‌دهد که تبلیغات خود را به کاربرانی در یک منطقه جغرافیایی خاص ارائه دهید. برای مثال، فرض کنید که برای یک زنجیره سوپرمارکت تبلیغ می‌کنید. بدون هدف‌گیری مکانی، تبلیغات شما در تمام مناطق جهان نمایش داده می‌شود و ممکن است تبلیغات شما از کاربرانی در مناطقی که هیچ شعبه سوپرمارکتی ندارید، کلیک دریافت کند. این کار باعث ایجاد هزینه می‌شود و در عین حال هیچ امکانی برای بازگشت سرمایه وجود ندارد. با هدف‌گیری مکانی، کمپین‌های شما فقط در مناطقی که سوپرمارکت‌های شما باز هستند، تبلیغات را نشان می‌دهند. این رویکرد همچنین به شما امکان می‌دهد مستقیماً مشتریانی را که به صورت محلی به دنبال سوپرمارکت‌ها هستند، هدف قرار دهید.

رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) به شما امکان می‌دهد تبلیغات خود را بر اساس کشور، منطقه یا نزدیکی به یک نقطه جغرافیایی خاص هدف‌گیری کنید .

کمپین‌های هدف جغرافیایی برای یک منطقه

شما می‌توانید کمپین‌ها را در هر منطقه جغرافیایی که گوگل ادز از هدف‌گیری مکانی برای آن پشتیبانی می‌کند، مانند یک کشور، یک ایالت، یک شهر یا یک منطقه پستی، هدف‌گیری کنید. هر مکان قابل هدف‌گیری به طور منحصر به فرد توسط یک شناسه معیار (Criterion ID) شناسایی می‌شود. می‌توانید با استفاده از GeoTargetConstantService.SuggestGeoTargetConstants ، یک شناسه معیار را جستجو کنید. resource_name هر GeoTargetConstant به شکل geoTargetConstants/{Criterion ID} است. به عنوان مثال، مقدار resource_name ایالت نیویورک geoTargetConstants/21167 است.

شما می‌توانید با استفاده از CampaignCriterionService (یا در سطح گروه تبلیغاتی با استفاده از AdGroupCriterion برای انواع کمپین‌های پشتیبانی‌شده، مانند کمپین‌های Demand Gen با فعال بودن upgraded_targeting ) اهداف جغرافیایی را به کمپین‌های خود اضافه کنید. قطعه کد زیر نحوه هدف‌گیری کمپین شما با یک شناسه معیار را نشان می‌دهد.

جاوا

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: GoogleAdsClient,
    customer_id: str,
    campaign_id: str,
    location_id: str,
) -> CampaignCriterionOperation:
    campaign_service: CampaignServiceClient = client.get_service(
        "CampaignService"
    )
    geo_target_constant_service: GeoTargetConstantServiceClient = (
        client.get_service("GeoTargetConstantService")
    )

    # Create the campaign criterion.
    campaign_criterion_operation: CampaignCriterionOperation = client.get_type(
        "CampaignCriterionOperation"
    )
    campaign_criterion: CampaignCriterion = 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::V25::Resources::CampaignCriterion->new({
      # Create a location using the specified location ID.
      location => Google::Ads::GoogleAds::V25::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::V25::Utils::ResourceNames::geo_target_constant(
            $location_id)}
      ),
      campaign => $campaign_resource_name
    });

  return
    Google::Ads::GoogleAds::V25::Services::CampaignCriterionService::CampaignCriterionOperation
    ->new({
      create => $campaign_criterion
    });
}
      

حلقه زدن

گوگل ممکن است گاهی اوقات به دلایل مختلف برخی از معیارهای موقعیت مکانی را حذف کند: ممکن است موقعیت مکانی به مناطق کوچک‌تر یا بزرگ‌تر، تغییرات جغرافیایی-سیاسی و غیره تغییر ساختار دهد. برای تعیین اینکه آیا یک موقعیت مکانی ENABLED است یا REMOVAL_PLANNED ، به فیلد status شیء GeoTargetConstant مراجعه کنید.

جستجو بر اساس نام مکان

همچنین می‌توانید با استفاده از 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.V25.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: GoogleAdsClient) -> None:
    gtc_service: GeoTargetConstantServiceClient = client.get_service(
        "GeoTargetConstantService"
    )

    gtc_request: SuggestGeoTargetConstantsRequest = client.get_type(
        "SuggestGeoTargetConstantsRequest"
    )
    gtc_request.locale = LOCALE
    gtc_request.country_code = COUNTRY_CODE

    # The location names to get suggested geo target constants.
    # Type hint for gtc_request.location_names.names is not straightforward
    # as it's part of a complex protobuf object.
    gtc_request.location_names.names.extend(
        ["Paris", "Quebec", "Spain", "Deutschland"]
    )

    results: SuggestGeoTargetConstantsResponse = (
        gtc_service.suggest_geo_target_constants(gtc_request)
    )

    suggestion: GeoTargetConstantSuggestion
    for suggestion in results.geo_target_constant_suggestions:
        geo_target_constant: GeoTargetConstant = 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::V25::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;
}
      

حلقه زدن

کمپین‌های هدفمند برای نزدیکی به یک مکان

مواقعی وجود دارد که ممکن است بخواهید حتی دقیق‌تر از یک شهر یا کشور هدف قرار دهید. برای مثال، ممکن است بخواهید سوپرمارکت‌های خود را در فاصله ۱۰ کیلومتری از محل فروشگاه خود تبلیغ کنید. در چنین مواردی، می‌توانید از هدف‌گیری مجاورتی استفاده کنید. کد ایجاد یک هدف مجاورتی مشابه اضافه کردن یک هدف مکانی است، با این تفاوت که باید به جای یک شیء 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: GoogleAdsClient, customer_id: str, campaign_id: str
) -> CampaignCriterionOperation:
    campaign_service: CampaignServiceClient = client.get_service(
        "CampaignService"
    )

    # Create the campaign criterion.
    campaign_criterion_operation: CampaignCriterionOperation = client.get_type(
        "CampaignCriterionOperation"
    )
    campaign_criterion: CampaignCriterion = 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::V25::Resources::CampaignCriterion->new({
      proximity => Google::Ads::GoogleAds::V25::Common::ProximityInfo->new({
          address => Google::Ads::GoogleAds::V25::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::V25::Services::CampaignCriterionService::CampaignCriterionOperation
    ->new({
      create => $campaign_criterion
    });
}
      

حلقه زدن

بازیابی اهداف جغرافیایی

شما می‌توانید با استفاده از GoogleAdsService.SearchStream اهداف جغرافیایی یک کمپین را بازیابی کنید. گنجاندن campaign_criterion.type و campaign_criterion.resource_name در عبارت SELECT به شما امکان می‌دهد بین معیارهای LOCATION و PROXIMITY تمایز قائل شوید و نام منابع را برای به‌روزرسانی‌ها یا حذف‌های بعدی ثبت کنید.

SELECT
  campaign_criterion.resource_name,
  campaign_criterion.campaign,
  campaign_criterion.type,
  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.proximity.radius_units,
  campaign_criterion.proximity.address.street_address,
  campaign_criterion.proximity.address.city_name,
  campaign_criterion.proximity.address.postal_code,
  campaign_criterion.proximity.address.country_code,
  campaign_criterion.negative
FROM campaign_criterion
WHERE
  campaign_criterion.campaign = 'customers/{customer_id}/campaigns/{campaign_id}'
  AND campaign_criterion.type IN ('LOCATION', 'PROXIMITY')

به‌روزرسانی اهداف جغرافیایی

معیارهای موقعیت مکانی در یک کمپین پس از ایجاد تغییرناپذیر هستند، بنابراین به‌روزرسانی اهداف جغرافیایی یک کمپین مستلزم جایگزینی اهداف منسوخ با اهداف جدید در یک درخواست یکپارچه CampaignCriterionService.MutateCampaignCriteria است:

  1. با استفاده از عبارت GAQL در بخش Retrieve geo-targets، معیارهای LOCATION و PROXIMITY موجود در کمپین را جستجو کنید.
  2. معیارهای موجود را با فهرست هدف مورد نظر خود مقایسه کنید.
  3. برای هر معیار منسوخ‌شده، یک CampaignCriterionOperation با مقدار remove با resource_name معیار موجود بسازید.
  4. برای هر موقعیت مکانی یا هدف مجاورتی جدید، یک CampaignCriterionOperation با create اولیه‌ی LocationInfo یا ProximityInfo جدید بسازید.
  5. هر دو عملیات remove و create در یک فراخوانی MutateCampaignCriteria ارسال کنید تا انتقال به صورت خودکار انجام شود.

اهداف جغرافیایی را حذف کنید

همچنین می‌توانید LocationInfo حذف کنید، اما ProximityInfo خیر. این ویژگی زمانی مفیدتر است که بخواهید یک منطقه را هدف قرار دهید، اما یک زیرمنطقه را حذف کنید (برای مثال، کل ایالات متحده، به جز شهر نیویورک را هدف قرار دهید). برای حذف یک منطقه، فیلد negative را در CampaignCriterion روی true تنظیم کنید.

هدف قرار دادن چندین منطقه جغرافیایی

اگر از LocationGroupInfo استفاده می‌کنید، می‌توانید یک کمپین را برای هدف قرار دادن چندین منطقه جغرافیایی متمرکز بر مکان‌های تعریف‌شده توسط دارایی‌های مکان یا فیلتر شده توسط یک منطقه جغرافیایی فعال کنید:

  • مجموعه‌های دارایی‌های مکانی : یا enable_customer_level_location_asset_set = true (برای هدف قرار دادن مجموعه دارایی‌های مکانی مشتری) یا location_group_asset_sets (برای هدف قرار دادن نام‌های منبع خاص AssetSet ) را تنظیم کنید. این دو فیلد را نمی‌توان با هم تنظیم کرد و هیچ‌کدام را نمی‌توان با geo_target_constants ترکیب کرد.
  • شعاع و واحدها : شعاع در LocationGroupInfo یک ناحیه دایره‌ای اطراف هر مکان تعریف می‌کند و به هر دو radius و radius_units نیاز دارد ( LocationGroupRadiusUnitsEnum ):
    • هنگام استفاده از مجموعه‌های دارایی‌های مکانی ( enable_customer_level_location_asset_set یا location_group_asset_sets )، مقادیر radius_units پشتیبانی شده عبارتند از MILLI_MILES و METERS .
    • هنگام فیلتر کردن بر اساس geo_target_constants (که در آن حداکثر یک شناسه معیار مجاز است و فیلدهای AssetSet تنظیم نشده‌اند)، مقادیر radius_units پشتیبانی شده عبارتند از MILES و METERS .

گزینه‌های پیشرفته موقعیت مکانی با GeoTargetTypeSetting

فراتر از مشخص کردن مکان‌ها برای هدف‌گیری یا حذف، می‌توانید نحوه تطبیق کاربران با این مکان‌ها توسط گوگل ادز را با استفاده از گزینه‌های پیشرفته مکان‌یابی اصلاح کنید. این تنظیمات از طریق Campaign.GeoTargetTypeSetting مدیریت می‌شوند.

این تنظیم شامل دو فیلد است:

  • positive_geo_target_type : نحوه تطبیق کاربران با مکان‌های مورد نظر شما را تعیین می‌کند.
  • negative_geo_target_type : نحوه تطبیق کاربران با مکان‌هایی که شما حذف می‌کنید را تعیین می‌کند.

تنظیمات هدف‌گیری مثبت ( positive_geo_target_type )

شما می‌توانید با استفاده از مقادیر PositiveGeoTargetTypeEnum ، از گزینه‌های زیر برای هدف‌گیری مثبت موقعیت مکانی خود انتخاب کنید:

  • PRESENCE_OR_INTEREST (پیش‌فرض توصیه‌شده) :

    • به افرادی که احتمالاً در مکان‌های مورد نظر شما هستند یا مرتباً در آنها حضور دارند، به علاوه افرادی که به مکان‌های مورد نظر شما علاقه نشان داده‌اند، دسترسی پیدا می‌کند.
    • علاقه می‌تواند از طریق عبارات جستجو، بازدیدهای گذشته یا محتوای مصرف‌شده مرتبط با مکان، نشان داده شود.
    • این گزینه وسیع‌ترین دسترسی را فراهم می‌کند.
  • PRESENCE :

    • فقط به افرادی دسترسی پیدا می‌کند که احتمالاً از نظر فیزیکی در مکان‌های مورد نظر شما حضور دارند یا مرتباً در آنها هستند.
    • این مورد محدودتر و مفیدتر است اگر خدمات یا محصولات شما صرفاً به افرادی که از نظر فیزیکی در یک منطقه حضور دارند محدود باشد.

تنظیمات هدف‌گیری منفی ( negative_geo_target_type )

برای مکان‌هایی که می‌خواهید حذف کنید، از NegativeGeoTargetTypeEnum استفاده می‌کنید:

  • PRESENCE (پیش‌فرض توصیه‌شده) :
    • افرادی را که احتمالاً در مکان‌هایی که حذف کرده‌اید، حضور فیزیکی دارند، مستثنی می‌کند.
    • افراد خارج از مناطق محروم، حتی اگر به آنها علاقه‌مند باشند، ممکن است همچنان تبلیغات شما را ببینند، مشروط بر اینکه با هدف‌گذاری مثبت شما مطابقت داشته باشند.

مدیریت گزینه‌های پیشرفته موقعیت مکانی

شما می‌توانید این تنظیمات را با به‌روزرسانی شیء Campaign.geo_target_type_setting کنترل کنید. مثال زیر ساختار به‌روزرسانی CampaignOperation را نشان می‌دهد که positive_geo_target_type را روی PRESENCE تنظیم می‌کند:

// Conceptual structure for a Campaign update operation
operations {
  update {
    resource_name: "customers/{customer_id}/campaigns/{campaign_id}"
    geo_target_type_setting {
      positive_geo_target_type: PRESENCE
      // negative_geo_target_type remains at its default PRESENCE
    }
  }
  update_mask {
    paths: "geo_target_type_setting.positive_geo_target_type"
  }
}

برای دریافت تنظیمات فعلی، عبارت‌های campaign.geo_target_type_setting.positive_geo_target_type و campaign.geo_target_type_setting.negative_geo_target_type را در عبارت جستجوی GoogleAdsService خود وارد کنید.

با پیکربندی این تنظیمات، شما کنترل دقیق‌تری بر روی افرادی که تبلیغات شما را می‌بینند، بر اساس ارتباط آنها با مکان‌های جغرافیایی که مشخص کرده‌اید، به دست می‌آورید و این امر با اهداف تجاری شما همسوتر می‌شود.

بهترین شیوه‌ها

  • اگر محصول یا خدمات شما صرفاً به افرادی که از نظر فیزیکی در یک مکان حضور دارند محدود می‌شود، PRESENCE انتخاب کنید . برای مثال، فرض کنید از کاربران می‌خواهید که در فروشگاه حضور داشته باشند یا نیاز به تحویل محلی دارند.
  • اگر محصول یا خدمات شما می‌تواند به افرادی که به یک مکان علاقه‌مند هستند، حتی اگر حضور فیزیکی نداشته باشند، نیز سود برساند، گزینه PRESENCE_OR_INTEREST انتخاب کنید. برای مثال، کاربری که قصد تعطیلات دارد، ممکن است به هتل‌های شهر مقصد خود علاقه‌مند باشد.
  • از هدف‌گیری مکانی منفی برای بهبود دسترسی استفاده کنید. اگر ایالات متحده را با PRESENCE_OR_INTEREST هدف قرار می‌دهید، اما به ایالت خاصی ارسال نمی‌کنید، می‌توانید با استفاده از negative=true در معیار LocationInfo ، آن ایالت را مستثنی کنید. این ویژگی در ترکیب با negative_geo_target_type که روی PRESENCE تنظیم شده است، مانع از نمایش تبلیغات شما به کاربران آن ایالت می‌شود، در حالی که همچنان به کاربران خارج از آن ایالت که ممکن است به مکان‌های ایالات متحده علاقه‌مند باشند، دسترسی پیدا می‌کند.

قدم بعدی چیست؟