تبلیغات جستجوی جدید 360
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Search Ads 360 شناسه های جدید را به حساب های کاربری، کمپین ها، گروه های تبلیغاتی، کلمات کلیدی (معیارها) و تبلیغات اختصاص می دهد. دو تغییر رفتار اضافی برای این شناسه ها وجود دارد:
Search Ads 360 جدید یک شناسه مشتری منحصر به فرد جهانی را به حساب های مدیر، مدیر فرعی و مشتری اختصاص می دهد که به ترتیب به عنوان حساب های آژانس، تبلیغ کننده و موتور شناخته می شوند.
Search Ads 360 جدید دیگر شناسه های منحصر به فرد را به کلمات کلیدی و تبلیغات اختصاص نمی دهد.
تبدیل API اکنون شناسه‌های مشتری Search Ads 360 جدید را هر جا که شناسه آژانس، شناسه تبلیغ‌کننده و شناسه‌های حساب موتور پذیرفته شود، می‌پذیرد. اگر یک API مشتری را مشخص کنید، API انتظار دارد شناسه کمپین، شناسه گروه تبلیغات، شناسه کلمه کلیدی و شناسه آگهی، شناسه‌های Search Ads 360 جدید باشند. هنگام استفاده از کلمه کلیدی جدید Search Ads 360 یا شناسه آگهی، باید هر زمان که درخواست شما از کلمه کلیدی یا شناسه آگهی استفاده می کند، شناسه کمپین و گروه تبلیغات مرتبط را مشخص کنید.
وقتی از شناسه Search Ads 360 جدید در درخواست خود استفاده می کنید، پاسخ از شناسه های Search Ads 360 جدید نیز استفاده می کند.
درج/به‌روزرسانی تبدیل
ما از درخواست زیر با استفاده از شناسه Search Ads 360 جدید پشتیبانی می کنیم:
- تبدیل را فقط به یک کلمه کلیدی نسبت دهید
- تبدیل را با
criterionId تبدیل (شناسه کلمه کلیدی) مشخص شده به روز کنید
نقاط پایانی همچنان یکسان است. باید در هر منبع تبدیل، شناسه Search Ads 360 جدید را ارائه کنید: به جای تنظیم agencyId ، advertiserId و engineAccountId ، باید customerId ارائه دهید و در صورت لزوم از شناسه Search Ads 360 جدید در campaignId ، adGroupId ، criterionId ، adId استفاده کنید.
در اینجا نمونه ای از درخواست نحوه استفاده از شناسه جستجوی تبلیغات 360 جدید برای نسبت دادن تبدیل به یک کلمه کلیدی است.
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
،
Search Ads 360 شناسه های جدید را به حساب های کاربری، کمپین ها، گروه های تبلیغاتی، کلمات کلیدی (معیارها) و تبلیغات اختصاص می دهد. دو تغییر رفتار اضافی برای این شناسه ها وجود دارد:
Search Ads 360 جدید یک شناسه مشتری منحصر به فرد جهانی را به حساب های مدیر، مدیر فرعی و مشتری اختصاص می دهد که به ترتیب به عنوان حساب های آژانس، تبلیغ کننده و موتور شناخته می شوند.
Search Ads 360 جدید دیگر شناسه های منحصر به فرد را به کلمات کلیدی و تبلیغات اختصاص نمی دهد.
تبدیل API اکنون شناسه‌های مشتری Search Ads 360 جدید را هر جا که شناسه آژانس، شناسه تبلیغ‌کننده و شناسه‌های حساب موتور پذیرفته شود، می‌پذیرد. اگر یک API مشتری را مشخص کنید، API انتظار دارد شناسه کمپین، شناسه گروه تبلیغات، شناسه کلمه کلیدی و شناسه آگهی، شناسه‌های Search Ads 360 جدید باشند. هنگام استفاده از کلمه کلیدی جدید Search Ads 360 یا شناسه آگهی، باید هر زمان که درخواست شما از کلمه کلیدی یا شناسه آگهی استفاده می کند، شناسه کمپین و گروه تبلیغات مرتبط را مشخص کنید.
وقتی از شناسه Search Ads 360 جدید در درخواست خود استفاده می کنید، پاسخ از شناسه های Search Ads 360 جدید نیز استفاده می کند.
درج/به‌روزرسانی تبدیل
ما از درخواست زیر با استفاده از شناسه Search Ads 360 جدید پشتیبانی می کنیم:
- تبدیل را فقط به یک کلمه کلیدی نسبت دهید
- تبدیل را با
criterionId تبدیل (شناسه کلمه کلیدی) مشخص شده به روز کنید
نقاط پایانی همچنان یکسان است. باید در هر منبع تبدیل، شناسه Search Ads 360 جدید را ارائه کنید: به جای تنظیم agencyId ، advertiserId و engineAccountId ، باید customerId ارائه دهید و در صورت لزوم از شناسه Search Ads 360 جدید در campaignId ، adGroupId ، criterionId ، adId استفاده کنید.
در اینجا نمونه ای از درخواست نحوه استفاده از شناسه جستجوی تبلیغات 360 جدید برای نسبت دادن تبدیل به یک کلمه کلیدی است.
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-05-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-05-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eSearch Ads 360 is updated to assign globally unique customer IDs to manager, sub-manager, and client accounts and no longer assigns unique IDs to keywords and ads.\u003c/p\u003e\n"],["\u003cp\u003eThe Conversion API now accepts new Search Ads 360 customer IDs and expects new Search Ads 360 IDs for campaign, ad group, keyword, and ad IDs when specified.\u003c/p\u003e\n"],["\u003cp\u003eWhen using new Search Ads 360 keyword or ad IDs, the associated campaign and ad group IDs must be provided.\u003c/p\u003e\n"],["\u003cp\u003eThere's a new endpoint for listing conversions using the new Search Ads 360 IDs, requiring a client account customer ID.\u003c/p\u003e\n"],["\u003cp\u003eInserting or updating conversions supports attributing to keywords or updating existing conversions with new Search Ads 360 IDs by providing \u003ccode\u003ecustomerId\u003c/code\u003e and relevant IDs.\u003c/p\u003e\n"]]],["New Search Ads 360 assigns unique customer IDs to accounts and updates ID behavior for campaigns, ad groups, keywords, and ads. The Conversion API now accepts these new customer IDs. When a customer ID is provided, new Search Ads 360 IDs are expected for other IDs. Keyword and ad IDs require associated campaign and ad group IDs in requests. Responses will use the new IDs. There's a new endpoint for listing conversions, using the customer ID with the same parameters. Attributing or updating a conversion to a keyword is done with the customer ID.\n"],null,["# New Search Ads 360\n\nThe new Search Ads 360 assigns new IDs to user accounts, campaigns, ad groups,\nkeywords (criteria), and ads. There are two additional behavior changes for these IDs:\n\n-\n The new Search Ads 360 assigns a globally unique customer ID to manager, sub-manager,\n and client accounts, formally known as agencies, advertisers and engine accounts,\n respectively.\n\n-\n The new Search Ads 360 no longer assigns unique IDs to keywords and ads.\n\n\nThe conversion API now accepts new Search Ads 360 customer IDs wherever agency ID,\nadvertiser ID, and engine account IDs are accepted. If you specify a customer API, the API\nexpects campaign ID, ad group ID, keyword ID, and ad ID to be new Search Ads 360 IDs.\nWhen using new Search Ads 360 keyword or ad IDs, you must specify the associated\ncampaign and ad group IDs whenever your request uses a keyword or ad ID.\n\n\nWhen you use a new Search Ads 360 ID in your request, the response will also use\nthe new Search Ads 360 IDs.\n\nInsert/update conversion\n------------------------\n\nWe support the following request using the new Search Ads 360 ID:\n\n- Attribute a conversion to a keyword only\n- Update conversion with the conversion's `criterionId` (keyword ID) specified\n\n\nThe endpoints are still the same. You should provide the new Search Ads 360\nID in each conversion resource: Instead of setting `agencyId`,\n`advertiserId` and `engineAccountId`, you should provide\n`customerId`, and use the new Search Ads 360 ID in\n`campaignId`, `adGroupId`, `criterionId`,\n`adId` when necessary.\n\n\nHere is the example request of how to use the new Search Ads 360 ID to\nattribute a conversion to a keyword. \n\n```carbon\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n{\n \"conversion\" : [\n {\n \"customerId\": \"123-123-1234\"\n \"campaignId\": \"10000001\",\n \"adGroupId\": \"20000001\",\n \"criterionId\": \"30000001\",\n \"conversionId\": \"floodlight conversion ID 1\",\n \"conversionTimestamp\": \"1660799917714\",\n \"type\": \"ACTION\",\n \"quantityMillis\": \"1000\",\n \"segmentationType\": \"FLOODLIGHT\",\n \"segmentationName\": \"Test\"\n }\n ]\n}\n \n```"]]
