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

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

اگر مهر 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 اختصاص داده است، می‌توانید به جای تعیین نام در قسمت 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 : نوع دستگاهی را که تبدیل روی آن انجام شده را مشخص می کند. لیست مقادیر پذیرفته شده برای این فیلد را ببینید.

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 : نوع دستگاهی را که تبدیل روی آن انجام شده را مشخص می کند. لیست مقادیر پذیرفته شده برای این فیلد را ببینید.

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

مثال

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"
  }]
}
          

درخواست خطاهای اعتبارسنجی

خطاهای requestValidation نشان دهنده مشکلات داده در درخواست آپلود تبدیل است (به عنوان مثال، تبدیل قبلا آپلود شده است، یا clickId پیدا نشده است). در این نوع خطا، جزئیات پیام حاوی دو مورد است:

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

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

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

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

پاسخ دادن به یک خطا

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

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