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

برای افزودن یک یا چند تبدیل، متد 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. تبدیل ها را به محض در دسترس بودن آپلود کنید. اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید، قبل از آپلود تبدیل، حداقل 6 ساعت پس از بازدید منتظر بمانید. اگر زودتر از 6 ساعت پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 24 ساعت صبر کنید تا Search Ads 360 بتواند شناسه کلیک را تشخیص دهد.

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

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

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

  • یک تبدیل را به یک بازدید خاص نسبت دهید
  • تبدیل را فقط به یک کلمه کلیدی نسبت دهید

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

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

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

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

  • clickId : شناسه کلیک حساس به حروف کوچک و بزرگ بازدید. در گزارش‌های وب تبلیغ‌کننده، شناسه کلیک یا تبدیل‌های فهرست را جستجو کنید و از یک شناسه کلیک از یک تبدیل دیگر استفاده کنید. Search Ads 360 تبدیل را به کلمه کلیدی، تبلیغ و سایر اشیاء Search Ads 360 که مسئول ایجاد بازدید بودند نسبت می دهد.
    پس از اینکه Search Ads 360 شناسه کلیکی برای آپلود تبدیل ایجاد کرد، حداقل 6 ساعت صبر کنید . اگر خطای «شناسه کلیک یافت نشد» را دریافت کردید، 24 ساعت صبر کنید و سپس تبدیل‌ها را دوباره آپلود کنید. همه تبدیل‌ها باید ظرف 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 اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationName ، شناسه را در segmentationId مشخص کنید. (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())

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

اگر نگرانی اصلی شما نسبت دادن تبدیل به کلمات کلیدی است - و نگران نسبت دادن به تبلیغات نیستید - می توانید بیشتر شناسه های 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 اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationName ، شناسه را در segmentationId مشخص کنید. (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())

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

یک مدل انتساب اعتبار یک تبدیل را در تمام فعالیت در یک مسیر تبدیل توزیع می کند. برای مثال، اگر مصرف‌کننده‌ای روی یک آگهی جستجوی پولی، یک آگهی نمایشی، و یک آگهی جستجوی پولی دیگر قبل از تبدیل کلیک کند، یک مدل اسناد خطی به هر کلیک 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 اختصاص داده است، می‌توانید به جای تعیین نام در قسمت segmentationName ، شناسه را در segmentationId مشخص کنید. (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 را برای هر تبدیلی که قبلاً آپلود شده گزارش می‌کند، اما تلاش می‌کند تا تبدیل‌های باقی‌مانده را آپلود کند.

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