本項の目的:

• Partnerize APIを使用した承認 / 非承認作業の自動化手順をご案内いたします。

目次

• 概要
• 実装手順

概要

Partnerizeで計測された成果は、請求書の発行やパートナーへの報酬支払いを行う前に、必ずステータスを確定させる必要があります。トラッキングされた全ての成果に対する承認作業は、手動での更新も可能ですが、運用効率の観点からAPIによる自動化を推奨しており、これらは広告主様自身で実施して頂く必要がございます。

自動化には以下のようなメリットがあります。

• 工数削減: 手作業による承認・非承認作業の時間を大幅に短縮できます。
• データの一貫性: 広告主様の自社システムとPartnerizeのデータを正確に同期できます。
• 柔軟な運用: 広告主様の都合に合わせた頻度（毎日、毎週、毎月など）で実行可能です。

実装手順

Partnerizeのコンバージョンデータは作成時(計測時)、ステータスが保留(pending)で登録されます。コンバージョン送信時のconversionrefパラメータには、広告主様が承認作業を行う際に利用する値であり、広告主様システム側の注文IDを設定することを推奨いたします。それにより、広告主様側の注文状態と紐づけて承認作業を行うことが可能となります。

広告主様側では、Partnerize APIから保留(pending)状態のコンバージョンレポートを取得し、conversionrefパラメータの値を自社システムの注文IDと照合し、各コンバージョンの承認／非承認を決定する処理を実装してください。

保留(pending)のコンバージョンを抽出するためのAPIの例

■コンバージョン（バスケット）レベルを取得する場合

https://{app_api_key}:{user_api_key}@api.partnerize.com/reporting/report_advertiser/campaign/{campaign_id}/conversion.{format}?start_date={YYYY-MM-DD hh:mm:ss}& end_date={YYYY-MM-DD hh:mm:ss}&statuses%5B%5D=pending

■アイテムレベル のコンバージョンを取得する場合

https://{app_api_key}:{user_api_key}@api.partnerize.com/reporting/export/conversion_item.{format}?start_date={YYYY-MM-DD hh:mm:ss}& end_date={YYYY-MM-DD hh:mm:ss}& campaign_id={campaign_id}&statuses%5B%5D=pending 

❗NOTE：

• 認証キー : 「{app_api_key}」と「{user_api_key}」は、Partnerizeの管理画面から確認することができます。以下の手順で確認してください。 
  • アプリケーションAPIキー（ロゴ＞設定＞あなたのアカウント＞ユーザーアプリケーションキー）
  • ユーザーAPIキー（ロゴ＞設定＞あなたのアカウント＞ユーザーAPIキー）
• データフォーマット : csv、jsonまたはxmlをお選びいただけます。
• 対象日時の指定方法 : 「start_date」や「end_date」の代わりに「text_date」パラメータの利用も可能です。

例）text_date=last+7+days

コンバージョンの承認／非承認プロセス

上記のAPIを利用し、承認 / 非承認への変更を行う必要のあるコンバージョンデータを取得後、下記APIを利用して各コンバージョンのステータスを更新してください。必要に応じて、非承認とするコンバージョンにオプションの拒否理由(reject_reason)の設定も可能です。承認 / 非承認へ変更を行うコンバージョンの指定には、以下3つの異なるIDを使用できます。

• conversionref 
  • 一般に、広告主様側システムの注文IDを設定します。

• conversion_id: 
  • Partnerizeが発行するコンバージョン毎の固有IDとなります。

• conversion_item_id 
  • Partnerizeが発行するコンバージョンアイテム毎の固有IDとなります。

❗NOTE

• コンバージョンアイテム毎の承認 / 非承認を行う際にはconversion_item_idを必ず指定する必要があります。

承認／非承認に使用するAPI

https://{app_api_key}:{user_api_key}@api.partnerize.com/v3/brand/campaigns/{campaignID}/conversions/bulk

承認に使用するAPIのPOSTデータ例（conversion_referenceで指定）

{
    "conversion_references": {
       "AUTO-5de90e8ccdc106.23934624": {
          "status": "approved" 
       },
       "AUTO-0de90e8adec106.23934947": { 
          "status": "approved",
       }
    } 
}

承認に使用するAPIのPOSTデータ例（conversion_idで指定）

{
    "conversions": {
       "111111l1": {
         "status": "approved" 
       },
       "111111l2": {
         "status": "approved",
       }
     } 
}

承認に使用するAPIのPOSTデータ例（conversion_item_idで指定）

{
  "conversion_items": {
    "111111l3": {
      "status": "approved" 
    },
    "111111l4": {
      "status": "approved",
    }
  } 
}

非承認に使用するAPIのPOSTデータ例（conversion_referenceで指定）

{
    "conversion_references": {
       "AUTO-5de90e8ccdc106.23934624": {
          "status": "rejected" 
       },
       "AUTO-0de90e8adec106.23934947": { 
          "status": "rejected",
          "reason": "cancelled order" }
    } 
}

非承認に使用するAPIのPOSTデータ例（conversion_idで指定）

{
  "conversions": {
    "111111l1": {
      "status": "rejected" 
    },
    "111111l2": {
      "status": "rejected",
      "reason": "cancelled order" 
    }
   } 
}

複数承認／非承認に使用するAPIのPOSTデータ例 （conversion_item_idで指定）

{
  "conversion_items": {
    "111111l3": {
      "status": "approved" 
    },
    "111111l4": {
      "status": "rejected",
      "reason": "cancelled order" 
    }
  } 
}

APIの詳細については以下のマニュアルをご参照ください。

https://api-docs.partnerize.com/brand/#tag/Campaign-Conversions

実装に関するその他技術的なご質問に関しましては、support@partnerize.com までお問い合わせ下さい。