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

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

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

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

چه مدت بعد می‌توانم از داده‌های آپلود شده استفاده کنم؟

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

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

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

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

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

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

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

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

  2. به محض اینکه تبدیل‌ها در دسترس قرار گرفتند، آنها را آپلود کنید. اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید ، حداقل ۶ ساعت پس از بازدید صبر کنید و سپس تبدیل را آپلود کنید. اگر زودتر از ۶ ساعت پس از بازدید آپلود کنید، ممکن است Search Ads 360 نتواند clickID بازدید را تشخیص دهد. در موارد نادر، ممکن است لازم باشد تا ۲۴ ساعت صبر کنید تا Search Ads 360 بتواند clickId را تشخیص دهد.

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

ارسال درخواست درج

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

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

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

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

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

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

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

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

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

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

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

بارگذاری داده‌ها از یک مدل انتساب شخص ثالث

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

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

قبل از شروع

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

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

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

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

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

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

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

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

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

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

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

اگر درآمد حاصل از تبدیل را پیگیری می‌کنید، مطمئن شوید که مدل شما درآمد را در هر نقطه تماس در یک مسیر تبدیل توزیع می‌کند. برای مثال، اگر مدل شما از یک رویکرد خطی (توزیع مساوی درآمد در هر نقطه تماس) استفاده می‌کند، در یک مسیر تبدیل که شامل ۳ کلیک تبلیغاتی است، به هر کلیک ۳۳٪ از تبدیل نسبت داده می‌شود. اگر تبدیل ۱۰۰ دلار درآمد داشته باشد، مطمئن شوید که مدل شما ۳۳ دلار درآمد را به هر کلیک توزیع می‌کند و مطمئن شوید که incomeMicros فقط ۳۳ دلار درآمد را برای هر کلیک مشخص می‌کند.

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

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

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

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