تجربة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُسنِد التجربة الجديدة من "إعلانات شبكة البحث 360" أرقام تعريف جديدة إلى حسابات المستخدمين والحملات والمجموعات الإعلانية
والكلمات الرئيسية (المعايير) والإعلانات. هناك تغييران إضافيان في السلوك لهذَين المعرّفَين:
-
تُحدِّد التجربة الجديدة من "إعلانات شبكة البحث 360" رقم تعريف فريدًا على مستوى العالم للعملاء في الحسابات الإدارية وحسابات المدراء الفرعيين
وحسابات العملاء، والتي تُعرف رسميًا باسم الوكالات والمعلِنين وحسابات محرّكات البحث،
على التوالي.
-
لم تعُد التجربة الجديدة من "إعلانات شبكة البحث 360" تُحدّد أرقام تعريف فريدة للكلمات الرئيسية والإعلانات.
تقبل Conversion API الآن أرقام تعريف العملاء الجديدة في "إعلانات شبكة البحث 360" في أيّ مكان يتم فيه قبول رقم تعريف الوكالة و
رقم تعريف المعلِن وأرقام تعريف حسابات محرّكات البحث. في حال تحديد واجهة برمجة تطبيقات عميل، تفترض واجهة برمجة التطبيقات
أنّ معرّف الحملة ومعرّف المجموعة الإعلانية ومعرّف الكلمة الرئيسية ومعرّف الإعلان هي معرّفات جديدة في "إعلانات شبكة البحث 360".
عند استخدام أرقام تعريف الكلمات الرئيسية أو الإعلانات الجديدة في "إعلانات شبكة البحث 360"، يجب تحديد
معرّفات الحملة والمجموعة الإعلانية المرتبطة بها كلما كان طلبك يستخدم رقم تعريف كلمة رئيسية أو إعلان.
عند استخدام رقم تعريف جديد في "إعلانات شبكة البحث 360" في طلبك، سيستخدم الردّ أيضًا
الأرقام التعريفية الجديدة في "إعلانات شبكة البحث 360".
إدراج/تعديل إحالة ناجحة
نتيح الطلب التالي باستخدام رقم التعريف الجديد في "إعلانات شبكة البحث 360":
- إسناد إحالة ناجحة إلى كلمة رئيسية فقط
- تعديل الإحالة الناجحة مع تحديد
criterionId
(رقم تعريف الكلمة الرئيسية) للإحالة الناجحة
تظل نقاط النهاية كما هي. يجب تقديم رقم تعريف "إعلانات شبكة البحث 360" الجديد
في كلّ مورد إحالة ناجحة: بدلاً من ضبط agencyId،
advertiserId وengineAccountId، يجب تقديم
customerId، واستخدام رقم التعريف الجديد في "إعلانات شبكة البحث 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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```"]]
