Ödeme ayarlarını yönetme

Doğrudan ödeme sayfasına yönlendirme özelliği, satın almaya hazır olan müşterilerin Google ürün listelemelerinden doğrudan web sitenizin alışveriş sepeti veya ödeme sayfasına gitmesine olanak tanıyarak satın alma sürecini hızlandırır. Bu sayede dönüşüm oranlarını artırabilir ve alışveriş deneyimini kolaylaştırabilirsiniz.

Merchant API ile CheckoutSettings kaynağını kullanarak bu özelliğin ayarlarını yönetebilirsiniz.

Bu kılavuzda, doğrudan ödeme sayfasına yönlendirme özelliği kaydınızı programatik olarak oluşturmak ve yönetmek için Merchant API'yi nasıl kullanacağınız açıklanmaktadır.

Daha fazla bilgi için Ürünleriniz için ödeme bağlantısı ekleme başlıklı makaleyi inceleyin.

Ön koşullar

CheckoutSettings kaynağını ve ilişkili yöntemleri kullanmak için aşağıdakileri yapın:

  • Alışveriş reklamları, ücretsiz listelemeler veya her ikisi için onaylanmış ve katılmış olmanız gerekir.
  • Satış yaptığınız ülke ABD olmalıdır.

Yöntemler

Ödeme ayarlarını oluşturmak, almak, güncellemek ve silmek için aşağıdaki yöntemleri kullanabilirsiniz:

Ödeme ayarları oluşturma

Ödeme ayarı oluşturmak için checkoutSettings.create yöntemini kullanın. İstek gövdesine checkout_uri_template veya cart_uri_template ile uri_settings ve seçilen eligible_destinations değerini ekleyin.

Aşağıda örnek bir istek verilmiştir:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

{ACCOUNT_ID} ifadesini Merchant Center hesabınızın benzersiz tanımlayıcısıyla değiştirin.

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Ödeme ayarlarını alma

URL şablonu, seçilen hedefler, kayıt durumu ve URL inceleme durumu dahil olmak üzere ödeme ayarlarınızı almak için checkoutSettings.get yöntemini kullanın.

Aşağıda örnek bir istek verilmiştir:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Ödeme ayarlarını güncelleme

Ödeme ayarlarınızı güncellemek için checkoutSettings.update yöntemini kullanın. Değiştirmek istediğiniz alanları istek gövdesine ekleyin ve bu alanları update_mask sorgu parametresinde belirtin.

update_mask aşağıdaki alanları destekler:

  • eligible_destinations
  • uri_settings

URL'yi güncelleyen ve reklam hedefini kaldıran örnek bir istek aşağıda verilmiştir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Sil

Ödeme ayarlarını silmek için checkoutSettings.delete yöntemini kullanın.

Bu işlem, hesap düzeyindeki yapılandırmanızı kaldırır, ödeme programı kaydınızı iptal eder ve ücretsiz listelemeler ile Alışveriş reklamlarındaki ürünlerinizde ödeme bağlantılarının gösterilmesini durdurur.

Aşağıda örnek bir istek verilmiştir:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir çağrı, boş bir yanıt gövdesi döndürür.

Ürünleriniz için ödeme URL'lerini iki şekilde sağlayabilirsiniz:

  • Hesap düzeyi (alt API veya Merchant Center): Tek bir URL şablonu (checkout_uri_template veya cart_uri_template) tanımlamak için alt API'yi ya da Merchant Center ayarlarını kullanabilirsiniz. Bu şablon, tüm uygun ürünlerinize uygulanır. Ürünlerinizde tutarlı bir URL kullanmanızı öneririz. Örneğin, yourstore.com/checkout?id={id}.

  • Ürün düzeyinde geçersiz kılma (feed): Tek tek ürünler için belirli bir ödeme URL'si sağlamak istiyorsanız ürün feed'inizde checkout_link_template özelliğini kullanın. Bu sayede, her ürün için özel URL'ler kullanabilir veya yalnızca envanterinizin bir alt kümesi için ödeme seçeneği sunabilirsiniz.

  • Bu alt API'yi kullanarak hesap düzeyinde bir URL şablonu ayarlarsanız feed'inizde bu ürünler için checkout_link_template özelliğine değer göndermediğinizden emin olun.

  • checkout_link_template feed özelliğini kullanıyorsanız alt API veya Merchant Center ayarlarını kullanarak hesap düzeyinde bir URL şablonu ayarlamadığınızdan emin olun. URL'leri yalnızca feed üzerinden yönetiyorsanız uri_settings sağlamadan eligible_destinations seçmek için alt API'yi kullanmaya devam edebilirsiniz.

Ödeme URL'si şablonu

Ödeme URL'si şablonu, ürün verilerinize ödeme URL'si eklemenize olanak tanır. Bu URL'leri kullanarak internetten alışveriş yapan müşterileri listelemelerinizden ödeme sayfanıza yönlendirebilirsiniz. {ID} parametre yer tutucusunu içermeli ve eşleşen bir alan adına sahip olmalıdır.

Alt API'yi kullanarak ödeme bağlantıları oluştururken uri_settings alanını kullanın. Bu alan, iki şablondan birini kabul eder:

  • checkout_uri_template: Yer tutucu doldurulduğunda kullanıcıyı, satın alınmaya hazır belirli bir öğenin bulunduğu ödeme sayfanıza yönlendiren URL şablonu.
  • cart_uri_template: Kullanıcıyı, alışveriş sepetine eklenen belirli bir öğeyle birlikte alışveriş sepeti sayfanıza yönlendiren URL şablonu.

Örnek şablonlar

  • Ödeme: https://www.your-store.com/checkout?item_id={id}
  • Alışveriş sepeti: https://shop.your-store.com/add_to_cart?product_sku={id}

Aşağıdaki koşulları karşıladığınızdan emin olun:

  • URL şablonunuz, sitenizde kayıtlı alan adınızla eşleşen, HTTP GET yöntemini kullanan ve müşterinin oturum açmasını gerektirmeyen geçerli bir sayfaya yönlendirmelidir.
  • Sağlanan ödeme şablonundaki alan adı, ürün alan adıyla eşleşmelidir.

Daha fazla bilgi

Önceki
Manage online return policies
Sonraki
Enable automatic improvements