برای افزودن یک یا چند تبدیل،
روش Conversion.insert() را فراخوانی کنید. برای نسبت دادن صحیح تبدیل، درخواست شما
باید نام فعالیت Floodlight را که آگهیدهنده برای گزارش کردن
تبدیلهای آفلاین استفاده میکند، بههمراه شناسه کلیک بازدید یا شناسههای کلیدواژهای
که منجر به تبدیل شده است مشخص کند. برای
اطلاعات درباره دریافت شناسههای Search Ads 360، به شناسهها و
تبدیلهای Search Ads 360 مراجعه کنید.
اطلاعات مربوط به محدودیتهای بارگذاری تبدیلهای گذشته را میتوانید در مرکز راهنمایی Search Ads 360 پیدا کنید.
اگر درخواست Conversion.insert() شما چندین تبدیل را مشخص کند،
Search Ads 360 تلاش میکند هر تبدیل را براساس بهترین تلاش بارگذاری کند، بهجای اینکه
کل دسته را بهعنوان یک تراکنش همهیاهیچ بارگذاری کند. اگر بارگذاری برخیاز تبدیلها در یک
دسته ناموفق باشد، ممکن است بارگذاری بقیه همچنان موفقیتآمیز باشد. بارگذاریهای تبدیل ممکن است بهدلیل درخواست نامعتبر یا خرابیهای موقت شبکه یا سیستم ناموفق باشد. بنابراین،
توصیه میکنیم پاسخ را برای هر تبدیل درجشده بخوانید تا
مطمئن شوید بارگذاری موفقیتآمیز بوده است.
چه زمانی میتوانم از دادههای بارگذاریشده استفاده کنم؟
اگر
conversionTimestamp امروز یا دیروز را برای تبدیل مشخص کنید، سنجههای
تبدیل ظرف یک ساعت پساز بارگذاری در میانای کاربر Search Ads 360 نشان داده خواهد شد. اگر
conversionTimestamp را مشخص کنید که قدیمیتر از دیروز باشد، سنجهها ظرف
چند ساعت بهروزرسانی خواهد شد.
همه مُهرهای زمان را برای تبدیلها به زمان Epoch (که بهعنوان زمان Unix نیز شناخته میشود) تبدیل کنید.
آیا میتوانم فعالیتهای Floodlight را از میانای برنامهسازی کاربردی ایجاد کنم؟
اگر آگهیدهنده هنوز فعالیت Floodlight برای ردیابی تبدیلهای آفلاین ایجاد نکرده است، میتوانید از Campaign Manager API برای ایجاد آن استفاده کنید. نمیتوانید از API برای مشخص کردن اینکه فعالیت Floodlight عمدتاً برای تبدیلهای آفلاین استفاده میشود استفاده کنید، که این یک روال مطلوب است وقتی استراتژیهای پیشنهاد قیمت از دادههای تبدیل استفاده میکنند.
توصیه میکنیم پساز استفاده از API برای ایجاد فعالیت Floodlight، کاربر Search Ads 360 به سیستم Search Ads 360 وارد شود و تنظیمات فعالیت را تغییر دهد تا نشان دهد منبع اصلی تبدیلها فعالیت آفلاین است.
روالهای مطلوب برای افزودن تبدیلها
روالهای مطلوب زیر را برای افزودن تبدیلها توصیه میکنیم:
از کاربر Search Ads 360 بخواهید به سیستم Search Ads 360 وارد شود و تنظیمات هر فعالیت Floodlight را که برای گزارش تبدیلهای آفلاین استفاده میکنید تغییر دهد. تنظیمات باید نشان دهد که منبع اصلی تبدیلها فعالیت آفلاین است. برای دریافت دستورالعملها، مرکز راهنمایی Search Ads 360 را ببینید.
تبدیلها را بهمحض دردسترس قرار گرفتن بارگذاری کنید. اگر تبدیلها را به بازدیدهای خاصی نسبت میدهید، حداقل ۶ ساعت پساز بازدید صبر کنید و سپس تبدیل را بارگذاری کنید. اگر زودتر از ۶ ساعت پساز بازدید بارگذاری کنید، ممکن است Search Ads 360 شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا ۲۴ ساعت صبر کنید تا Search Ads 360 بتواند clickId را تشخیص دهد.
مطمئن شوید که هر بارگذاری حاوی جدیدترین تبدیلها باشد. در یک درخواست بارگذاری، اگر ورودیها ترتیب زمانی نداشته باشند مشکلی ندارد. اما ممکن است استراتژی پیشنهاد قیمت نتواند تبدیلهای قدیمیتری را که بعداً در درخواست دیگری بارگذاری میکنید درنظر بگیرد.
ارسال درخواست درج
میتوانید درخواست Conversion.insert() برای انجام هریک از کارهای زیر ارسال کنید:
- تبدیل را به بازدید خاصی نسبت دهید
- تبدیل را فقط به کلیدواژه نسبت دهید
فیلدهای لازم در درخواست Conversion.insert() به رویداد یا موردی بستگی دارد که تبدیل را به آن نسبت میدهید. بخشهای زیر فیلدهای الزامی و اختیاری را برای هر رویداد یا موردی که میتوانید تبدیل را به آن نسبت دهید فهرست میکند.
تبدیل را به بازدید خاصی نسبت دهید
وقتی مشتری روی یک یا چند آگهی کلیک میکند و به سایت آگهیدهنده میرسد،
Search Ads 360 جلسه کاربر در سایت آگهیدهنده را بازدید درنظر میگیرد.
برای نسبت دادن تبدیل به بازدید، موارد زیر را در درخواست Conversion.insert()
خود مشخص کنید:
قسمتهای الزامی
clickId: شناسه کلیک حساس به حروف بزرگ و کوچک بازدید. در گزارشهای وب آگهیدهنده بهدنبال شناسه کلیک بگردید، یاconversion.click_idتبدیل دیگری را با Search Ads 360 Reporting API جدید بازیابی کنید. Search Ads 360 تبدیل را به کلیدواژه، آگهی، و دیگر اشیای Search Ads 360 که مسئول ایجاد بازدید بودهاند نسبت میدهد.
حداقل ۶ ساعت پساز اینکه Search Ads 360 شناسه کلیک را برای بارگذاری تبدیلها تولید کرد صبر کنید. اگر خطای «شناسه کلیک پیدا نشد» را دریافت کردید، ۲۴ ساعت صبر کنید و سپس تبدیلها را دوباره بارگذاری کنید. همه تبدیلها باید ظرف ۹۰ روز از زمان تولید شناسه کلیک بارگذاری شوند. درغیراینصورت، Search Ads 360 API ممکن است بازدید را تشخیص ندهد.conversionId: برای تبدیلهای آفلاین، تبلیغکنندگان این شناسه را ارائه میدهند. تبلیغکنندگان میتوانند هر شناسهای را که برایشان معنیدار است مشخص کنند. هر تبدیل در درخواست باید شناسه یکتایی را مشخص کند، و ترکیب شناسه و مُهر زمان باید در میان همه تبدیلهای آگهیدهنده یکتا باشد. برای تبدیلهای آنلاین، Search Ads 360 بسته به دستورالعملهای Floodlight تبلیغکننده،dsConversionIdیاfloodlightOrderIdرا در این ویژگی کپی میکند.conversionTimestamp: تاریخ و ساعتی را که تبدیل در آن رخ داده است نشان میدهد. برای مثال، اگر تبدیل در روز جمعه، ۵ اوت ۲۰۱۶ ساعت ۱۱:۵۳:۲۲ صبح بهوقت تابستانی شرقی (GMT -4:00) اتفاق افتاده است، مُهر زمان را در Epoch میلیثانیه مشخص کنید:1470412402000.segmentationType: نوع سیستم تبدیلی را که تبدیل را در آن بارگذاری میکنید مشخص میکند. درحالحاضر فقط تبدیلهای Floodlight پشتیبانی میشود، بنابراین این فیلد همیشه برای مشخص کردنFLOODLIGHTلازم است.segmentationName: نام فعالیت Floodlight که آگهیدهنده از آن برای گزارش تبدیل استفاده میکند.اگر آگهیدهنده شما حاوی فعالیتهایی با نام یکسان باشد (این اتفاق زمانی میافتد که فعالیتها به گروههای Floodlight مختلفی تعلق داشته باشند)، اقدام توصیهشده این است که نام یکی از فعالیتها را تغییر دهید.
یا میتوانید شناسه فعالیت Floodlight را در فیلد
segmentationIdبهجای نام در فیلدsegmentationNameمشخص کنید. از شناسهای استفاده کنید که «مدیر پویش» به فعالیت Floodlight اختصاص داده است. میتوانید این شناسه را با فیلدconversion_action.floodlight_settings.activity_idمیانای برنامهسازی کاربردی گزارشدهی Search Ads 360 جدید بازیابی کنید.segmentationIdکه Search Ads 360 در پاسخ به درخواست تبدیل برمیگرداند نیز پذیرفته میشود.type: نوع تبدیل، یعنیACTIONیاTRANSACTION. تبدیل «کنش» ارزش پولی ندارد، درحالیکه تبدیل «تراکنش» دارد. نمونهها عبارتاند از ثبتنام در فهرست ایمیل (کنش) درمقابل خریدهای تجارت الکترونیک (تراکنش).اگر
TRANSACTIONرا مشخص کنید، باید فیلد زیر را نیز مشخص کنید:revenueMicros: ارزش پولی تبدیل.
فیلدهای اختیاری
quantityMillis: تعداد موارد در این تبدیل. برای مثال، تعداد افرادی که برای خبرنامه ایمیلی ثبتنام کردهاند یا تعداد کل موارد فروختهشده. اگر این فیلد را برای تبدیلهای ACTION مشخص نکنید، Search Ads 360 بهطور خودکار مقدار1000را درج میکند.currencyCode: واحد پول درآمد تراکنش. بهطور پیشفرض، فرض میشود که درآمد به واحد پول آگهیدهنده است. اگر واحد پول دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخصشده را به واحد پول آگهیدهنده تبدیل میکند. بیشتر بدانید
از قالب الفبایی ISO 4217 (۳ نویسه) برای مشخص کردن واحد پول استفاده کنید.
فقط برای تبدیلهای TRANSACTION (تراکنش) قابلاعمال است.customMetricوcustomDimension: دادههای اضافی درباره تبدیل را بارگذاری میکند، مثل کشوری که محصول خریداریشده به آن ارسال میشود، شناسههای محصول، یا حتی مدت تماس تلفنی. درباره بارگذاری داده برای متغیرهای سفارشی Floodlight بیشتر بدانید.deviceType: نوع دستگاهی را که تبدیل در آن رخ داده است مشخص میکند. فهرست مقادیر پذیرفتهشده برای این فیلد را ببینید.
(قالب) JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
جاوا
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); } }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
تبدیل را فقط به کلیدواژه نسبت دهید
اگر شناسه کلیک ندارید، میتوانید تبدیل را مستقیماً به کلیدواژه نسبت دهید. در Search Ads 360 جدید، شناسههای کلیدواژه فقط در گروه آگهی منحصربهفرد هستند، بنابراین باید مجموعه کامل شناسههای Search Ads 360 جدید را که کلیدواژه را شناسایی میکند، بههمراه چند فیلد دیگر مشخص کنید:
قسمتهای الزامی
-
customerId: شناسه مشتری حساب مشتری که حاوی کلیدواژه است، برای مثال123-456-7890. campaignId: شناسه پویشی که حاوی کلیدواژه است.adGroupId: شناسه گروه آگهی که حاوی کلیدواژه است.-
criterionId: شناسه کلیدواژه.اگر تبدیلی
criterionIdرا بدونcustomerId،campaignId، یاadGroupIdمشخص کند، با کد خطای0x0000012Eناموفق میشود. برای اطلاعات درباره دریافت این شناسهها، به شناسهها و تبدیلهای Search Ads 360 مراجعه کنید. conversionId: برای تبدیلهای آفلاین، تبلیغکنندگان این شناسه را ارائه میدهند. تبلیغکنندگان میتوانند هر شناسهای را که برایشان معنیدار است مشخص کنند. هر تبدیل در درخواست باید شناسه یکتایی را مشخص کند، و ترکیب شناسه و مُهر زمان باید در میان همه تبدیلهای آگهیدهنده یکتا باشد. برای تبدیلهای آنلاین، Search Ads 360 بسته به دستورالعملهای Floodlight تبلیغکننده،dsConversionIdیاfloodlightOrderIdرا در این ویژگی کپی میکند.conversionTimestamp: تاریخ و ساعتی را که تبدیل در آن رخ داده است نشان میدهد. برای مثال، اگر تبدیل در روز جمعه، ۵ اوت ۲۰۱۶ ساعت ۱۱:۵۳:۲۲ صبح بهوقت تابستانی شرقی (GMT -4:00) اتفاق افتاده است، مُهر زمان را در Epoch میلیثانیه مشخص کنید:1470412402000.segmentationType: نوع سیستم تبدیلی را که تبدیل را در آن بارگذاری میکنید مشخص میکند. درحالحاضر فقط تبدیلهای Floodlight پشتیبانی میشود، بنابراین این فیلد همیشه برای مشخص کردنFLOODLIGHTلازم است.segmentationName: نام فعالیت Floodlight که آگهیدهنده از آن برای گزارش تبدیل استفاده میکند.اگر آگهیدهنده شما حاوی فعالیتهایی با نام یکسان باشد (این اتفاق زمانی میافتد که فعالیتها به گروههای Floodlight مختلفی تعلق داشته باشند)، اقدام توصیهشده این است که نام یکی از فعالیتها را تغییر دهید.
یا میتوانید شناسه فعالیت Floodlight را در فیلد
segmentationIdبهجای نام در فیلدsegmentationNameمشخص کنید. از شناسهای استفاده کنید که «مدیر پویش» به فعالیت Floodlight اختصاص داده است. میتوانید این شناسه را با فیلدconversion_action.floodlight_settings.activity_idمیانای برنامهسازی کاربردی گزارشدهی Search Ads 360 جدید بازیابی کنید.segmentationIdکه Search Ads 360 در پاسخ به درخواست تبدیل برمیگرداند نیز پذیرفته میشود.type: نوع تبدیل، یعنیACTIONیاTRANSACTION. تبدیل «کنش» ارزش پولی ندارد، درحالیکه تبدیل «تراکنش» دارد. نمونهها عبارتاند از ثبتنام در فهرست ایمیل (کنش) درمقابل خریدهای تجارت الکترونیک (تراکنش).اگر
TRANSACTIONرا مشخص کنید، باید فیلد زیر را نیز مشخص کنید:revenueMicros: ارزش پولی تبدیل.
فیلدهای اختیاری
quantityMillis: تعداد موارد در این تبدیل. برای مثال، تعداد افرادی که برای خبرنامه ایمیلی ثبتنام کردهاند یا تعداد کل موارد فروختهشده. اگر این فیلد را برای تبدیلهای ACTION مشخص نکنید، Search Ads 360 بهطور خودکار مقدار1000را درج میکند.currencyCode: واحد پول درآمد تراکنش. بهطور پیشفرض، فرض میشود که درآمد به واحد پول آگهیدهنده است. اگر واحد پول دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخصشده را به واحد پول آگهیدهنده تبدیل میکند. بیشتر بدانید
از قالب الفبایی (۳ نویسهای) ISO 4217 برای مشخص کردن واحد پول استفاده کنید.
فقط برای تبدیلهای TRANSACTION (تراکنش) قابلاعمال است.customMetricوcustomDimension: دادههای اضافی درباره تبدیل را بارگذاری میکند، مثل کشوری که محصول خریداریشده به آن ارسال میشود، شناسههای محصول، یا حتی مدت تماس تلفنی. درباره بارگذاری داده برای متغیرهای سفارشی Floodlight بیشتر بدانید.deviceType: نوع دستگاهی را که تبدیل در آن رخ داده است مشخص میکند. فهرست مقادیر پذیرفتهشده برای این فیلد را ببینید.
(قالب) JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "customerId": "123-456-7890", // Replace with your ID "campaignId": "14660344555", // Replace with your ID "adGroupId": "105138634255", // Replace with your ID "criterionId": "948710340465", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
جاوا
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'customerId': '123-456-7890', // Replace with your ID 'campaignId': '14660344555', // Replace with your ID 'adGroupId': '105138634255', // Replace with your ID 'criterionId': '948710340465', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
بارگذاری دادهها از مدل ارجاعی طرف سوم
مدل اسنادی اعتبار تبدیل را بین همه فعالیتهای موجود در مسیر تبدیل توزیع میکند. برای مثال، اگر مصرفکنندهای قبلاز تبدیل روی آگهی جستجوی پولی، آگهی تصویری، و آگهی جستجوی پولی دیگری کلیک کند، مدل اسنادی خطی به هر کلیک ۳۳٪ از اعتبار تبدیل را میدهد.
درحالیکه Search Ads 360 مدلهای اسنادی ارائه میدهد، اگر از سرویس طرف سوم یا سرویسی که خودتان برای توزیع اعتبار به کلیکها توسعه دادهاید استفاده میکنید، میتوانید دادههای اسنادی طرف سوم را در Search Ads 360 بارگذاری کنید و از این دادهها در گزارشها و راهبردهای پیشنهاد قیمت Search Ads 360 استفاده کنید.
قبلاز شروع
در «مدیر پویش»، مدل اسنادی سفارشی ایجاد کنید و مدل را به Search Ads 360 وارد کنید. مطمئن شوید نام مدل را External Attribution Model بگذارید. این کار به ویژگیهای Search Ads 360 امکان میدهد تشخیص دهند که مدل اسنادی به دادههای تبدیل بارگذاریشده شما اعمال شده است. بیشتر بدانید
قسمتهای الزامی
برای اعمال مدل اسنادی طرف سوم به تبدیل، همه موارد زیر را در درخواست Conversion.insert() خود مشخص کنید:
clickId: شناسه کلیک حساس به حروف بزرگ و کوچک بازدید. در گزارشهای وب آگهیدهنده بهدنبال شناسه کلیک بگردید، یاconversion.click_idتبدیل دیگری را با Search Ads 360 Reporting API جدید بازیابی کنید. Search Ads 360 تبدیل را به کلیدواژه، آگهی، و دیگر اشیای Search Ads 360 که مسئول ایجاد بازدید بودهاند نسبت میدهد.
حداقل ۳۰ دقیقه صبر کنید تا «آگهیهای جستجوی ۳۶۰» شناسه کلیک را قبلاز بارگذاری تبدیل با شناسه تولید کند. درغیراینصورت، Search Ads 360 API ممکن است بازدید را تشخیص ندهد.attributionModel: روی مدل ارجاع خارجی تنظیم شده است. بیشتر بدانیدcountMillis: مقدار اعتبار تبدیل برای توزیع به این کلیک. فقط درصورتی قابلاجرا است که درخواست شامل فیلدattributionModelنیز باشد.این را با
quantityMillisاشتباه نگیرید، فیلدی اختیاری که تعداد موارد در تبدیل را مشخص میکند (مثل تعداد موارد در خرید سبد خرید).conversionId: برای تبدیلهای آفلاین، تبلیغکنندگان این شناسه را ارائه میدهند. تبلیغکنندگان میتوانند هر شناسهای را که برایشان معنیدار است مشخص کنند. هر تبدیل در درخواست باید شناسه یکتایی را مشخص کند، و ترکیب شناسه و مُهر زمان باید در میان همه تبدیلهای آگهیدهنده یکتا باشد. برای تبدیلهای آنلاین، Search Ads 360 بسته به دستورالعملهای Floodlight تبلیغکننده،dsConversionIdیاfloodlightOrderIdرا در این ویژگی کپی میکند.conversionTimestamp: تاریخ و ساعتی را که تبدیل در آن رخ داده است نشان میدهد. برای مثال، اگر تبدیل در روز جمعه، ۵ اوت ۲۰۱۶ ساعت ۱۱:۵۳:۲۲ صبح بهوقت تابستانی شرقی (GMT -4:00) اتفاق افتاده است، مُهر زمان را در Epoch میلیثانیه مشخص کنید:1470412402000.segmentationType: نوع سیستم تبدیلی را که تبدیل را در آن بارگذاری میکنید مشخص میکند. درحالحاضر فقط تبدیلهای Floodlight پشتیبانی میشود، بنابراین این فیلد همیشه برای مشخص کردنFLOODLIGHTلازم است.segmentationName: نام فعالیت Floodlight که آگهیدهنده از آن برای گزارش تبدیل استفاده میکند.اگر آگهیدهنده شما حاوی فعالیتهایی با نام یکسان باشد (این اتفاق زمانی میافتد که فعالیتها به گروههای Floodlight مختلفی تعلق داشته باشند)، اقدام توصیهشده این است که نام یکی از فعالیتها را تغییر دهید.
یا میتوانید شناسه فعالیت Floodlight را در فیلد
segmentationIdبهجای نام در فیلدsegmentationNameمشخص کنید. از شناسهای استفاده کنید که «مدیر پویش» به فعالیت Floodlight اختصاص داده است. میتوانید این شناسه را با فیلدconversion_action.floodlight_settings.activity_idمیانای برنامهسازی کاربردی گزارشدهی Search Ads 360 جدید بازیابی کنید.segmentationIdکه Search Ads 360 در پاسخ به درخواست تبدیل برمیگرداند نیز پذیرفته میشود.type: نوع تبدیل، یعنیACTIONیاTRANSACTION. تبدیل «کنش» ارزش پولی ندارد، درحالیکه تبدیل «تراکنش» دارد. نمونهها عبارتاند از ثبتنام در فهرست ایمیل (کنش) درمقابل خریدهای تجارت الکترونیک (تراکنش).اگر
TRANSACTIONرا مشخص کنید، باید فیلد زیر را نیز مشخص کنید:revenueMicros: ارزش پولی تبدیل.
اگر درآمد تبدیل را پیگیری میکنید، مطمئن شوید که مدل شما درآمد را در هر نقطه تماس در مسیر تبدیل توزیع میکند. برای مثال، اگر مدل شما از رویکرد خطی استفاده میکند (توزیع یکسان درآمد در هر نقطه تماس)، در مسیر تبدیلی که شامل ۳ کلیک آگهی است، هر کلیک با ۳۳٪ از تبدیل نسبت داده میشود. اگر تبدیل ۱۰۰ دلار درآمد کسب کرده است، مطمئن شوید که مدل شما ۳۳ دلار از درآمد را به هر کلیک اختصاص میدهد، و مطمئن شوید که revenueMicros فقط ۳۳ دلار از درآمد را برای هر کلیک مشخص میکند.
فیلدهای اختیاری
quantityMillis: تعداد موارد در این تبدیل. برای مثال، تعداد افرادی که برای خبرنامه ایمیلی ثبتنام کردهاند یا تعداد کل موارد فروختهشده. اگر این فیلد را برای تبدیلهای ACTION مشخص نکنید، Search Ads 360 بهطور خودکار مقدار1000را درج میکند.currencyCode: واحد پول درآمد تراکنش. بهطور پیشفرض، فرض میشود که درآمد به واحد پول آگهیدهنده است. اگر واحد پول دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخصشده را به واحد پول آگهیدهنده تبدیل میکند. بیشتر بدانید
از قالب الفبایی (۳ نویسهای) ISO 4217 برای مشخص کردن واحد پول استفاده کنید.
فقط برای تبدیلهای TRANSACTION (تراکنش) قابلاعمال است.customMetricوcustomDimension: دادههای اضافی درباره تبدیل را بارگذاری میکند، مثل کشوری که محصول خریداریشده به آن ارسال میشود، شناسههای محصول، یا حتی مدت تماس تلفنی. درباره بارگذاری داده برای متغیرهای سفارشی Floodlight بیشتر بدانید.deviceType: نوع دستگاهی را که تبدیل در آن رخ داده است مشخص میکند. فهرست مقادیر پذیرفتهشده برای این فیلد را ببینید.
مثال
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
مدیریت پاسخهای Search Ads 360
پاسخ Search Ads 360 تنها درصورتی نشاندهنده موفقیت است که همه تبدیلهای موجود در درخواست باموفقیت اعتبارسنجی و بارگذاری شده باشند.
اگر درخواست موفقیتآمیز باشد
اگر درخواست موفقیتآمیز باشد، پاسخ شامل نمایش داخلی کامل Search Ads 360 برای هر تبدیل بارگذاریشده است. این نمایش از شناسههای جدید Search Ads 360 استفاده میکند: شناسه مشتری حساب مشتری، و شناسه پویش، شناسه گروه آگهی، شناسه کلیدواژه (معیار)، و شناسه آگهی که تبدیل به آن نسبت داده شده است.
در اینجا نمونه پاسخی برای تبدیلی که به بازدید نسبت داده شده است آورده شده است:
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"customerId": "123-456-7890",
"campaignId": "14660344555",
"adGroupId": "105138634255",
"criterionId": "948710340465",
"adId": "562719339005",
"clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
"conversionId": "test_20130906_04",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "10000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368",
"floodlightOrderId": "test_20130906_04",
"countMillis": "1000",
"deviceType": "DESKTOP"
},
...
]
}
پاسخ فقط شامل شناسههایی است که برای تبدیل اعمال میشود. برای مثال،
پاسخ برای تبدیلی که فقط به کلیدواژه نسبت داده شده است شامل
clickId و adId نمیشود.
اگر درخواست موفقیتآمیز نباشد
اگر یک یا چند تبدیل اعتبارسنجی یا بارگذاری نشود، پاسخ شامل پیامهایی برای هر بارگذاری تبدیل ناموفق است. پاسخ حاوی پیامهایی درباره تبدیلهایی که باموفقیت بارگذاری شدهاند نیست.
در اینجا نمونه پاسخی به درخواستی که کاملاً موفقیتآمیز نبوده است آورده شده است:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
هر پیام خرابی شامل دو فیلد مهم است: دلیل و پیام خطای دقیق. فیلد دلیل میتواند حاوی requestValidation، internalError، transactionFailed، یا lateStageRequestError باشد.
خطاهای requestValidation
خطاهای requestValidation نشاندهنده مشکلات داده در درخواست بارگذاری تبدیل است (برای مثال، تبدیل قبلاً بارگذاری شده است یا clickId پیدا نمیشود). در این نوع خطا، جزئیات پیام حاوی دو مورد است:
- کد شانزدهشانزدهی که نوع خطا را مشخص میکند. میتوانید از این کد در دستورگان خودتان برای شناسایی خطاها استفاده کنید.
- شرح خطای اعتبارسنجی.
برای اطلاعات بیشتر، فهرست کدها و توضیحات را که Search Ads 360 میتواند برای خطاهای بارگذاری تبدیل برگرداند ببینید.
انواع دیگر خطاها
همه انواع دیگر خطاها (internalError، transactionFailed، یا lateStageRequestError) نشان میدهند که مشکلی داخلی در Search Ads 360 وجود دارد.
پاسخ دادن به خطا
اگر درخواست ناموفق بود، بعداً کل تماس درخواست را دوباره ارسال کنید. Search Ads 360 خطاهای requestValidation را برای هر تبدیلی که قبلاً بارگذاری شده است گزارش خواهد کرد، اما تلاش میکند تبدیلهای باقیمانده را بارگذاری کند.
اگر پساز ارسال مجدد همچنان خطا میبینید، برای کسب اطلاعات درباره نحوه ادامه کار، بخش عیبیابی را مشاهده کنید.