القرب
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إضافة هدف قريب إلى حملة
function addProximityTargets(campaignName) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${campaignName}"`) .get(); if (!campaignIterator.hasNext()) { throw new Error(`No campaign with name "${campaignName}" found`); } const campaign = campaignIterator.next(); // Add a proximity target of 20 kilometers around Google New York office. // To obtain coordinates of a given point on Google Maps, // see https://support.google.com/maps/answer/18539 campaign.addProximity(40.741144, -74.002086, 20, 'KILOMETERS'); // You could also add proximity by an address. However, we don't validate // if the address you put matches the given latitude and longitude. It has // no functionality except to change what shows up in the Campaign // Management interface. // Add a proximity target of 10 kilometers around Google Mountain View // office. campaign.addProximity({ latitude: 37.423021, longitude: -122.083739, radius: 10, radiusUnits: 'KILOMETERS', bidModifier: 0.75, address: { streetAddress: '1600 Amphitheatre Parkway', cityName: 'Mountain View', provinceName: 'California', provinceCode: 'CA', postalCode: '94043', countryCode: 'US' } }); }
استرداد قائمة بجميع الأهداف القريبة لحملة
function getTargetedProximities(campaignName) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${campaignName}"`) .get(); if (!campaignIterator.hasNext()) { throw new Error(`No campaign with name "${campaignName}" found`); } const campaign = campaignIterator.next(); return campaign.targeting().targetedProximities().get(); }
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis script provides functions to add and retrieve proximity targets for Google Ads campaigns.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eaddProximityTargets\u003c/code\u003e enables adding location-based targeting by specifying coordinates, radius, and optionally an address for display purposes.\u003c/p\u003e\n"],["\u003cp\u003eYou can target a specific radius around a point using latitude, longitude, and radius with units (e.g., kilometers).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetTargetedProximities\u003c/code\u003e retrieves all existing proximity targets associated with a given campaign.\u003c/p\u003e\n"]]],[],null,["Add a proximity target to a campaign \n\n```gdscript\nfunction addProximityTargets(campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (!campaignIterator.hasNext()) {\n throw new Error(`No campaign with name \"${campaignName}\" found`);\n }\n\n const campaign = campaignIterator.next();\n\n // Add a proximity target of 20 kilometers around Google New York office.\n // To obtain coordinates of a given point on Google Maps,\n // see https://support.google.com/maps/answer/18539\n campaign.addProximity(40.741144, -74.002086, 20, 'KILOMETERS');\n\n // You could also add proximity by an address. However, we don't validate\n // if the address you put matches the given latitude and longitude. It has\n // no functionality except to change what shows up in the Campaign\n // Management interface.\n\n // Add a proximity target of 10 kilometers around Google Mountain View\n // office.\n campaign.addProximity({\n latitude: 37.423021,\n longitude: -122.083739,\n radius: 10,\n radiusUnits: 'KILOMETERS',\n bidModifier: 0.75,\n address: {\n streetAddress: '1600 Amphitheatre Parkway',\n cityName: 'Mountain View',\n provinceName: 'California',\n provinceCode: 'CA',\n postalCode: '94043',\n countryCode: 'US'\n }\n });\n}\n```\n\nGet the list of all proximity targets for a campaign \n\n```gdscript\nfunction getTargetedProximities(campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (!campaignIterator.hasNext()) {\n throw new Error(`No campaign with name \"${campaignName}\" found`);\n }\n\n const campaign = campaignIterator.next();\n return campaign.targeting().targetedProximities().get();\n}\n```"]]