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

يصف هذا الدليل الاستهداف حسب الموقع الجغرافي، وكيفية استخدام 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::V26::Resources::CampaignCriterion->new({
      # Create a location using the specified location ID.
      location => Google::Ads::GoogleAds::V26::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::V26::Utils::ResourceNames::geo_target_constant(
            $location_id)}
      ),
      campaign => $campaign_resource_name
    });

  return
    Google::Ads::GoogleAds::V26::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.V26.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::V26::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::V26::Resources::CampaignCriterion->new({
      proximity => Google::Ads::GoogleAds::V26::Common::ProximityInfo->new({
          address => Google::Ads::GoogleAds::V26::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::V26::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. يمكنك الاستعلام عن معايير LOCATION وPROXIMITY الحالية للحملة باستخدام طلب بحث GAQL في استرداد المواقع الجغرافية المستهدَفة.
  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، يمنع ذلك عرض إعلاناتك للمستخدمين في تلك الولاية، مع الاستمرار في الوصول إلى المستخدمين خارج تلك الولاية الذين قد يكونون مهتمين بالمواقع الجغرافية في الولايات المتحدة.

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