الاستهداف حسب الموقع الجغرافي

يصف هذا الدليل الاستهداف حسب الموقع الجغرافي، وكيفية استخدام Google Ads API لإضافة الاستهداف حسب الموقع الجغرافي لحملاتك واسترداده وتعديله.

للحصول على معلومات عن حدود الاستهداف، يُرجى الاطّلاع على قسم "حدود الاستهداف" في مقالة لمحة عن حدود حسابات "إعلانات Google".

ما أهمية استهداف الموقع الجغرافي؟

يسمح لك الاستهداف حسب الموقع الجغرافي بعرض الإعلانات للمستخدِمين في منطقة جغرافية معيّنة. على سبيل المثال، لنفترض أنّك تُعلن عن سلسلة من محلات السوبرماركت. بدون الاستهداف حسب الموقع الجغرافي، ستظهر إعلاناتك في جميع المناطق حول العالم، وقد تتلقّى نقرات من مستخدِمين في مناطق لا تتوفّر فيها محلات السوبرماركت. يؤدي ذلك إلى تكبّد تكلفة بدون إمكانية تحقيق عائد على الاستثمار. باستخدام الاستهداف حسب الموقع الجغرافي، لا تعرض حملاتك الإعلانات إلا في المناطق التي تتوفّر فيها محلات سوبرماركت مفتوحة. يسمح لك هذا النهج أيضًا باستهداف العملاء الذين يبحثون عن محلات سوبرماركت محليًا بشكلٍ مباشر.

يسمح لك Google Ads API باستهداف إعلاناتك حسب البلد أو المنطقة أو النطاق الجغرافي المحيط ب نقطة جغرافية معيّنة.

استهداف الحملات جغرافيًا لمنطقة معيّنة

يمكنك استهداف الحملات لأي منطقة جغرافية تتيح فيها "إعلانات Google" الاستهداف حسب الموقع الجغرافي، مثل بلد أو ولاية أو مدينة أو منطقة بريدية. يتم تحديد كل موقع جغرافي قابل للاستهداف بشكلٍ فريد من خلال رقم تعريف المعيار. يمكنك البحث عن رقم تعريف المعيار باستخدام GeoTargetConstantService.SuggestGeoTargetConstants. يكون resource_name لكل GeoTargetConstant على شكل geoTargetConstants/{Criterion ID}. على سبيل المثال، قيمة resource_name لولاية نيويورك هي geoTargetConstants/21167.

يمكنك إضافة المواقع الجغرافية المستهدفة إلى حملاتك باستخدام الـ CampaignCriterionService (أو على مستوى المجموعة الإعلانية باستخدام AdGroupCriterion لأنواع الحملات المتوافقة، مثل "حملات زيادة الطلب" التي تم تفعيل 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();
}
      

#C

private CampaignCriterion buildLocationCriterion(long locationId,
    string campaignResourceName)
{
    GeoTargetConstantName location = new GeoTargetConstantName(locationId.ToString());
    return new CampaignCriterion()
    {
        Campaign = campaignResourceName,
        Location = new LocationInfo()
        {
            GeoTargetConstant = location.ToString()
        }
    };
}
      

PHP

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]);
}
      

Python

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
      

Ruby

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
      

Perl

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
    });
}
      

curl

قد توقف Google أحيانًا بعض معايير الموقع الجغرافي لأسباب مختلفة: قد تتم إعادة هيكلة الموقع الجغرافي إلى مناطق أصغر أو أكبر، أو قد تحدث تغييرات جغرافية وسياسية، وما إلى ذلك. يُرجى الرجوع إلى الحقل status في عنصر GeoTargetConstant لتحديد ما إذا كان الموقع الجغرافي ENABLED أو REMOVAL_PLANNED.

البحث حسب اسم الموقع الجغرافي

يمكنك أيضًا البحث عن رقم تعريف المعيار حسب اسم الموقع الجغرافي باستخدام 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());
    }
  }
}
      

#C

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;
    }
}
      

PHP

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
        );
    }
}
      

Python

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})."
        )
      

Ruby

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
      

Perl

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;
}
      

curl

استهداف الحملات حسب النطاق الجغرافي المحيط بموقع جغرافي

في بعض الأحيان، قد تحتاج إلى الاستهداف بدقة أكبر من مدينة أو بلد. على سبيل المثال، قد تريد الإعلان عن محلات السوبرماركت ضمن نطاق 10 كيلومترات من موقع متجرك. في مثل هذه الحالات، يمكنك استخدام الاستهداف حسب النطاق الجغرافي. يشبه الرمز البرمجي لإنشاء نطاق جغرافي مستهدَف إضافة موقع جغرافي مستهدَف، باستثناء أنّه عليك إنشاء عنصر ProximityInfoبدلاً من عنصر LocationInfo.

جافا

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();
}
      

#C

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
    };
}
      

PHP

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]);
}
      

Python

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
      

Ruby

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
      

Perl

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
    });
}
      

curl

استرداد الأهداف الجغرافية

يمكنك استرداد المواقع الجغرافية المستهدفة لحملة باستخدام 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 في استرداد الأهداف الجغرافية للاستعلام عن معيارَي 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

بالإضافة إلى تحديد المواقع الجغرافية التي تريد استهدافها أو استبعادها، يمكنك تحسين طريقة مطابقة "إعلانات Google" للمستخدِمين مع هذه المواقع الجغرافية باستخدام خيارات الموقع الجغرافي المتقدّمة. تتم إدارة هذه الإعدادات من خلال 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، يمنع ذلك ظهور إعلاناتك للمستخدِمين في تلك الولاية، مع الاستمرار في الوصول إلى المستخدِمين خارج تلك الولاية الذين قد يكونون مهتمّين بالمواقع الجغرافية في الولايات المتحدة.

الخطوات التالية