تبدیل های جدید اضافه کنید

برای افزودن یک یا چند تبدیل، متد Conversion.insert() را فراخوانی کنید. برای نسبت دادن درست تبدیل، درخواست شما باید نام فعالیت Floodlight را که تبلیغ‌کننده برای گزارش تبدیل‌های آفلاین از آن استفاده می‌کند، به همراه شناسه کلمه کلیدی، تبلیغ و احتمالاً کلیکی که منجر به تبدیل شده است، مشخص کند. برای کسب اطلاعات در مورد دریافت شناسه های Search Ads 360، به Search Ads 360 IDs and Conversions مراجعه کنید.

اطلاعات مربوط به محدودیت‌های آپلود تبدیل‌های تاریخی را می‌توانید در مرکز راهنمای Search Ads 360 بیابید.

اگر درخواست Conversion.insert() شما چندین تبدیل را مشخص می کند، Search Ads 360 سعی می کند هر تبدیل را بر اساس بهترین تلاش به جای آپلود کل دسته به عنوان یک تراکنش همه یا هیچ، آپلود کند. اگر برخی از تبدیل‌ها در دسته‌ای بارگذاری نشوند، برخی دیگر ممکن است همچنان با موفقیت آپلود شوند. آپلودهای تبدیل ممکن است به دلیل درخواست نامعتبر یا خرابی شبکه یا سیستم گذرا با شکست مواجه شوند. بنابراین، برای اطمینان از موفقیت آمیز بودن آپلود، توصیه می کنیم پاسخ هر تبدیل درج شده را بخوانید .

چه مدت می توانم از داده های بارگذاری شده استفاده کنم؟

اگر conversionTimestamp امروز یا دیروز را برای تبدیل مشخص کنید، معیارهای تبدیل در جستجوی Ads 360 UI ظرف یک ساعت پس از آپلود نشان داده می‌شوند. اگر یک conversionTimestamp قدیمی‌تر از دیروز مشخص کنید، معیارها ظرف چند ساعت به‌روزرسانی می‌شوند.

همه مُهرهای زمانی تبدیل‌ها را به زمان عصر (همچنین به عنوان زمان یونیکس شناخته می‌شود) تبدیل کنید.

آیا می توانم فعالیت های Floodlight را از API ایجاد کنم؟

اگر تبلیغ‌کننده هنوز یک فعالیت Floodlight برای ردیابی تبدیل‌های آفلاین ایجاد نکرده است، می‌توانید از Campaign Manager API برای ایجاد آن استفاده کنید . نمی‌توانید از API برای تعیین اینکه فعالیت Floodlight عمدتاً برای تبدیل‌های آفلاین استفاده می‌شود، استفاده کنید، که بهترین روش زمانی است که استراتژی‌های پیشنهاد قیمت از داده‌های تبدیل استفاده می‌کنند.

توصیه می‌کنیم پس از استفاده از API برای ایجاد یک فعالیت Floodlight ، کاربر Search Ads 360 وارد Search Ads 360 شود و تنظیمات فعالیت را تغییر دهد تا نشان دهد منبع اصلی تبدیل‌ها، فعالیت آفلاین است .

بهترین روش ها برای افزودن تبدیل

ما بهترین روش‌های زیر را برای افزودن تبدیل‌ها توصیه می‌کنیم:

  1. از یک کاربر Search Ads 360 بخواهید وارد Search Ads 360 شود و تنظیمات را برای هر فعالیت Floodlight که برای گزارش تبدیل‌های آفلاین استفاده می‌کنید تغییر دهد. تنظیمات باید نشان دهند که منبع اصلی تبدیل، فعالیت آفلاین است. برای دستورالعمل ها به مرکز راهنمای Search Ads 360 مراجعه کنید.

  2. تبدیل ها را به محض در دسترس بودن آپلود کنید. اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید ، قبل از آپلود تبدیل، حداقل 30 دقیقه پس از بازدید منتظر بمانید. اگر زودتر از 30 دقیقه پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 4 ساعت صبر کنید تا Search Ads 360 بتواند شناسه کلیک را تشخیص دهد.

    مطمئن شوید که هر بارگذاری حاوی آخرین تبدیل‌ها باشد . در یک درخواست آپلود، اگر ورودی‌ها خارج از ترتیب زمانی باشند، اشکالی ندارد. اما یک استراتژی پیشنهادی ممکن است نتواند تبدیل‌های قدیمی‌تری را که بعداً در یک درخواست دیگر آپلود می‌کنید، در نظر بگیرد.

  3. اگر قبل از آپلود تبدیل‌ها برای فعالیت Floodlight بیش از 24 ساعت صبر می‌کنید، یک مهر زمانی در دسترس بودن ارسال کنید .

    مهر زمانی در دسترس بودن باید یکی از موارد زیر باشد:

    • اگر در 24 ساعت گذشته تبدیل‌هایی را ثبت کرده‌اید اما هنوز آنها را آپلود نکرده‌اید، مهر زمانی باید زمانی باشد که آخرین تبدیل آپلود شده انجام شده است . این به Search Ads 360 می‌گوید که ممکن است در 24 ساعت گذشته تبدیل‌ها رخ داده باشد، اما شما هنوز داده‌ای را ارائه نکرده‌اید. استراتژی‌های پیشنهاد قیمت و سایر سیستم‌های خودکار، سابقه عملکرد را فقط تا آخرین تبدیلی که آپلود کرده‌اید در نظر می‌گیرند.
    • اگر در 24 ساعت گذشته هیچ تبدیلی رخ نداده است، مهر زمانی باید زمان و تاریخ فعلی باشد. این به Search Ads 360 می گوید که در 24 ساعت گذشته هیچ تبدیلی رخ نداده است. استراتژی‌های پیشنهاد قیمت و سایر سیستم‌های خودکار، ۲۴ ساعت گذشته - یک روز کامل بدون تبدیل - را به‌عنوان بخشی از تاریخچه عملکرد شامل می‌شوند.

درخواست درج ارسال کنید

برای انجام یکی از موارد زیر می توانید یک درخواست Conversion.insert() ارسال کنید:

  • یک تبدیل را به یک بازدید خاص نسبت دهید
  • تبدیل به یک کلمه کلیدی و تبلیغ را نسبت دهید
  • تبدیل را فقط به یک کلمه کلیدی نسبت دهید
  • در کمپین خرید، تبدیل به یک محصول را نسبت دهید

فیلدهایی که در درخواست Conversion.insert() مورد نیاز هستند به رویداد یا موردی که تبدیل را به آن نسبت می دهید بستگی دارد. بخش‌های زیر فیلدهای ضروری و اختیاری را برای هر رویداد یا موردی که می‌توانید تبدیل به آن نسبت دهید، فهرست می‌کند.

یک تبدیل را به یک بازدید خاص نسبت دهید

وقتی مشتری روی یک یا چند آگهی کلیک می‌کند و در سایت تبلیغ‌کننده قرار می‌گیرد، Search Ads 360 جلسه کاربر در سایت آگهی‌دهنده را یک بازدید در نظر می‌گیرد. برای نسبت دادن یک تبدیل به یک بازدید، موارد زیر را در درخواست Conversion.insert() خود مشخص کنید:

فیلدهای مورد نیاز

  • clickId : شناسه کلیک حساس به حروف کوچک و بزرگ بازدید. در گزارش‌های وب تبلیغ‌کننده، شناسه کلیک یا تبدیل‌های فهرست را جستجو کنید و از یک شناسه کلیک از یک تبدیل دیگر استفاده کنید. Search Ads 360 تبدیل را به کلمه کلیدی، تبلیغ و سایر اشیاء Search Ads 360 که مسئول ایجاد بازدید بودند نسبت می دهد.
    حداقل 30 دقیقه صبر کنید پس از اینکه Search Ads 360 شناسه کلیکی برای آپلود تبدیل ایجاد کرد. اگر خطای «شناسه کلیک یافت نشد» را دریافت کردید، ۴ ساعت صبر کنید و سپس تبدیل‌ها را دوباره آپلود کنید. همه تبدیل‌ها باید ظرف 90 روز پس از ایجاد شناسه کلیک آپلود شوند. در غیر این صورت، Search Ads 360 API ممکن است بازدید را تشخیص ندهد.
  • conversionId : برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد. برای تبدیل‌های آنلاین، Search Ads 360 بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
  • conversionTimestamp : تاریخ و زمانی را که تبدیل در آن رخ داده است را نشان می دهد. به عنوان مثال، اگر تبدیل در جمعه، 05 اوت 2016، ساعت 11:53:22 صبح به وقت تابستانی شرقی (GMT -4:00) انجام شود، مهر زمانی را بر حسب میلی‌ثانیه مشخص کنید: 1470412402000 .
  • segmentationType : نوع سیستم تبدیلی را که تبدیل را در آن آپلود می کنید مشخص می کند. در حال حاضر فقط تبدیل‌های Floodlight پشتیبانی می‌شوند، بنابراین این فیلد برای تعیین FLOODLIGHT همیشه مورد نیاز است.
  • segmentationName : نام فعالیت Floodlight که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

    اگر تبلیغ‌کننده شما دارای فعالیت‌هایی با همین نام است (اگر فعالیت‌ها متعلق به گروه‌های مختلف Floodlight باشند، این اتفاق می‌افتد)، اقدام توصیه‌شده تغییر نام یکی از فعالیت‌ها است.

    از طرف دیگر، اگر می‌دانید شناسه Search Ads 360 به یک فعالیت Floodlight اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationId ، شناسه را در segmentationName مشخص کنید. (Campaign Manager همچنین یک شناسه به فعالیت Floodlight اختصاص می دهد، اما شناسه Campaign Manager با شناسه Search Ads 360 متفاوت است و نمی توان از آن برای نسبت دادن به تبدیل ها استفاده کرد.) برای مشاهده شناسه Search Ads 360 برای یک فعالیت Floodlight، یک تبدیل را دانلود کنید. گزارش ( از رابط کاربری Search Ads 360 یا API گزارش ). اگر حداقل یک تبدیل به فعالیت Floodlight در بازه زمانی گزارش نسبت داده شده باشد، شناسه Search Ads 360 را در گزارش خواهید دید.

  • type : نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION ارزش پولی ندارد، در حالی که تبدیل TRANSACTION ارزش پولی ندارد. به عنوان مثال، ثبت نام در لیست ایمیل (ACTION) در مقابل خریدهای تجارت الکترونیک (TRANSACTION) است.

    اگر TRANSACTION مشخص کنید، باید فیلد زیر را نیز مشخص کنید:

    • revenueMicros : ارزش پولی تبدیل.

فیلدهای اختیاری

  • quantityMillis : تعداد اقلام در این تبدیل. به عنوان مثال، تعداد افرادی که برای یک خبرنامه ایمیلی ثبت نام کرده اند یا تعداد کل اقلام فروخته شده. اگر این فیلد را برای تبدیل‌های ACTION مشخص نکنید، Search Ads 360 به‌طور خودکار مقدار 1000 را وارد می‌کند.
  • currencyCode : واحد پولی درآمد یک تراکنش. به‌طور پیش‌فرض، درآمد به واحد پولی تبلیغ‌کننده در نظر گرفته می‌شود. اگر ارز دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخص شده را به واحد پول تبلیغ‌کننده تبدیل می‌کند. بیشتر بدانید
    برای تعیین واحد پول از قالب الفبای ISO 4217 (3 کاراکتر) استفاده کنید.
    فقط برای تبدیل های 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());
    }
  }

پایتون

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())

تبدیل به یک کلمه کلیدی و تبلیغ را نسبت دهید

به جای نسبت دادن یک تبدیل به یک بازدید خاص، می توانید با مشخص کردن موارد زیر در درخواست Conversion.insert() خود، به یک آگهی و کلمه کلیدی نسبت دهید:

فیلدهای مورد نیاز

  • شناسه‌های Search Ads 360 برای آژانس، تبلیغ‌کننده، حساب موتور، کمپین، گروه تبلیغات، کلمه کلیدی (معیار) و آگهی. برای کسب اطلاعات در مورد دریافت این شناسه‌ها، به Search Ads 360 IDs and Conversions مراجعه کنید.
  • conversionId : برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد. برای تبدیل‌های آنلاین، Search Ads 360 بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
  • conversionTimestamp : تاریخ و زمانی را که تبدیل در آن رخ داده است را نشان می دهد. به عنوان مثال، اگر تبدیل در جمعه، 05 اوت 2016، ساعت 11:53:22 صبح به وقت تابستانی شرقی (GMT -4:00) انجام شود، مهر زمانی را بر حسب میلی‌ثانیه مشخص کنید: 1470412402000 .
  • segmentationType : نوع سیستم تبدیلی را که تبدیل را در آن آپلود می کنید مشخص می کند. در حال حاضر فقط تبدیل‌های Floodlight پشتیبانی می‌شوند، بنابراین این فیلد برای تعیین FLOODLIGHT همیشه مورد نیاز است.
  • segmentationName : نام فعالیت Floodlight که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

    اگر تبلیغ‌کننده شما دارای فعالیت‌هایی با همین نام است (اگر فعالیت‌ها متعلق به گروه‌های مختلف Floodlight باشند، این اتفاق می‌افتد)، اقدام توصیه‌شده تغییر نام یکی از فعالیت‌ها است.

    از طرف دیگر، اگر می‌دانید شناسه Search Ads 360 به یک فعالیت Floodlight اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationId ، شناسه را در segmentationName مشخص کنید. (Campaign Manager همچنین یک شناسه به فعالیت Floodlight اختصاص می دهد، اما شناسه Campaign Manager با شناسه Search Ads 360 متفاوت است و نمی توان از آن برای نسبت دادن به تبدیل ها استفاده کرد.) برای مشاهده شناسه Search Ads 360 برای یک فعالیت Floodlight، یک تبدیل را دانلود کنید. گزارش ( از رابط کاربری Search Ads 360 یا API گزارش ). اگر حداقل یک تبدیل به فعالیت Floodlight در بازه زمانی گزارش نسبت داده شده باشد، شناسه Search Ads 360 را در گزارش خواهید دید.

  • type : نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION ارزش پولی ندارد، در حالی که تبدیل TRANSACTION ارزش پولی ندارد. به عنوان مثال، ثبت نام در لیست ایمیل (ACTION) در مقابل خریدهای تجارت الکترونیک (TRANSACTION) است.

    اگر TRANSACTION مشخص کنید، باید فیلد زیر را نیز مشخص کنید:

    • revenueMicros : ارزش پولی تبدیل.

فیلدهای اختیاری

  • quantityMillis : تعداد اقلام در این تبدیل. به عنوان مثال، تعداد افرادی که برای یک خبرنامه ایمیلی ثبت نام کرده اند یا تعداد کل اقلام فروخته شده. اگر این فیلد را برای تبدیل‌های ACTION مشخص نکنید، Search Ads 360 به‌طور خودکار مقدار 1000 را وارد می‌کند.
  • currencyCode : واحد پولی درآمد یک تراکنش. به‌طور پیش‌فرض، درآمد به واحد پولی تبلیغ‌کننده در نظر گرفته می‌شود. اگر ارز دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخص شده را به واحد پول تبلیغ‌کننده تبدیل می‌کند. بیشتر بدانید
    برای تعیین واحد پول از قالب الفبای ISO 4217 (3 کاراکتر) استفاده کنید.
    فقط برای تبدیل های 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" : [{
   "agencyId": "12300000000000456", // Replace with your ID
   "advertiserId": "45600000000010291", // Replace with your ID
   "engineAccountId": "700000000042441", // Replace with your ID
   "campaignId": "71700000002044839", // Replace with your ID
   "adGroupId": "58700000032026064", // Replace with your ID
   "criterionId": "43700004289911004", // Replace with your ID
   "adId": "44700000155906860", // Replace with your ID
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "3000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}

جاوا

  /**
   * Creates an ACTION conversion that is attributed to a keyword and add. Adds the conversion
   * 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> addActionConversionForAdKeyword(List<Conversion> conversions,
      Long agencyId, Long advertiserId, Long engineAccountId, Long campaignId, Long adGroupId,
      Long criterionId, Long adId, String conversionId, Long quantity, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setAgencyId(agencyId)
        .setAdvertiserId(advertiserId)
        .setEngineAccountId(engineAccountId)
        .setCampaignId(campaignId)
        .setAdGroupId(adGroupId)
        .setCriterionId(criterionId)
        .setAdId(adId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("ACTION")
        .setQuantityMillis(quantity);

    conversions.add(conversion);
    return conversions;
  }

پایتون

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword
  and ad.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'agencyId': '12300000000000456', // Replace with your ID
              'advertiserId': '45600000000010291', // Replace with your ID
              'engineAccountId': '700000000042441', // Replace with your ID
              'campaignId': '71700000002044839', // Replace with your ID
              'adGroupId': '58700000032026064', // Replace with your ID
              'criterionId': '43700004289911004', // Replace with your ID
              'adId': '44700000155906860', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378710000000',
              'type': 'ACTION',
              'quantityMillis': '3000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test'
              }]
      }
  )

  pprint.pprint(request.execute())

تبدیل را فقط به یک کلمه کلیدی نسبت دهید

اگر نگرانی اصلی شما نسبت دادن تبدیل به کلمات کلیدی است - و نگران نسبت دادن به تبلیغات نیستید - می توانید بیشتر شناسه های Search Ads 360 را حذف کنید و فقط شناسه کلمه کلیدی را به همراه چند فیلد دیگر مشخص کنید:

فیلدهای مورد نیاز

  • criterionId : این شناسه کلمه کلیدی است. می توانید با افزودن ماکرو TrackerId به URL های صفحه فرود، criterionId دریافت کنید. برای کسب اطلاعات در مورد به دست آوردن شناسه کلمات کلیدی، به Search Ads 360 IDs and Conversions مراجعه کنید.
  • conversionId : برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد. برای تبدیل‌های آنلاین، Search Ads 360 بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
  • conversionTimestamp : تاریخ و زمانی را که تبدیل در آن رخ داده است را نشان می دهد. به عنوان مثال، اگر تبدیل در جمعه، 05 اوت 2016، ساعت 11:53:22 صبح به وقت تابستانی شرقی (GMT -4:00) انجام شود، مهر زمانی را بر حسب میلی‌ثانیه مشخص کنید: 1470412402000 .
  • segmentationType : نوع سیستم تبدیلی را که تبدیل را در آن آپلود می کنید مشخص می کند. در حال حاضر فقط تبدیل‌های Floodlight پشتیبانی می‌شوند، بنابراین این فیلد برای تعیین FLOODLIGHT همیشه مورد نیاز است.
  • segmentationName : نام فعالیت Floodlight که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

    اگر تبلیغ‌کننده شما دارای فعالیت‌هایی با همین نام است (اگر فعالیت‌ها متعلق به گروه‌های مختلف Floodlight باشند، این اتفاق می‌افتد)، اقدام توصیه‌شده تغییر نام یکی از فعالیت‌ها است.

    از طرف دیگر، اگر می‌دانید شناسه Search Ads 360 به یک فعالیت Floodlight اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationId ، شناسه را در segmentationName مشخص کنید. (Campaign Manager همچنین یک شناسه به فعالیت Floodlight اختصاص می دهد، اما شناسه Campaign Manager با شناسه Search Ads 360 متفاوت است و نمی توان از آن برای نسبت دادن به تبدیل ها استفاده کرد.) برای مشاهده شناسه Search Ads 360 برای یک فعالیت Floodlight، یک تبدیل را دانلود کنید. گزارش ( از رابط کاربری Search Ads 360 یا API گزارش ). اگر حداقل یک تبدیل به فعالیت Floodlight در بازه زمانی گزارش نسبت داده شده باشد، شناسه Search Ads 360 را در گزارش خواهید دید.

  • type : نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION ارزش پولی ندارد، در حالی که تبدیل TRANSACTION ارزش پولی ندارد. به عنوان مثال، ثبت نام در لیست ایمیل (ACTION) در مقابل خریدهای تجارت الکترونیک (TRANSACTION) است.

    اگر TRANSACTION مشخص کنید، باید فیلد زیر را نیز مشخص کنید:

    • revenueMicros : ارزش پولی تبدیل.

فیلدهای اختیاری

  • quantityMillis : تعداد اقلام در این تبدیل. به عنوان مثال، تعداد افرادی که برای یک خبرنامه ایمیلی ثبت نام کرده اند یا تعداد کل اقلام فروخته شده. اگر این فیلد را برای تبدیل‌های ACTION مشخص نکنید، Search Ads 360 به‌طور خودکار مقدار 1000 را وارد می‌کند.
  • currencyCode : واحد پولی درآمد یک تراکنش. به‌طور پیش‌فرض، درآمد به واحد پولی تبلیغ‌کننده در نظر گرفته می‌شود. اگر ارز دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخص شده را به واحد پول تبلیغ‌کننده تبدیل می‌کند. بیشتر بدانید
    برای تعیین واحد پول از قالب الفبای ISO 4217 (3 کاراکتر) استفاده کنید.
    فقط برای تبدیل های 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" : [{
    "criterionId": "43700003491981017", // 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,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }

پایتون


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': [{
              'criterionId': '43700004289911004', // 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())

در کمپین خرید، تبدیل به محصولات را نسبت دهید

کمپین‌های خرید، آگهی‌های فهرست محصولات را از داده‌های محصول در فید موجودی Merchant Center تولید می‌کنند. برای نسبت دادن یک تبدیل به محصولی که در کمپین خرید تبلیغ شده است، همه موارد زیر را در درخواست Conversion.insert() خود مشخص کنید:

فیلدهای مورد نیاز

  • productId : شناسه محصول . تبلیغ‌کننده این شناسه را در فید موجودی مشخص می‌کند.
  • productGroupId : شناسه گروه محصولی که می‌خواهید برای تبدیل نسبت دهید. Search Ads 360 این شناسه را هنگام ایجاد گروه به یک گروه محصول اختصاص می دهد.
  • inventoryAccountId : شناسه فید موجودی که محصول به آن تعلق دارد. وقتی تبلیغ‌کننده فید محصول را به Search Ads 360 پیوند می‌دهد، Search Ads 360 این شناسه را اختصاص می‌دهد.

    اگر حساب Merchant Center تبلیغ‌کننده یک حساب چند مشتری است، شناسه حساب فرعی حاوی محصول را مشخص کنید. می‌توانید این شناسه را با ورود به Search Ads 360، کلیک کردن روی مدیریت موجودی در صفحه پیمایش سمت چپ، و مشاهده ستون ID در تب حساب‌های موجودی ، پیدا کنید.

  • productCountry : کشوری که برای فید Merchant Center که حاوی داده‌های مربوط به محصول است، تعریف شده است. کد کشور ISO 3166 را مشخص کنید.
  • productLanguage : زبانی که برای فید Merchant Center که حاوی داده‌هایی درباره محصول است، تعریف شده است. کد زبان ISO 639 را مشخص کنید.
  • channel : به صورت آنلاین برای تبلیغات فهرست محصولات آنلاین و محلی را برای تبلیغات موجودی محلی مشخص کنید.
  • storeId : برای تبلیغات موجودی محلی، فروشگاهی را که محصول برای آن تبلیغ شده است را مشخص کنید. این باید با شناسه‌های فروشگاه استفاده شده در فید موجودی شما مطابقت داشته باشد.
  • conversionId : برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد. برای تبدیل‌های آنلاین، Search Ads 360 بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
  • conversionTimestamp : تاریخ و زمانی را که تبدیل در آن رخ داده است را نشان می دهد. به عنوان مثال، اگر تبدیل در جمعه، 05 اوت 2016، ساعت 11:53:22 صبح به وقت تابستانی شرقی (GMT -4:00) انجام شود، مهر زمانی را بر حسب میلی‌ثانیه مشخص کنید: 1470412402000 .
  • segmentationType : نوع سیستم تبدیلی را که تبدیل را در آن آپلود می کنید مشخص می کند. در حال حاضر فقط تبدیل‌های Floodlight پشتیبانی می‌شوند، بنابراین این فیلد برای تعیین FLOODLIGHT همیشه مورد نیاز است.
  • segmentationName : نام فعالیت Floodlight که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

    اگر تبلیغ‌کننده شما دارای فعالیت‌هایی با همین نام است (اگر فعالیت‌ها متعلق به گروه‌های مختلف Floodlight باشند، این اتفاق می‌افتد)، اقدام توصیه‌شده تغییر نام یکی از فعالیت‌ها است.

    از طرف دیگر، اگر می‌دانید شناسه Search Ads 360 به یک فعالیت Floodlight اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationId ، شناسه را در segmentationName مشخص کنید. (Campaign Manager همچنین یک شناسه به فعالیت Floodlight اختصاص می دهد، اما شناسه Campaign Manager با شناسه Search Ads 360 متفاوت است و نمی توان از آن برای نسبت دادن به تبدیل ها استفاده کرد.) برای مشاهده شناسه Search Ads 360 برای یک فعالیت Floodlight، یک تبدیل را دانلود کنید. گزارش ( از رابط کاربری Search Ads 360 یا API گزارش ). اگر حداقل یک تبدیل به فعالیت Floodlight در بازه زمانی گزارش نسبت داده شده باشد، شناسه Search Ads 360 را در گزارش خواهید دید.

  • type : نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION ارزش پولی ندارد، در حالی که تبدیل TRANSACTION ارزش پولی ندارد. به عنوان مثال، ثبت نام در لیست ایمیل (ACTION) در مقابل خریدهای تجارت الکترونیک (TRANSACTION) است.

    اگر TRANSACTION مشخص کنید، باید فیلد زیر را نیز مشخص کنید:

    • revenueMicros : ارزش پولی تبدیل.

فیلدهای اختیاری

  • quantityMillis : تعداد اقلام در این تبدیل. به عنوان مثال، تعداد افرادی که برای یک خبرنامه ایمیلی ثبت نام کرده اند یا تعداد کل اقلام فروخته شده. اگر این فیلد را برای تبدیل‌های ACTION مشخص نکنید، Search Ads 360 به‌طور خودکار مقدار 1000 را وارد می‌کند.
  • currencyCode : واحد پولی درآمد یک تراکنش. به‌طور پیش‌فرض، درآمد به واحد پولی تبلیغ‌کننده در نظر گرفته می‌شود. اگر ارز دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخص شده را به واحد پول تبلیغ‌کننده تبدیل می‌کند. بیشتر بدانید
    برای تعیین واحد پول از قالب الفبای ISO 4217 (3 کاراکتر) استفاده کنید.
    فقط برای تبدیل های 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": [
  { // Conversion from a Local Inventory Ad
    "productGroupId": "92700000000000001", // Replace with your ID
    "productId": "123-abc", // Replace with your ID
    "inventoryAccountId": "97700000000000001", // Replace with your ID
    "productCountry": "US",
    "productLanguage": "en",
    "channel": "local",
    "storeId": "123456",
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1376452740000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "state": "ACTIVE",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  },
  { // Conversion from an online product listing ad
    "productGroupId": "92700000000000001", // Replace with your ID
    "productId": "123-abc", // Replace with your ID
    "inventoryAccountId": "97700000000000001", // Replace with your ID
    "productCountry": "CA",
    "productLanguage": "en",
    "channel": "online",
    "conversionId": "customerTransaction73126", // Replace with your ID
    "conversionTimestamp": "1429229922000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "shopact",
    "type": "ACTION",
    "state": "ACTIVE",
    "revenueMicros": "20000000",
    "currencyCode": "CAD"
  }]
}

داده‌ها را از مدل اسناد شخص ثالث آپلود کنید

یک مدل انتساب اعتبار یک تبدیل را در تمام فعالیت در یک مسیر تبدیل توزیع می کند. برای مثال، اگر مصرف‌کننده‌ای روی یک آگهی جستجوی پولی، یک آگهی نمایشی، و یک آگهی جستجوی پولی دیگر قبل از تبدیل کلیک کند، یک مدل اسناد خطی به هر کلیک 33 درصد از اعتبار تبدیل را می‌دهد.

در حالی که Search Ads 360 مدل‌های انتساب را ارائه می‌کند ، اگر از یک سرویس شخص ثالث یا سرویسی که برای توزیع اعتبار روی کلیک‌ها ایجاد کرده‌اید استفاده می‌کنید ، می‌توانید داده‌های انتساب شخص ثالث را در Search Ads 360 آپلود کنید و از داده‌ها در گزارش‌ها و جستجو استفاده کنید. استراتژی های پیشنهادی Ads 360.

قبل از اینکه تو شروع کنی

در Campaign Manager، یک مدل ارجاع سفارشی ایجاد کنید و مدل را در Search Ads 360 وارد کنید. مطمئن شوید که مدل را External Attribution Model نامیده‌اید. این ویژگی به ویژگی‌های Search Ads 360 امکان می‌دهد تشخیص دهد که یک مدل ارجاع برای داده‌های تبدیلی که آپلود می‌کنید اعمال شده است. بیشتر بدانید

فیلدهای مورد نیاز

برای اعمال یک مدل انتساب شخص ثالث به یک تبدیل، تمام موارد زیر را در درخواست Conversion.insert() خود مشخص کنید:

  • clickId : شناسه کلیک حساس به حروف کوچک و بزرگ بازدید. در گزارش‌های وب تبلیغ‌کننده، شناسه کلیک یا تبدیل‌های فهرست را جستجو کنید و از یک شناسه کلیک از یک تبدیل دیگر استفاده کنید. Search Ads 360 تبدیل را به کلمه کلیدی، تبلیغ و سایر اشیاء Search Ads 360 که مسئول ایجاد بازدید بودند نسبت می دهد.
    پس از اینکه Search Ads 360 شناسه کلیک ایجاد کرد، قبل از آپلود تبدیل با شناسه ، حداقل 30 دقیقه صبر کنید . در غیر این صورت، Search Ads 360 API ممکن است بازدید را تشخیص ندهد.
  • attributionModel : روی مدل اسناد خارجی تنظیم کنید. بیشتر بدانید
  • countMillis : مقدار اعتبار تبدیلی که به این کلیک توزیع می شود. فقط در صورتی قابل اعمال است که درخواست شامل قسمت attributionModel نیز باشد.

    این را با quantityMillis اشتباه نگیرید، یک فیلد اختیاری که تعداد اقلام را در یک تبدیل مشخص می کند (مانند تعداد اقلام در خرید سبد خرید).

  • conversionId : برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد. برای تبدیل‌های آنلاین، Search Ads 360 بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
  • conversionTimestamp : تاریخ و زمانی را که تبدیل در آن رخ داده است را نشان می دهد. به عنوان مثال، اگر تبدیل در جمعه، 05 اوت 2016، ساعت 11:53:22 صبح به وقت تابستانی شرقی (GMT -4:00) انجام شود، مهر زمانی را بر حسب میلی‌ثانیه مشخص کنید: 1470412402000 .
  • segmentationType : نوع سیستم تبدیلی را که تبدیل را در آن آپلود می کنید مشخص می کند. در حال حاضر فقط تبدیل‌های Floodlight پشتیبانی می‌شوند، بنابراین این فیلد برای تعیین FLOODLIGHT همیشه مورد نیاز است.
  • segmentationName : نام فعالیت Floodlight که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

    اگر تبلیغ‌کننده شما دارای فعالیت‌هایی با همین نام است (اگر فعالیت‌ها متعلق به گروه‌های مختلف Floodlight باشند، این اتفاق می‌افتد)، اقدام توصیه‌شده تغییر نام یکی از فعالیت‌ها است.

    از طرف دیگر، اگر می‌دانید شناسه Search Ads 360 به یک فعالیت Floodlight اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationId ، شناسه را در segmentationName مشخص کنید. (Campaign Manager همچنین یک شناسه به فعالیت Floodlight اختصاص می دهد، اما شناسه Campaign Manager با شناسه Search Ads 360 متفاوت است و نمی توان از آن برای نسبت دادن به تبدیل ها استفاده کرد.) برای مشاهده شناسه Search Ads 360 برای یک فعالیت Floodlight، یک تبدیل را دانلود کنید. گزارش ( از رابط کاربری Search Ads 360 یا API گزارش ). اگر حداقل یک تبدیل به فعالیت Floodlight در بازه زمانی گزارش نسبت داده شده باشد، شناسه Search Ads 360 را در گزارش خواهید دید.

  • type : نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION ارزش پولی ندارد، در حالی که تبدیل TRANSACTION ارزش پولی ندارد. به عنوان مثال، ثبت نام در لیست ایمیل (ACTION) در مقابل خریدهای تجارت الکترونیک (TRANSACTION) است.

    اگر TRANSACTION مشخص کنید، باید فیلد زیر را نیز مشخص کنید:

    • revenueMicros : ارزش پولی تبدیل.

اگر درآمد تبدیل را دنبال می‌کنید، مطمئن شوید که مدل شما درآمد را در هر نقطه تماس در یک مسیر تبدیل توزیع می‌کند. به عنوان مثال، اگر مدل شما از یک رویکرد خطی استفاده می‌کند (توزیع درآمد به طور مساوی در هر نقطه تماس)، در مسیر تبدیلی که شامل 3 کلیک تبلیغاتی است، هر کلیک با 33٪ از تبدیل نسبت داده می‌شود. اگر تبدیل 100 دلار درآمد داشته است، مطمئن شوید که مدل شما 33 دلار درآمد را به هر کلیک تقسیم می‌کند و مطمئن شوید که Micros فقط 33 دلار درآمد برای هر کلیک مشخص می‌کند.

فیلدهای اختیاری

  • quantityMillis : تعداد اقلام در این تبدیل. به عنوان مثال، تعداد افرادی که برای یک خبرنامه ایمیلی ثبت نام کرده اند یا تعداد کل اقلام فروخته شده. اگر این فیلد را برای تبدیل‌های ACTION مشخص نکنید، Search Ads 360 به‌طور خودکار مقدار 1000 را وارد می‌کند.
  • currencyCode : واحد پولی درآمد یک تراکنش. به‌طور پیش‌فرض، درآمد به واحد پولی تبلیغ‌کننده در نظر گرفته می‌شود. اگر ارز دیگری را مشخص کنید، Search Ads 360 مقدار درآمد مشخص شده را به واحد پول تبلیغ‌کننده تبدیل می‌کند. بیشتر بدانید
    برای تعیین واحد پول از قالب الفبای ISO 4217 (3 کاراکتر) استفاده کنید.
    فقط برای تبدیل های 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 برای هر تبدیل آپلود شده است، مانند شناسه کمپین، شناسه گروه تبلیغات و شناسه کلمه کلیدی (معیار).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

اگر درخواست موفق نشد

اگر یک یا چند تبدیل موفق به تأیید یا آپلود نشدند، پاسخ شامل پیام‌هایی برای هر بارگذاری تبدیل ناموفق می‌شود. پاسخ حاوی پیام‌هایی درباره تبدیل‌هایی که با موفقیت آپلود شده‌اند نیست.

در اینجا یک نمونه پاسخ به درخواستی است که به طور کامل موفق نشده است:

{
 "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 نشان دهنده مشکلات داده در درخواست آپلود تبدیل است (به عنوان مثال، تبدیل قبلا آپلود شده است، یا clickId پیدا نشده است). در این نوع خطا، جزئیات پیام حاوی دو مورد است:

  • یک کد هگزادسیمال که نوع خطا را مشخص می کند. می توانید از کد موجود در اسکریپت های خود برای شناسایی خطاها استفاده کنید.
  • شرح خطای اعتبارسنجی

برای اطلاعات بیشتر، به فهرست کدها و توضیحاتی که Search Ads 360 می‌تواند برای خطاهای آپلود تبدیل بازگرداند، مراجعه کنید.

انواع دیگر خطاها

همه انواع دیگر خطاها ( internalError ، transactionFailed ، یا lateStageRequestError ) نشان می دهد که یک مشکل داخلی در Search Ads 360 وجود دارد.

پاسخ به یک خطا

اگر درخواست ناموفق بود، سعی کنید بعداً کل درخواست را دوباره ارسال کنید. Search Ads 360 خطاهای requestValidation را برای هر تبدیلی که قبلاً آپلود شده گزارش می‌کند، اما تلاش می‌کند تا تبدیل‌های باقی‌مانده را آپلود کند.

اگر پس از ارسال مجدد همچنان خطا مشاهده کردید، بخش عیب یابی را برای اطلاع از نحوه ادامه مشاهده کنید.